Cluster · руководства

Как подключить юзербот Cluster к Telegram

Cluster («Кластер») запускает модули на твоём Telegram-аккаунте и в личном боте. Сам юзербот работает на сервере: устанавливать Python или держать компьютер включённым не требуется. Здесь по порядку подключим аккаунт, добавим бота и проверим команды.

Профиль Cluster

Открой сайт Cluster и нажми «Создать профиль». Укажи почту, логин и пароль, заполни остальные поля регистрации. После регистрации подтверди почту кодом из письма.

Профиль Cluster и Telegram-аккаунт существуют отдельно. Первый хранит подписку и настройки сервиса, второй нужен для работы юзербота в Telegram. Пароль профиля Cluster не является облачным паролем Telegram.

Если профиль уже есть, достаточно войти. При настроенном двухэтапном входе сайт отдельно запросит код из приложения.

Доступ к юзерботу

Открой «Моя подписка» и оформи доступ либо активируй подарочный код. Для подключения Telegram и запуска модулей нужна действующая подписка или бессрочный доступ.

Наличие профиля само по себе не запускает юзербота. Если подписка закончилась и юзербот остановлен, сначала нужно продлить доступ.

API ID и API hash

Для входа нужны собственные параметры приложения Telegram: api_id и api_hash. Они используются и при входе по номеру, и при входе по QR.

  1. Открой my.telegram.org и войди со своим номером Telegram.
  2. Перейди в «API development tools».
  3. Если приложение ещё не создано, заполни предложенную Telegram форму.
  4. Получи значения api_id и api_hash на странице приложения.

Этот порядок описан в документации Telegram. Если приложение уже создано, используй его параметры.

api_id является числом, api_hash строкой из 32 шестнадцатеричных символов. Токен из BotFather в эти поля не подходит: он относится к личному боту и вводится отдельно.

Не публикуй API hash, коды входа и облачный пароль в описании модуля, отзыве или сообщении об ошибке.

Вход по QR

Открой в панели «Подключения Telegram», затем блок «Подключить Telegram-аккаунт».

  1. Выбери «По QR».
  2. Укажи Telegram API ID и API hash.
  3. Нажми «Получить QR для входа».
  4. В уже открытом приложении Telegram перейди в «Настройки», затем «Устройства» и «Подключить устройство».
  5. Отсканируй QR с сайта и подтверди вход в свой аккаунт.

На телефоне вместо сканирования можно воспользоваться кнопкой «Открыть в Telegram» под QR. Подтверждение выполняется в приложении Telegram.

Если у аккаунта настроен облачный пароль, сайт запросит его следующим шагом. Введи именно пароль Telegram и нажми «Завершить подключение».

Истёкший QR обновляется автоматически, пока страница открыта. Вся попытка подключения действует десять минут. После её окончания начни новую попытку.

QR и ссылка под ним относятся к твоему входу. Передавать их другому человеку не нужно.

Вход по номеру

В том же блоке выбери «По номеру».

  1. Введи номер с кодом страны, API ID и API hash.
  2. Нажми «Получить код входа Telegram».
  3. Посмотри, какой способ доставки указан над полем для кода.
  4. Получи код выбранным Telegram способом, введи его и нажми «Завершить подключение».
  5. Если появится поле облачного пароля, введи пароль Telegram и заверши подключение.

Способ доставки выбирает Telegram. Код может прийти в служебный чат Telegram, SMS или другим способом, который указан на странице. Почта для входа Telegram, если используется она, может отличаться от почты профиля Cluster.

После успешного входа в списке подключений появится аккаунт. Если на сайте осталась незавершённая попытка, проверь её состояние перед новым запросом.

Личный бот

Аккаунт выполняет команды в Telegram, а личный бот нужен для собственных кнопок, форм и уведомлений. Общий сервисный бот используется для служебных действий и не заменяет личного.

Есть два способа подключить бота.

Готовый токен. В разделе «Подключения Telegram» найди поле «Токен бота из BotFather», укажи токен своего бота и нажми «Подключить бота». Открой диалог с этим ботом в Telegram и нажми Start, если ещё не запускал его.

Создание через сервисного бота. В блоке «Создать нового бота» нажми «Начать создание через Telegram». Укажи название и свободное имя пользователя, затем нажми «Продолжить в Telegram» и пройди подтверждение. Доступность создания зависит от ограничений Telegram на аккаунте.

Токен личного бота не нужно записывать в исходники модулей. Его хранит ядро, модули обращаются к боту через предоставленные методы.

Установка и проверка модуля

Подключённый аккаунт ещё не добавляет все команды из каталога. Нужные модули устанавливаются отдельно.

  1. Открой «Каталог модулей» и выбери модуль.
  2. Нажми «Установить», выбери версию и получи список запрашиваемых прав.
  3. Отметь нужные права, задай ограничения и название экземпляра.
  4. Если названия команд совпадают с уже установленными, измени одно из них.
  5. Нажми «Установить с выбранными правами».
  6. Открой «Мои модули» и запусти установленный экземпляр кнопкой «Запустить».

В настройках модуля открой «Команды и ограничения». Там видны доступные команды и их названия. Для первой проверки отправь одну из них в «Избранное» подключённого аккаунта. Если команда поддерживает личного бота, проверь её и в диалоге с ним.

По умолчанию перед командой аккаунта ставится !, а для бота используется /. Например, команда hello из руководства по созданию модуля вызывается как !hello Cluster и /hello Cluster.

Префикс, названия и доступ к командам разобраны в отдельном руководстве.

Если код не приходит

Сначала проверь номер и способ доставки, показанный на сайте. Если Telegram отправил код в приложение, SMS можно не ждать. Если выбрана почта, проверь почту для входа Telegram, а не только адрес профиля Cluster.

Когда код не приходит выбранным способом, можно отменить попытку и воспользоваться QR. Для него нужен уже открытый Telegram на одном из устройств.

При ограничении частоты запросов дождись указанного срока. Повторные запросы подряд не устраняют ограничение. Для обращения в поддержку достаточно логина Cluster, времени попытки и названия способа доставки. Сам код, API hash и пароль передавать не нужно.

Если аккаунт подключён, а команда молчит

Проверь действующую подписку, запущен ли нужный модуль, его текущее название команды и доступ к чату. Команда личного бота должна отправляться именно личному боту, а команда аккаунта с подключённого аккаунта.

После необработанной ошибки экземпляр отключается. Причина отображается в «Журнале событий». Перед повторным запуском проверь её; само подключение Telegram не исправляет ошибку в модуле.

Смена аккаунта

При замене уже подключённого Telegram сайт запросит подтверждение паролем Cluster и вторым фактором, если он включён. При наличии облачного пароля Telegram он вводится отдельно.

Профиль, подписка, установленные модули и их данные сохраняются. Но разрешения, завязанные на старые чаты и пользователей, нужно проверить для нового аккаунта. Замена личного бота выбирается отдельно при смене подключения.

Далее можно перейти к настройке команд, созданию модуля или справочнику Telegram API в Cluster.