Webhook (вебхук) — это механизм, который позволяет различным сервисам и приложениям обмениваться данными в режиме реального времени.
Вебхуки функционируют с помощью запуска HTTP-запросов (обычно POST) к определенному URL при наступлении заданного события. Это позволяет автоматизировать задачи и создавать сложные рабочие процессы, которые реагируют на изменения данных в одном сервисе и передают их другим.
В интеграциях Unisender вы можете встретить подключения, которые необходимо донастроить через вебхуки. Например, Marquiz, Яндекс.Формы, Tilda, Yclients, Flexbe, Formdesigner, Jivo и др. Для таких подключений система автоматически генерирует вебхук, который вам нужно прописать в настройках стороннего сервиса.
Если вам нужно подключить сервис, которого еще нет в личном кабинете, воспользуйтесь отдельным подключением «Вебхук». С его помощью вы можете самостоятельно настроить интеграцию между Unisender и другим сервисом.
Обратите внимание. Подключение «Вебхук» можно использовать в связках только в качестве триггера.
При попытке добавить его в качестве действия, вы увидите следующее сообщение: «Действия не найдены. Этот сервис поддерживает только триггеры».
Разберем, как это сделать, более подробно.
Как настроить вебхук
Шаг 1. Добавьте подключение
Чтобы добавить подключение через вебхук, перейдите в личном кабинете Unisender в раздел «Интеграции» — «Мои интеграции» — «Подключения». Нажмите кнопку «Добавить подключение».
Выберите сервис, который хотите подключить к Unisender, и нажмите «Добавить подключение». В нашем случае нужно выбрать подключение «Вебхук».
Также вы можете добавить новое подключение при создании связки. Для этого в настройках триггера выберите «Вебхук» в качестве сервиса, откуда будут поступать данные, и укажите тип события «Входящий webhook». Затем на шаге выбора аккаунта нажмите «Добавить подключение».
При необходимости вы можете изменить название подключения.
Нажмите кнопку «Далее».
Шаг 2. Донастройте подключение
Далее вы увидите системное сообщение, что подключение создано, но его нужно донастроить. Нажмите «Понятно».
Скопируйте сгенерированный вебхук.
Если вы создаете подключение в разделе «Подключения», скопируйте URL-адрес вебхука в настройках подключения.
Если вы добавляете подключение на этапе создания связки, скопируйте вебхук перед запуском Ловца хуков.
Теперь вам нужно прописать данный вебхук в настройках сервиса, который вы хотите подключить к Unisender. Для этого найдите в настройках этого сервиса раздел, который связан с уведомлениями или внешними интеграциями, и добавьте туда скопированный вебхук. Не забудьте сохранить изменения, чтобы активировать вебхук.
Шаг 3. Запустите Ловец Хуков
Вернитесь в личный кабинет Unisender, чтобы запустить Ловец Хуков.
Если вы создаете подключение в разделе «Подключения», сначала нажмите в самом низу настроек кнопку «Поймать вебхук», затем кликните «Ожидать веб-хук»
Если вы добавляете подключение на этапе создания связки, сразу нажмите кнопку «Ожидать веб-хук».
После запуска Ловца Хуков вам необходимо отправить тестовый запрос со стороны вашего сервиса. Для этого перейдите в него и выполните действие, которое должно активировать вебхук.
Затем вернитесь в Unisender. Если все настроено правильно, вы увидите следующее сообщение:
Если вам не удается получить данные, проверьте настройки вебхука и повторите тест.
Как добавить несколько вебхуков
Вы можете использовать любое количество новых вебхуков, добавляя их через новое подключение по инструкции выше.
Важно. Например, если вы используете несколько форм для сбора заявок и хотите, чтобы данные контактов попадали в разные списки, создавайте для каждого списка отдельный вебхук. Тогда данные будут передаваться в Unisender корректно.
Что такое Ловец хуков
Ловец хуков — это специальный инструмент, который помогает «поймать» ответ от стороннего сервиса. Он нужен для того, чтобы определить, какие поля должны передаваться при наступлении определенного события.
Разница между API-вызовом и вебхуком в том, что вебхук реагирует на событие, которое произошло и сигнализирует об этом в режиме реального времени, а api запрашивает данные, проверяет изменения и затем забирает ответ.
Поэтому Ловец хуков нужен для того, чтобы правильно определить «источник» изменений и сами изменения в реальном времени.
Запустите Ловец хуков, сделайте какое-то изменение в вашем сервисе, чтобы триггер сработал, а данные передались в Unisender. После этого вы сможете сопоставлять эти данные между собой на следующих этапах настройки связки, например, указать поле email для добавления его в список в Unisender. Если этого не сделать, связка будет работать, но данные поля не будут приходить и новые контакты не будут добавляться в список.
В Unisender система автоматически генерирует вебухки для тех подключений, где нужно выполнить донастройку. Например, Tilda, Яндекс.Формы, Yclients, Flexbe, Formdesigner, Jivo и др.
Поэтому если вы в других сервисах (например, «Битрикс24») увидите триггеры или экшены, созданные с помощью вебхуков, то вам не следует переживать о дополнительной проверке триггера. Весь необходимый код запросов уже «зашит» в связке и прописывать дополнительные URL-адреса вебхуков не нужно.
Значок спиннера сигнализирует, что событие запускается через вебхук
