Интеграция квиза с enKod

Данная интеграция понадобится вам в том случае, если вы хотите передавать информацию о новых заявках в CDP-платформу enKod. Там вы можете настраивать автоворонки, автоматические рассылки и другие активности в момент передачи заявки.
Важный момент — данная интеграция сделана в связке с сервисом Albato. Для настройки передачи данных у вас должна быть активная подписка и в Albato, и в Madtest, и в enKod.

Для настройки подключения к Albato вам потребуется Access Token из enKod. Чтобы его получить — заходим в раздел Настройки, там пункт API.

Нажимаем кнопку «Создать ключ». Появится модальное окно, в котором нужно указать понятное название, для чего предназначен данный ключ. Даем все разрешения и нажимаем кнопку «Создать».

Новый ключ добавится в список API-ключей. Скопируйте его — дальше он понадобится нам для подключения сервиса к Albato.

Теперь заходим в личный кабинет Albato. Заходим в раздел «Подключения» и нажимаем кнопку добавления нового подключения.

Откроется модальное окно. В поисковой строке находим сервис enKod, выбираем его и нажимаем кнопку «Добавить подключение».

Задаем понятное название для подключения, а также вводим Access Token, ранее созданный в enKod. Нажимаем кнопку «Далее».

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

После нажатия на кнопку нового подключения — снова появится модальное окно. В поиске вводим webhook или вебхук. Выбираем пункт и нажимаем кнопку «Добавить подключение».

Вводим только понятное название для подключения, поля параметров и заголовков пропускаем. Нажимаем кнопку «Далее».

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

ПЕереходим в личный кабинет Madtest. Выбираем нужный нам квиз и переходим в редактирование. Там выбираем вкладку «Настройки и интеграции», ищем пункт Webhook. Как найдем — сначала активируем, а затем нажимаем иконку «шестеренки».

Появится модальное окно, в котором нужно вставить адрес вебхука из Albato. После ввода не забываем нажать кнопку «Сохранить».

Возвращаемся в Albato на страницу созданного подключения нового вебхука. Прокручиваем страницу в самый низ и нажимаем кнопку «Поймать вебхук».

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

Отлично, подключение настроено и готово к работе. Далее — настройка связки для отправки заявкок в enKod.

Перейдите в раздел «Мои связки» и нажимаем кнопку добавления новой связки. После этого мы перейдем на страницу создания, рекомендуем сразу переключиться в Pro-режим, так как инструкция описана на нем.

Кликаем на блок добавления, появляется модальное окно.
В поле выбора сервиса выбираем Вебхук.
В поле выбора события — Входящий вебхук.
В поле выбора аккаунта — ранее настроенное подключение для Вебхука.

Готово, событие настроено.

Кликаем на блок добавления, появляется модальное окно.
В поле выбора сервиса выбираем — enKod.
В поле выбора действия — Добавление/обновление единственной персоны.
В поле выбора аккаунта — ранее настроенное подключение для enKod.
Нажимаем кнопку «Продолжить».

После этого вы попадете на экран «мэтчинга» полей, чтобы данные из Madtest записывались в нужные поля карточки пользователя в enKod.
Чтобы сделать «мэтч» — найдите в списке нужное название поля, откройте его, введите в поиске значение email и выберите подходящее значение из вебхука Madtest.

Пройдитесь по всем базовым полям, а также обязательно задайте значение для поля «Метод добавления и обновления пользователя». Мы рекомендуем выбирать метод «Новые контакты будут добавлены, существующие - обновлены».

Если у вас есть дополнительные поля данных в enKod, которые вы также хотели бы обогащать данными из Madtest — сначала создайте поля в enKod, затем отфильтруйте форму по ним и сделайте мэтч с нужными полями из вебхука.
После этого сохраняем форму.

Почти готово! Нажмите на кнопку «Запустить». Покажется модальное окно, что связка запущена и можно проверить результат. Переходим по кнопке проверки.

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

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

Готово! Теперь все собранные заявки будут передаваться в enKod и далее вы можете запускать по ним автоворонки, рассылки и другие маркетинговые активности.

Примеры событий, которые умеем передавать:
madtest-view — пользователь просмотрел тест.
madtest-start — пользователь начал прохождение (доступно только в том случае, если вы не отключили отображение обложки теста).
madtest-stepN — пользователь прошел вопрос N (где N — порядковый номер вопроса. Например, madtest-step4 обозначает, что пользователь прошел четвертый вопрос теста).
madtest-resultN — пользователь дошел до результата N (где N — порядковый номер результата. Например, madtest-result1 обозначает, что пользователь дошел до первого результата (сохраняется такой же порядок, который отображается в админ-панели Madtest)).
madtest-form-submit — пользователь заполнил форму контактов