Если бот по какому-то клиенту перестаёт отправлять сообщения — обычно в карточке диалога или в логах сценария видна ошибка от Telegram. Разбираемся, что они значат и что с ними делать.
Forbidden: bot was blocked by the user
Что значит: клиент нажал «Заблокировать» на ваш бот в Telegram.
Что делать: ничего технически — Telegram не разрешает писать «заблокировавшим». Мы автоматически:
- помечаем диалог как
blocked, - останавливаем все follow-up для этого клиента,
- исключаем его из будущих рассылок.
Если клиент сам разблокирует бота и напишет снова — статус снимается, всё снова работает.
Forbidden: user is deactivated
Что значит: клиент удалил свой Telegram-аккаунт.
Что делать: ничего, диалог становится «мёртвым». Можно скрыть из «Диалогов» фильтром.
Bad Request: chat not found
Что значит: Telegram не находит чат, в который мы пытаемся писать.
Возможные причины:
- Диалог с клиентом был удалён со стороны нашего сервиса (например, чисткой).
- Клиент удалил аккаунт.
- Бот удалил себя из группы (для случаев работы в группах).
Что делать: обычно проблема в данных. Откройте «Диалоги», найдите клиента — если его нет, скорее всего, аккаунт удалён.
Bad Request: message is too long
Что значит: в Telegram лимит на одно текстовое сообщение — 4096 символов.
Что делать: разбейте сообщение на несколько. Если вы получили это в сценарии — отредактируйте блок «Сообщение» и сократите текст или вынесите часть в отдельный блок.
Если у вас ИИ-агент отвечает длинно — поставьте в его инструкции «отвечай не более чем 4 абзацами».
Bad Request: message text is empty
Что значит: в блоке «Сообщение» нет текста (пустая строка) и нет вложений.
Что делать: откройте сценарий, найдите проблемный блок и добавьте текст или вложение.
Bad Request: PEERIDINVALID
Что значит: клиент ещё не нажимал /start у вашего бота.
Что делать: бот в Telegram не может писать первым. Сначала клиент должен сам начать диалог (написать /start или любое сообщение). После этого бот сможет отвечать. Это базовое правило Telegram, обойти нельзя.
Подробнее об этом — в «Подключение Telegram-бота».
Bad Request: BUTTONDATAINVALID
Что значит: в кнопке Inline-Keyboard передан некорректный callback_data — слишком длинный, с запрещёнными символами.
Что делать: обычно это значит, что в сценарии настроена кнопка с нестандартным значением. Откройте редактор сценария, проверьте имена шагов (для перехода) — они не должны быть слишком длинными.
Too Many Requests / 429
Что значит: Telegram временно «затормозил» вашего бота из-за слишком частых отправок (обычно при рассылке).
Что делать: ничего — наш отправщик автоматически ставит паузу на указанное Telegram время (обычно 5–30 секунд) и повторяет запрос. На рассылке это выглядит как «зависание на минуту, потом продолжение».
Профилактика
На массовых рассылках указывайте умеренную скорость (например, 30–60 сообщений/мин). Подробнее — в статье «Рассылки».
Bad Request: chatwriteforbidden
Что значит: бот не имеет прав писать в этот чат (обычно касается каналов и групп).
Что делать: в группе обсуждения, где работают комментарии под постами, бот должен быть администратором. Если речь о канале — рассылки в канал из нашего сервиса не идут (только в личные диалоги).
Unauthorized
Что значит: токен бота недействителен. Возможные причины:
- Токен пересоздан в @BotFather (revoke), а в настройках бота остался старый.
- Бот удалён в @BotFather.
- Какой-то сбой авторизации.
Что делать: откройте бота в списке ботов → «Настройки» → карточка «API-токен» → «Сменить токен». Введите свежий токен из @BotFather. Подробнее — в «Токен Telegram».
Conflict: terminated by other getUpdates
Что значит: у вашего токена параллельно работает другой сервис (или вы случайно подключили бота к двум сервисам сразу).
Что делать: отключите бота от старого сервиса, или revoke токен в @BotFather и подключите заново в ЭТОЧАТБОТЕ.
Bad Request: can't parse entities / can't parse entities in the message text
Что значит: в тексте сообщения сломанная HTML / Markdown разметка (открыли <b>, не закрыли).
Что делать: проверьте текст в блоке «Сообщение» сценария. Если используете HTML — обязательно закрывайте все теги. Самые частые ошибки — <b> без </b>, & без экранирования.
Совет
ЭТОЧАТБОТ автоматически валидирует разметку в редакторе. Если в превью видны странные символы — значит, и Telegram её отвергнет.
Network error / Timeout
Что значит: временные проблемы связи с Telegram.
Что делать: мы автоматически повторяем такие сообщения через несколько секунд. Если ошибка не уходит много часов — напишите в поддержку.
Что делать, если ошибка не из этого списка
Иногда Telegram возвращает редкую или новую ошибку. В этом случае:
- Сделайте скриншот текста ошибки из карточки диалога.
- Запомните примерное время и имя клиента.
- Напишите в поддержку с этими данными.
Мы посмотрим серверные логи и подскажем, что произошло, или обновим обработку этой ошибки в системе.
Что дальше
- Подключение Telegram-бота — основа.
- Токен Telegram — частая причина «Unauthorized».
- Команды и приватность — для группов.
- Рассылки — где появляются 429.