Telegram — подключение и проверка

Что нужно заранее

  • Аккаунт Telegram и доступ к @BotFather.
  • Роль администратор в проекте ImpactBot: подключение канала другим ролям запрещено на сервере.
  • Свободный слот канала в тарифе. Если слотов нет, подключение остановится с сообщением про лимит.

Права и доступы

Отдельных разрешений выдавать не нужно: бот действует от собственного имени по токену.

Одна настройка всё же важна — privacy mode. Пока он включён (значение по умолчанию), в группах бот видит только команды и ответы себе. Для работы в группах отключите его в @BotFather: откройте «/mybots», выберите бота, затем пункт «Bot Settings», внутри «Group Privacy» и «Turn off». Диагностика подключения предупреждает об этом отдельной строкой.

Подключение и вебхук

  1. В @BotFather выполните «/newbot», задайте имя и username, скопируйте токен вида `123456789:AA…`.
  2. Откройте проект → «Каналы» → «Добавить канал» → Telegram.
  3. Вставьте токен в поле «Токен бота» и нажмите «Подключить».

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

Проверка

Нажмите «Проверить» на карточке бота. Диагностика проходит четыре стадии: «Токен и аккаунт», «Разрешения», «Webhook», «Тестовое сообщение», и показывает, какая из них не прошла.

После этого напишите боту «/start» из своего Telegram — сообщение должно появиться в разделе «Диалоги».

Частые ошибки

  • «Invalid Telegram bot token». Токен скопирован с пробелом или обрезан. Возьмите его из @BotFather ещё раз целиком.
  • «Бот создан, но webhook не установился». Откройте настройки бота и нажмите «Обновить» рядом с адресом вебхука — адрес переустановится.
  • «Обновления уходят на чужой адрес». Тот же токен уже используется в другом сервисе: Telegram отдаёт события только по одному адресу. Отключите бота там или заведите нового.
  • Бот молчит в группе. Не выключен privacy mode — см. раздел про права.
  • «В очереди N обновлений». Вебхук был недоступен, события копятся. После успешной проверки очередь разберётся сама.