Вебхуки

Вебхук – это способ обмена информацией между приложениями при определенных событиях. Они помогают в удобной форме организовать приход заявок с сайта. После отправки заявки в интегрированном приложении создается запись, куда попадают данные с формы.

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

Откроется вкладка «Настройки формы».

Перейдите во вкладку «Интеграции и модули» и нажмите кнопку Настроить в блоке «Webhook»

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

На странице подключения вебхука необходимо:

  1. выбрать один или несколько статусов, для которых будет срабатывать вебхук,
  2. в поле «Название вебхука» указать его наименование,
  3. в поле «Укажите адрес» ввести URL обработчика вебхука по протоколу https://

По завершении нажмите кнопку Подключить

В таблице появится подключенный вебхук с активным статусом

При необходимости можно отключать вебхуки отдельно

Или деактивировать сразу все

После отправки формы срабатывает вебхук и отправляет данные на указанный адрес. Примерный вид тела запроса:

{
  "lead_files": [
  "link_to_downloaded_file",
  ],
  "form_id": number_id,
  "lead_data":{
  "field_name1":"field_value1",
  "field_name2":"field_value2",
  "field_name3":"field_value3",
  "field_name4":"field_value4",
  "field_name5":"field_value5"
  }
 

Обработчик получает данные, которые в дальнейшем могут быть обработаны как угодно или отправлены в другую систему разработчиком вебхука.

Подробнее о том, как работает вебхук и чем отличается от API можно из нашей статьи.

Оставить комментарий