Главная · Справка · Бот в Telegram молчит: чеклист
Бот в Telegram молчит: чеклист
Сначала три проверки на минуту: лимит тарифа, статус канала и включённый сценарий. Ниже — что смотреть, если все три пройдены. Подробный разбор каждой причины с симптомами — в статье блога «Почему Telegram-бот не отвечает».
3 проверки за минуту
- Лимит Бесплатного тарифа. Признак — новым собеседникам бот отвечает одной фразой: «Лимит диалогов на бесплатном тарифе исчерпан», а с теми, кто уже писал в этом месяце, продолжает говорить. На Бесплатном — 30 диалогов (разных контактов) в месяц на бота по всем каналам вместе. Тариф виден в подзаголовке «Обзора», а сколько диалогов уже набралось — там же, в карточке «Тариф». Сообщения новых контактов сверх лимита в «Диалоги» не попадают. Лимит снимает Базовый (650 ₽/мес) в разделе «Оплата». Если фразы про лимит нет — идём дальше.
- Статус канала и токен. «Каналы» → строка Telegram-канала. Периодической проверки у ЧБТ нет, статус меняется по событиям. «Работает» ставится, когда Telegram принял вебхук при подключении или после «Переустановить webhook», когда боту приходит входящее сообщение и когда сообщение от имени бота успешно отправлено. «Ошибка» — когда подключение или переустановка не удались или Telegram отклонил токен при отправке сообщения от имени бота. Так что «Работает» — итог последнего такого события, а не проверка «прямо сейчас»: перехваченный другим сервисом вебхук статус не меняет. «Ошибка» с текстом «токен бота отклонён (401 Unauthorized)» — токен отозван или заменён у @BotFather, владельцу и админам бота об этом приходит письмо, если его не выключили в «Уведомлениях». Подключите Telegram заново с актуальным токеном. Старую строку канала удаляйте с оглядкой: вместе с ней из «Диалогов» пропадёт её переписка, контакты останутся. Если токен верный, а в «Диалогах» пусто — «Переустановить webhook».
- Сценарий включён и есть точка входа. «Сценарии» → на карточке нужного сценария плашка «Включён», а не «Черновик»; включается он переключателем на карточке или в списке сценариев на «Обзоре». В редакторе у сценария есть триггер «Команда (/start)»; для текста без команды — «Любое сообщение» или «Ключевые слова». Пустые новые сценарии и копии создаются черновиками.
Подробный разбор причин с симптомами и решениями — в блоге: почему Telegram-бот не отвечает.
Если три проверки пройдены
- Сообщение не доходит до «Диалогов». Напишите боту с другого аккаунта. Пусто в «Диалогах» при статусе «Работает» — webhook перехвачен: бота когда-то запускали своим кодом или в другом сервисе, и тот снова вызвал
setWebhook. Остановите старый код или уберите токен из того сервиса, затем нажмите «Переустановить webhook». - Ключевое слово перехватило ввод. Триггер «Ключевые слова» проверяется на каждое входящее, даже внутри сценария. Слово «цена» в режиме «Содержит слово» перезапустит сценарий посреди сбора телефона. Переведите короткие слова в режим «Точное совпадение» или уберите из них общие корни.
- Диалог у оператора или на паузе. Бот молчит только для одного человека — например, для вас после собственного теста. «Диалоги» → найдите переписку: статус «Оператор» — нажмите «Вернуть боту»; блок «Пауза» — дождитесь срока или проверьте настройку задержки.
- Группа. В группе бот видит только команды и ответы на свои сообщения, пока у @BotFather для него включён Group Privacy (так по умолчанию) и он не администратор группы. Личка при этом работает.
- Пользователь заблокировал бота. Telegram отвечает «Forbidden: bot was blocked by the user», и в «Диалогах» у ответа бота появляется пометка «не доставлено». Ни бот, ни ЧБТ ничего не сделают, пока человек не разблокирует бота и не напишет сам.
Быстрый способ отделить сценарий от подключения — «Проверить сценарий» в редакторе: тест-чат работает без Telegram. Если там всё отвечает, а в мессенджере тишина — проблема в канале, а не в блоках. Как подключался канал — в инструкции по подключению, где взять свежий токен — в статье о токене BotFather. Общий взгляд на канал — на странице бота для Telegram. Если бот не может написать первым и рассылка падает с PEER_ID_INVALID — это отдельная причина, не поломка. Нет бота — создайте его бесплатно и подключите Telegram за пять минут.