Веб-запросы и вебхуки
Как запустить бота событием с сайта и как из реакции запросить другой сервис. Настройки входящих и исходящих запросов.
На этой странице
Сайт может сообщить боту о новой заявке, а бот может запросить на сайте статус заказа. Это два разных направления обмена:
| Направление | Кто начинает обмен | Пример |
|---|---|---|
| Входящий вебхук | Другой сервис отправляет уведомление в GetMyBot и запускает реакцию | На сайте появилась заявка, бот сообщил менеджеру |
| Исходящий веб-запрос | Реакция обращается к другому сервису и получает ответ | Бот запросил на сайте цену или статус заказа |
Вебхук означает автоматическое уведомление одного сервиса другому.
Оба способа используют HTTP, тот же протокол, по которому браузер обращается к сайтам. Для готовых подключений см. Интеграции.
Входящий вебхук (триггер)
Триггер «Входящий веб-запрос (webhook)» запускает реакцию по HTTP-запросу извне:
- Адрес: включите триггер и сохраните реакцию. После сохранения GetMyBot создаст для неё URL вебхука и покажет его в этом поле. Адрес можно скопировать, но нельзя изменить.
- Секретный токен: не даёт посторонним запускать реакцию по этому адресу.
- Метод:
POST/GET/PUT/ANY.
Поля полученного запроса сохраняются во временные данные реакции (ctx). Например, если сервис прислал поле order_id, оно доступно в действиях как {{ctx.order_id}}. После настройки отправьте пробный запрос и проверьте, что реакция получила нужные поля.
Исходящий веб-запрос (действие)
Действие «Веб-запрос» делает HTTP-запрос из реакции:
- метод (
GET,HEAD,OPTIONS,POST,PUT,PATCHилиDELETE), заголовки и тело (JSON или текст); - коды успеха, таймаут и число повторов при ошибке;
- сохранение ответа в параметр пользователя или временные данные реакции (
ctx); JSONPath указывает путь к нужному полю в ответе; - режим асинхронно: бот продолжит реакцию, не дожидаясь ответа сервиса. Результат можно обработать отдельной реакцией при успехе/ошибке.
Близкие действия: «Загрузить URL» (скачать текст страницы в ctx) и «Запрос к источнику» / «Запись в источник» для сохранённых коннекторов: см. Источники и ключи.
Вебхук-интеграция
Для регулярной отправки данных в один сервис настройте интеграцию «Вебхук». Укажите его URL и HMAC-подпись, по которой принимающая сторона сможет проверить отправителя. См. Интеграции.
Безопасность
Для входящего запроса задайте секретный токен, чтобы посторонний не мог запускать реакцию. Исходящий запрос не может обратиться к закрытым адресам внутренней сети через платформу. Такая защита называется SSRF. Размер ответа также ограничен.
Что дальше
- Триггеры: триггер входящего вебхука.
- Действия:
Веб-запрос,Загрузить URL. - Подстановки и формулы: данные запроса в
ctx.