Настройка вебхука Telegram: как её выполнить?

Настройка вебхука Telegram начинается с добавления встроенного компонента Webhook. Затем используйте Telegram Webhook Setup, чтобы зарегистрировать его общедоступную конечную точку HTTPS в Telegram Bot API. Компонент настройки запрашивает 2 типа обновлений: message и callback_query. Запускайте его при регистрации или изменении конечной точки. После этого входящие обновления проходят через Webhook и Telegram Update Parser отдельно от настройки.

Автор: Ai Flowi · Техническая проверка: Janice Lee, техническая поддержка Ai Flowi.

Опубликовано · Обновлено

Как создать собственный вебхук?

Добавьте встроенный компонент Webhook и скопируйте адрес его общедоступной конечной точки HTTPS. Используйте этот адрес как Flowi Webhook URL в Telegram Webhook Setup. Для настройки также нужен токен бота; добавляйте Flowi API Key только в том случае, если используемая конфигурация вебхука требует аутентификации.

  • Токен бота Telegram. Храните его в секретном входном поле и не включайте в текст, которым делитесь.
  • Общедоступная конечная точка HTTPS компонента Webhook.
  • Ключ API Flowi, только если он требуется в используемой конфигурации вебхука.

Входные поля

Входное полеОбязательноеНазначение
Telegram Bot TokenДаАутентифицирует бота в Telegram. Используйте секретное поле.
Flowi Webhook URLДаОбщедоступная конечная точка HTTPS для регистрации.
Flowi API KeyНетАутентификация, если она требуется в используемой конфигурации вебхука. Используйте секретное поле.
Drop Old Pending MessagesНетПри включении запрашивает у Telegram удаление обновлений из очереди во время регистрации.

Как активировать вебхук?

Запустите Telegram Webhook Setup с токеном бота и общедоступным URL Webhook по HTTPS, добавив Flowi API Key только при необходимости. Проверьте регистрацию в Webhook Setup Result. Затем подключите Webhook.JSON к Telegram Update Parser.Telegram Update, чтобы входящие обновления поступали в цепочку обработки входящих обновлений.

  1. Добавьте Webhook и скопируйте адрес его общедоступной конечной точки HTTPS.
  2. Добавьте Telegram Webhook Setup и введите токен бота и адрес конечной точки в соответствующие поля.
  3. Добавьте Flowi API Key, если он требуется в используемой конфигурации вебхука. Выберите, нужно ли удалить обновления из очереди.
  4. Запустите компонент настройки и проверьте Webhook Setup Result.
  5. Настройте цепочку обработки входящих обновлений, подключив Webhook.JSON к Telegram Update Parser.Telegram Update.

Ожидаемый результат

Webhook Setup Result возвращает результат типа Data с описанием регистрации и ответа Telegram. Описанная в документации настройка вызывает setWebhook и проверяет регистрацию с помощью getWebhookInfo. Она запрашивает обновления message и callback_query. Не раскрывайте результат, если его URL содержит данные аутентификации.

Частые ошибки

  • Токен отсутствует: Проверьте секретное поле Telegram Bot Token.
  • URL отклонён: Проверьте, что конечная точка общедоступна и использует HTTPS.
  • Регистрация успешна, но обновления не поступают: Проверьте, что зарегистрированная конечная точка совпадает с текущей конечной точкой Webhook и что требования к её аутентификации соответствуют настройке. См. устранение неполадок Telegram.

Интеграция Telegram · Парсер обновлений Telegram · Устранение неполадок вебхуков