Интеграция Telegram: как она работает?

Интеграция Telegram позволяет AI Flowi Workflow получать обновления бота Telegram через общедоступную конечную точку HTTPS компонента Webhook. Этот путь использует 2 расширения, описанных в документации: Telegram Webhook Setup регистрирует конечную точку, а Telegram Update Parser извлекает поля входящего JSON. Регистрация выполняется отдельно от обработки обновлений. См. коммерческий обзор интеграций.

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

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

Компоненты и их роли

КомпонентРоль
WebhookПолучает обновление Telegram в формате JSON.
Telegram Webhook SetupРасширение, описанное в документации, которое регистрирует конечную точку вебхука.
Telegram Update ParserРасширение, описанное в документации, которое извлекает типичные поля из обновления.

Для настройки нужны токен бота и URL Webhook, а также ключ API — только если он требуется в используемой конфигурации вебхука. Обработка входящих обновлений начинается, когда Telegram отправляет обновление в Webhook. Подключите Webhook.JSON к Telegram Update Parser.Telegram Update, затем передайте описанные в документации поля парсера следующему шагу рабочего процесса.

В документации парсера указаны поля chat_id, user_id, username, text и command. Точные сведения о типе выходных данных не предоставлены. Перед подключением последующих компонентов проверьте порты и типы в своей среде.

С чего начать работу с Telegram?

Начните с настройки вебхука, чтобы зарегистрировать общедоступную конечную точку HTTPS, затем изучите входящие поля по руководству для парсера обновлений. Следуйте руководству по ИИ-боту, чтобы настроить логику рабочего процесса и отдельный запрос для отправки ответа. Обратитесь к разделу устранения неполадок при сбоях регистрации, разбора данных, подключения последующих компонентов или отправки ответов.

  1. Настройте вебхук Telegram, чтобы зарегистрировать конечную точку.
  2. Разберите обновления Telegram, чтобы разобраться во входящих данных.
  3. Создайте ИИ-бота Telegram, чтобы пройти весь путь рабочего процесса.
  4. Устраните неполадки Telegram при сбоях регистрации, разбора данных или отправки ответов.

Храните токен бота в его секретном входном поле и проверяйте результат регистрации, прежде чем делиться им: URL вебхука может содержать данные аутентификации.

Интеграции · Устранение неполадок вебхуков · Основы рабочих процессов