Telegram Bot API

Проверка вебхука Telegram-бота

Проверьте вебхук Telegram-бота в один клик: инструмент вызывает getWebhookInfo, показывает URL, очередь обновлений и последнюю ошибку доставки с подсказкой, как её исправить, а также позволяет установить или удалить вебхук.

Токен остаётся в вашем браузере (localStorage) и отправляется только на api.telegram.org.

Установить или изменить вебхук

Как проверить вебхук Telegram-бота

  1. Вставьте токен бота. Отметьте Тестовый сервер, если бот в тестовом окружении.
  2. Нажмите Проверить вебхук. Возможны три результата: вебхука нет (бот использует getUpdates), вебхук без ошибок за последние 24 часа или проблема доставки с временем и текстом последней ошибки и подсказкой.
  3. Посмотрите на счётчик ожидающих обновлений. Больше 100 подсвечивается: обновления копятся, потому что сервер их не принимает.
  4. Ниже — полный ответ getWebhookInfo: url, has_custom_certificate, pending_update_count, last_error_date, last_error_message, max_connections и другие поля.
  5. Чтобы изменить вебхук, откройте Установить или изменить вебхук: укажите HTTPS URL, при желании secret_token, решите, сбрасывать ли очередь, и нажмите setWebhook или deleteWebhook. Проверка запустится снова автоматически.

Частые ошибки вебхука

Подсказка подбирается по тексту last_error_message:

Ошибка похожа наЧто проверить
SSL / certificateВалидный сертификат для домена (или самоподписанный, загруженный через параметр certificate в setWebhook), TLS 1.2+.
Wrong response from the webhook: 4xx/5xxПуть, проверку secret_token и ошибки сервера — Telegram ждёт 2xx.
Таймаут / сброс соединенияСервер должен быть доступен из интернета на порту 443, 80, 88 или 8443 и быстро отвечать.
Connection refusedПорт никто не слушает или файрвол блокирует Telegram.
Не удаётся разрешить доменDNS-записи домена вебхука.

Форма отправляет только url, secret_token и drop_pending_updates. Секрет (1–256 символов A-Z a-z 0-9 _ -) приходит в заголовке X-Telegram-Bot-Api-Secret-Token каждого запроса. Для allowed_updates, max_connections или сертификата используйте /ru/telegram-bot-api-tester.html#setWebhook.

Конфиденциальность

Токен остаётся в localStorage браузера, а getWebhookInfo, setWebhook и deleteWebhook отправляются напрямую на api.telegram.org — через наш сервер ничего не проходит. Тот же вызов доступен в /ru/telegram-bot-api-tester.html#getWebhookInfo. Полная настройка описана в гайде /ru/guides/telegram-bot-webhook.html, а 409 Conflict и другие ошибки — в /ru/guides/telegram-bot-api-errors.html.

Частые вопросы

Как проверить, установлен ли вебхук у Telegram-бота?

Вызовите getWebhookInfo. Если url пустой, вебхука нет и бот работает через getUpdates. Инструмент выше делает этот вызов и объясняет результат.

Как удалить вебхук Telegram-бота?

Вызовите deleteWebhook — в инструменте откройте Установить или изменить вебхук и нажмите deleteWebhook. Отмечайте Сбросить ожидающие обновления, только если очередь не нужна. После этого getUpdates снова работает.

Почему растёт pending_update_count?

Telegram не может доставить обновления: сервер недоступен, медленный или отвечает статусом не 2xx. Смотрите last_error_message; Telegram повторяет попытки, а обновления хранятся до 24 часов.

Что значит «Wrong response from the webhook»?

Ваш сервер ответил HTTP-статусом не из 2xx — например, 404 из-за неверного пути или 500 из-за падения. Telegram ждёт быстрый ответ 2xx и иначе повторяет доставку.

Другие утилиты

Поиск chat IDЭкранирование MarkdownV2 и HTMLВалидатор initData Mini AppBot API Tester