Webhook Telegram не работает: 404, SSL error, апдейты не приходят

Telegram не доставляет обновления на бота Bothost. Ниже чтение getWebhookInfo: чем отличаются 404, SSL error, таймаут соединения и растущий pending_update_count, и что именно на платформе отвечает за каждый случай.

Для людей и ИИ. Каноническая страница: https://bothost.ru/docs/telegram-webhook-errors · Markdown: https://bothost.ru/docs/telegram-webhook-errors.md · Индекс: https://bothost.ru/llms.txt

Отвечает на запросы: Telegram webhook not working, webhook 404, webhook SSL error, Wrong response from the webhook: 404 Not Found, certificate verify failed, Connection timed out, pending_update_count, setWebhook, WEBHOOK_URL.

Как устроены домен, порт и 0.0.0.0: Веб-приложения и домены. Если в логе Conflict и бот на polling, откройте бот не отвечает.

Что Bothost делает с webhook, а что остаётся в коде

• выпускает HTTPS для *.bothost.tech или для подключённого своего домена;
• передаёт в контейнер PORT и WEBHOOK_URL вида https://имя.bothost.tech/webhook;
• направляет внешний HTTPS на процесс, который слушает 0.0.0.0 и этот PORT.

Как читать getWebhookInfo

https://api.telegram.org/bot<ТОКЕН>/getWebhookInfo

webhook 404 Not Found

Как выглядит

Wrong response from the webhook: 404 Not Found

Почему

• В Telegram указан https://домен/webhook, а приложение слушает / , /telegram или /bot.
• Домен включён, своего HTTP-сервера в коде нет, отвечает служебная обёртка. У неё есть только GET /health. POST /webhook для неё неизвестный путь, отсюда 404. Бот как процесс может быть жив и даже отвечать через polling, если webhook при этом не снят: тогда часть апдейтов зависает в pending_update_count.
• GET / в браузере тоже 404. Для многих ботов это нормально: страницы на корне нет. Ошибка доставки появляется, когда тот же 404 приходит на путь из url в ответ на POST.

Что сделать

• Откройте https://домен/health. Если не открывается, это ещё не 404 маршрута, а порт или процесс: раздел про таймаут ниже и справочник ошибок.
• Сверьте путь посимвольно: getWebhookInfo → url и декоратор в коде (/webhook, а не /webhook/).
• Если health открывается, а своего сервера в репозитории нет, webhook на URL обёртки работать не будет. Либо реализуйте POST-обработчик в приложении и слушайте 0.0.0.0:PORT, либо снимите webhook и оставьте polling:

https://api.telegram.org/bot<ТОКЕН>/deleteWebhook

• После смены пути вызовите setWebhook ещё раз и отправьте боту сообщение. pending_update_count должен перестать расти, в логах контейнера появится входящий POST.

https://api.telegram.org/bot<ТОКЕН>/setWebhook?url=https://<домен>/webhook&secret_token=<секрет>

webhook SSL error

Как выглядит

Почему Telegram отклоняет URL

Что сделать

• Откройте https://домен/health в браузере в режиме инкогнито. Страница должна открыться без предупреждения о сертификате.
• В setWebhook используйте https:// и хост из панели, без порта :443 в обход и без IP вместо имени.
• Если сертификат только что выпустили, вызовите setWebhook повторно после успешного открытия health в браузере.
• Поле has_custom_certificate в getWebhookInfo для обычного домена Bothost должно быть false: свой сертификат в setWebhook загружать не нужно.

Connection timed out, Connection refused, 502

Как выглядит

Connection timed out
Connection refused
Wrong response from the webhook: 502 Bad Gateway

Почему

import os

host = "0.0.0.0"
port = int(os.environ.get("PORT", "3000"))

pending_update_count растёт, last_error_message пустой или про таймаут ответа

• обработчик не возвращает HTTP 200 (возвращает 500, обрывает соединение, ждёт долгую операцию и не отвечает);
• ответ уходит слишком поздно, Telegram повторяет тот же update_id, в чате сообщения двоятся.

Короткий порядок проверки

• Тариф с доменом, в панели у бота есть https://....
• getMe возвращает ok: true (токен живой).
• https://домен/health открывается в браузере без предупреждения сертификата.
• getWebhookInfo: url совпадает с путём в коде, last_error_message пустой после тестового сообщения.
• В логах контейнера есть входящий POST и нет цикла restarting.
• В коде нет одновременно set_webhook и start_polling.

См. также

• Бот не отвечает: Conflict, токен, Discord
• Веб-приложения и домены
• Домены и порты
• Справочник ошибок при деплое