Настройка вебхуков при пересылке в Telegram

Вебхуки - это механизм автоматической отправки данных между сайтами и приложениями при определённых событиях. Данные передаются с помощью HTTP-запроса: одно приложение отправляет их через интернет на заранее указанный адрес другого.

Возможности вебхуков

В FLOWIN вебхуки работают с пересылками. Они могут срабатывать при появлении, изменении, удалении или закреплении сообщения в исходном чате (источнике), а также при нажатии кнопки в чате, куда пересылаются сообщения (назначении).

Так можно связать FLOWIN с социальными сетями, биржами, таблицами и CRM (системами для работы с клиентами). Такая связь называется интеграцией и позволяет:

• Автоматически добавлять заявки из Telegram в CRM.
• Передавать торговые сигналы из Telegram на биржу для автоследования, то есть автоматического совершения сделок по этим сигналам.
• Пересылать сообщения из Telegram в другие социальные сети.
• Копировать посты и сообщения в Google Таблицы.
• Настроить автоответчик в боте.

Для каждого сценария нужно настроить приём данных и нужное действие на стороне сайта или приложения.

Создание вебхука

Проверим вебхук на сайте webhook.site, который выдаёт адрес для приёма данных и показывает полученные запросы. Отправим на него текст нового сообщения из Telegram.

Для этого нужна настроенная и работающая пересылка в FLOWIN.

0. Откройте @flow_in_bot, отправьте команду /start и нажмите «Панель управления».

   

1. Откройте webhook.site в отдельной вкладке. Скопируйте адрес для приёма запросов из поля «Your unique URL».

   

2. В панели FLOWIN откройте «Меню» → «Вебхуки» и нажмите «Создать».

   

   

3. В верхнее поле вставьте скопированный адрес. В поле «Тело запроса» укажите {"message":"<message-text>"} и нажмите «Создать». Это шаблон отправляемых данных: вместо <message-text> FLOWIN подставит текст сообщения, а получатель увидит его в поле message.

   

4. Нажмите «Применить» у созданного вебхука. Отметьте нужную пересылку и нажмите «Сохранить».

   

   

5. Отправьте в чат-источник тестовое сообщение, например «Заявка №1042: нужен каталог мебели.». Вернитесь на webhook.site: первый полученный запрос откроется автоматически. В блоке «Request Content» появится текст заявки в поле message. Теперь FLOWIN будет автоматически отправлять текст каждого нового сообщения на указанный адрес перед его пересылкой в чат назначения.

   

   

Настройки вебхуков

Рассмотрим настройки на примере созданного вебхука: как их изменить и что означает каждое поле.

Как изменить настройки вебхука

1. В списке «Вебхуки» нажмите «Изменить» у нужного вебхука.

   

2. Измените нужные поля и нажмите «Сохранить».

   

   

HTTP-метод

HTTP-метод задаёт действие запроса: POST передаёт данные на обработку, GET запрашивает данные, PUT заменяет их. По умолчанию выбран POST, подходящий для нашего теста. Для другого сайта или приложения выбирайте метод, указанный в его документации.

URL-адрес

URL означает адрес в интернете. Здесь указывают адрес для приёма данных, полученный на подключаемом сайте или в приложении. В нашем примере его выдал webhook.site.

Тело запроса

Тело запроса содержит отправляемые данные в формате JSON: пары «название поля: значение». Состав полей зависит от требований подключаемого сайта или приложения.

Метатеги - это обозначения, вместо которых FLOWIN подставляет данные сообщения. Например, <message-text> заменяется текстом, а <author-name> именем автора. Список метатегов также открывается по ссылке «метатеги» под полем.

Заголовки запроса

«Заголовки запроса» содержат служебные сведения для получателя. Например, ключ доступа позволяет проверить, кто отправил запрос. Заголовки задают в формате JSON. Обычно это поле менять не требуется; нужные значения берут из документации подключаемого сайта или приложения.

Триггер запроса

«Триггер запроса» определяет событие и момент, когда вебхук должен отправить запрос на указанный адрес. В качестве события можно выбрать:

• «Отправка» выбрана по умолчанию. Вебхук срабатывает при пересылке нового сообщения.
• «Изменение» срабатывает при обработке изменения сообщения в источнике.
• «Закреп» срабатывает при обработке закрепления сообщения в источнике.
• «Удаление» срабатывает при обработке удаления сообщения в источнике.
• «Нажатие кнопки» срабатывает для кнопок с обратным вызовом (callback) в чате назначения. Такая кнопка сообщает боту о нажатии и передаёт заданные для неё данные. Обычная кнопка со ссылкой этот вебхук не запускает.

Момент отправки определяет, на каком этапе пересылки уйдёт запрос:

• «До обработки»: запрос уходит до перевода и обработки сообщения искусственным интеллектом (ИИ).
• «После обработки»: запрос уходит после перевода и обработки ИИ.
• «После отправки»: запрос уходит, когда сообщение уже успешно отправлено или изменено в чате назначения.

Описание

«Описание» служит комментарием для вашего удобства и не влияет на работу вебхука. Поле можно оставить пустым.

Доступные действия с вебхуком

Созданными вебхуками можно управлять из списка «Вебхуки»:

• «Изменить» открывает основные настройки вебхука.
• «Дублировать» в меню «Ещё» создаёт копию настроек вебхука.
• «Выбрать проект» в меню «Ещё» добавляет вебхук в проект.
• «Удалить» в меню «Ещё» удаляет вебхук.

Кроме того, у каждого вебхука есть кнопка «Пересылки [N]», которая открывает выбор пересылок, к которым он применяется. N означает количество выбранных пересылок. Если пересылки ещё не выбраны, вместо неё показана кнопка «Применить».