Настройка передачи данных из форм персонализации сайта Mindbox через Albato

Задача: настроить передачу данных из форм персонализации сайта Mindbox в другую систему через Albato.

Иногда требуется сразу передавать данные из форм сайта, настроенных на стороне Mindbox, во внешнюю систему и не сохранять в Mindbox.

Эту задачу можно решить с помощью веб-хука из Mindbox и связки в Albato. Для настройки связки понадобится аккаунт в Albato.

Почему через Albato? Исходящий из Mindbox веб-хук имеет определенный формат, который подходит не каждой системе. Для того, чтобы настроить прием такого запроса обычно требуется привлечь разработку. Через Albato можно настроить связку передачи лидов и данных из попапов и встроенных блоков Mindbox самостоятельно.

В этой статье в качестве примера рассмотрим передачу контактов клиента и id подарка из игровой формы попапа.

Для настройки понадобится:

  • создать подключение для приема веб-хука в Albato.
  • настроить исходящий веб-хук из формы Mindbox.
  • создать связку с нужной внешней системой на стороне Albato.

Создать подключение для приема веб-хука

На странице подключений нажмите на кнопку «добавить подключение» и выберете "Вебхук".

Снимок экрана 2022-08-30 в 14.29.32.png

Снимок экрана 2022-08-30 в 15.22.49.png

Затем откройте детали подключения, кликнув по нему, и скопируйте URL веб-хука. Он понадобится на этапе настройки попапа.

Снимок экрана 2022-08-30 в 14.30.31.png

Настроить исходящий веб-хук из формы Mindbox

Перейдите в настройки нужной формы на проекте в Mindbox. В самом низу страницы есть выпадающий список дополнительных возможностей. Раскройте его и перейдите к настройкам "Webhook".

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

Снимок экрана 2022-08-30 в 16.01.32.png

Значения ключей дополнительных полей задаются произвольно: так поля будут называться в Albato.
Какие значения полей можно передавать из форм можно узнать в статье по ссылке.

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

Создать связку с нужной внешней системой на стороне Albato

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

Сделать это можно на странице подключения веб-хука таким образом, как на скриншотах.

Снимок экрана 2022-08-30 в 14.31.55.png

Снимок экрана 2022-08-30 в 14.33.21.png

После того, как кликните по кнопке "Ожидать веб-хук" в Albato, нужно открыть попап по тестовой ссылке в Mindbox и заполнить его.

Если веб-хук придет в Albato успешно, то вы сможете увидеть набор передаваемых полей в подключении, кликнув по кнопке "Поля веб-хука".

Снимок экрана 2022-08-30 в 14.50.48.png

Теперь при создании новой связки в Albato с шагом "Входящий веб-хук" возможно передавать поля из формы Mindbox в другую систему, которая будет использоваться следующим шагом в связке.

Снимок экрана 2022-08-30 в 20.06.48.png

Снимок экрана 2022-08-30 в 14.53.14.png

Что такое вебхуки и как они используются, где их можно настроить, примеры использования в Mindbox.