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 чи сертифіката скористайтеся /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