Почему не работает бот в Телеграме: что проверить самому и когда звать разработчика

Сначала поймите, молчит ваш бот или весь Телеграм

Откройте Telegram и напишите кому-нибудь из коллег. Потом зайдите в любого другого бота, которым вы пользуетесь, и нажмите /start. Если сообщения не уходят нигде, проблема не в боте: сбой у Telegram, у вашего интернета или мобильного оператора. Подождите и проверьте с другой сети, например с Wi-Fi вместо мобильного интернета.

Если другие боты отвечают, а ваш нет — дело в вашем боте. Попросите знакомого написать ему со своего телефона. Так вы отделите поломку бота от проблемы с одним конкретным аккаунтом.

Симптом подсказывает причину

Клиент не нажал «Старт» или заблокировал бота

Бот не может написать человеку первым. По правилам Telegram пользователь должен сам открыть чат с ботом и отправить сообщение, обычно это кнопка «Старт», или добавить бота в группу. Если клиент оставил телефон на сайте, но ни разу не открывал бота, уведомление до него не дойдёт.

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

Токен поменяли в BotFather

Токен — это ключ, по которому программа бота подключается к Telegram. Его выдаёт BotFather, служебный бот Telegram для управления ботами. Командой /token в BotFather можно выпустить новый ключ, если старый утёк или потерялся. После этого программа со старым ключом перестаёт подключаться, и бот замолкает для всех сразу.

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

Сервер выключен или хостинг не оплачен

Бот — это программа, которая круглосуточно работает на сервере. Если хостинг не оплачен, сервер перезагрузили и программа не запустилась сама или на диске кончилось место, бот перестаёт отвечать без всяких ошибок в Telegram.

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

Учтите: Telegram хранит входящие сообщения для бота не дольше 24 часов. Если бот лежал дольше суток, часть обращений клиентов после восстановления уже не придёт. Поэтому чинить лучше в тот же день, а не после выходных.

Оборвалась связь между ботом и Telegram

Бот получает сообщения одним из двух способов. Первый — вебхук: Telegram сам отправляет каждое сообщение на адрес вашего сервера. Второй — опрос (long polling): программа бота сама регулярно спрашивает у Telegram, нет ли новых сообщений. Одновременно оба способа не работают: пока настроен вебхук, опрос не получит обновлений.

Если бот работает через вебхук

У Telegram есть строгие требования к адресу. Нужен действующий SSL-сертификат, который совпадает с доменом, и один из портов 443, 80, 88 или 8443. Перенаправления на другой адрес не поддерживаются. Истёк сертификат, сменили домен, настроили редирект — и Telegram перестаёт доставлять сообщения.

Разработчик проверяет это одним запросом getWebhookInfo. В ответе видно адрес вебхука, сколько сообщений ждут доставки и текст последней ошибки в поле last_error_message. Если там растёт очередь и есть ошибка, причина почти всегда на стороне сервера или сертификата. Запрос делается с токеном бота, поэтому попросите разработчика прислать результат, а не сам токен.

Что мы видим на серверах в России

В нашей практике бот на российском сервере часто не может напрямую достучаться до серверов Telegram: запросы обрываются по таймауту. Снаружи это выглядит так, будто бот завис, хотя программа работает. Таких ботов мы подключаем к Telegram через прокси-сервер.

С весны 2026 года у нас бывали случаи, когда вебхук на домен в зоне .ru не удавалось установить из-за блокировок. Таких ботов мы переводим на опрос: Telegram больше не нужно стучаться к вам на сервер, бот сам забирает сообщения. Если ваш бот работает на российском хостинге и замолчал без видимых причин, спросите разработчика про эти два пункта в первую очередь.

Бот не работает в группе

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

• ▸Самый простой путь — сделать бота администратором группы. Администраторы получают все сообщения.
• ▸Второй путь — отключить режим приватности командой /setprivacy в BotFather. После этого бота нужно удалить из группы и добавить заново, иначе изменение не сработает.
• ▸Боты не видят сообщения других ботов ни в каком режиме. Если один бот должен реагировать на другого, через группу это не заработает.

Бот отвечает через раз или замолкает на рассылке

У Telegram есть ограничения на скорость отправки. В один чат не стоит слать больше одного сообщения в секунду, в группу бот может отправить не больше 20 сообщений в минуту. Массовая рассылка ограничена примерно 30 сообщениями в секунду, если не подключены платные рассылки.

При превышении Telegram отвечает ошибкой 429 и сообщает, через сколько секунд можно повторить. Если программа бота это не учитывает, часть сообщений теряется. Типичная картина — рассылка по базе клиентов, после которой бот на время перестаёт отвечать и в личке.

Бот на конструкторе и обновления Telegram

Если бот собран в конструкторе, сначала зайдите в его личный кабинет. Закончился тариф, не прошла оплата картой, превышен лимит сообщений — и бот отключается, хотя в Telegram всё выглядит как обычно. Ошибок там вы не увидите, только тишину.

Telegram регулярно выпускает новые версии Bot API и публикует список изменений. Если бот сломался сразу после такого обновления, сообщите об этом разработчику: ему будет проще найти причину.

Чек-лист: что проверить самому

1. 01Напишите коллеге и откройте другого бота: работает ли Telegram у вас вообще.
2. 02Откройте своего бота и нажмите /start. Попросите знакомого сделать то же самое со своего телефона.
3. 03Если бот не отвечает одному клиенту, попросите его открыть бота и нажать «Старт» заново.
4. 04Зайдите в личный кабинет хостинга или конструктора: нет ли долга, блокировки, окончания тарифа.
5. 05Вспомните, что менялось за последние дни: домен, сервер, сертификат, сотрудники с доступом к BotFather.
6. 06Если проблема только в группе, проверьте, есть ли у бота права администратора.
7. 07Запишите время, когда бот замолчал, и сделайте скриншоты переписки без ответа.

Что передать разработчику

Чем точнее описание, тем быстрее починка. Отправьте разработчику одним сообщением:

• ▸когда бот перестал отвечать и молчит ли он всем или части клиентов;
• ▸скриншоты: ваш /start и отсутствие ответа, а для группы — список администраторов;
• ▸что менялось накануне: оплата, переезд, домен, токен, новые сотрудники;
• ▸просьбу проверить getWebhookInfo, логи бота и ошибки 429.

Логи, сервер, сертификат и настройку вебхука проверяет только разработчик: для этого нужен доступ к серверу и коду. Если прежний подрядчик пропал, а доступов нет, начинать придётся с их восстановления. Сервер, сертификат и проверка доступности — та же работа, что и в технической поддержке сайта. Если бот и сайт живут на одном сервере, их удобно держать в одних руках.

Когда проще сделать бота заново

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

Перед этим стоит решить, что бот должен делать: принимать заявки, записывать клиентов, присылать уведомления или считать стоимость. Варианты — в статье виды Telegram-ботов для бизнеса, а как мы делаем ботов под ключ — на странице разработка Telegram-ботов.