Перевірка вебхука Telegram-бота
Перевірте вебхук Telegram-бота в один клік: інструмент викликає getWebhookInfo, показує URL, чергу оновлень і останню помилку доставлення з підказкою, як її виправити, а також дає змогу встановити або видалити вебхук.
Токен залишається у вашому браузері (localStorage) і надсилається лише на api.telegram.org.
Встановити або змінити вебхук
Як перевірити вебхук Telegram-бота
- Вставте токен бота. Позначте Тестовий сервер, якщо бот у тестовому середовищі.
- Натисніть Перевірити вебхук. Можливі три результати: вебхука немає (бот використовує
getUpdates), вебхук без помилок за останні 24 години або проблема доставлення з часом і текстом останньої помилки та підказкою. - Погляньте на лічильник оновлень у черзі. Понад 100 підсвічується: оновлення накопичуються, бо сервер їх не приймає.
- Нижче — повна відповідь
getWebhookInfo:url,has_custom_certificate,pending_update_count,last_error_date,last_error_message,max_connectionsта інші поля. - Щоб змінити вебхук, відкрийте Встановити або змінити вебхук: вкажіть 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 чи сертифіката скористайтеся /uk/telegram-bot-api-tester.html#setWebhook.
Конфіденційність
Токен залишається в localStorage браузера, а getWebhookInfo, setWebhook і deleteWebhook надсилаються напряму на api.telegram.org — через наш сервер нічого не проходить. Той самий виклик доступний у /uk/telegram-bot-api-tester.html#getWebhookInfo. Повне налаштування описано в гайді /uk/guides/telegram-bot-webhook.html, а 409 Conflict та інші помилки — у /uk/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