База знаний GetMyBot

Веб-запросы и вебхуки

Как запустить бота событием с сайта и как из реакции запросить другой сервис. Настройки входящих и исходящих запросов.

На этой странице

Сайт может сообщить боту о новой заявке, а бот может запросить на сайте статус заказа. Это два разных направления обмена:

НаправлениеКто начинает обменПример
Входящий вебхукДругой сервис отправляет уведомление в 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. Размер ответа также ограничен.

Что дальше