В данной статье рассмотрим пример интеграции Marquiz и Битрикс24
Задача:
- При прохождении квиза пользователем, создать сделку в Битрикс24
- Проверить контакт на дубль, если контакт новый — создать его
- Создать сделку к контакту
- Прикрепить к сделке комментарий с вопросами и ответами
Подключение Битрикс24
Перед добавлением сервиса Битрикс24 в MoreKit необходимо установить приложение наше приложение в маркетплейсе. Для установки приложения требуется подписка на маркетплейс Битрикс24
После установки приложения MoreKit в маркетплейс Битрикс24 можно приступать к добавлению сервиса в Morekit. Для этого в проекте нажмите Добавить сервис, найдите в списке Битрикс24. При подключении сервиса будет запрошена ссылка на ваш битрикс
Введите ссылку в формате https://мой-домен.bitrix24.ru. После этого произойдет редирект на страницу с вашим битриксом, подтвердите авторизацию
Если все правильно — сервис появится в списке сервисов и у него будет статус Готово
Подключение Marquiz
Для подключения Marquiz нажимаем Добавить сервис, в поиске ищем Marquiz
Даем сервису название и нажимаем Добавить
Создание процесса в MoreKIT
Следующим шагом — необходимо создать новый процесс в MoreKIT и получить ссылку для установки webhook. В MoreKIT можно воспользоваться готовым шаблоном процесса, либо создать процесс с нуля
Создание процесса из шаблона
Нажмите на Создать процесс —> Готовые шаблоны, найдите шаблон Marquiz —> Битрикс24
Затем нажмите на кнопку Далее
Сопоставьте сервисы. Это нужно на случай, если в MoreKIT у вас подключено несколько сервисов Битрикс24 или Marquiz
Далее нажмите Создать. У вас создастся уже готовый процесс с настроенными блоками
Важный момент: данный процесс хоть и является универсальным, но все же в нем необходимо минимальное количество правок, например — выбрать свою воронку и стадия в блоке Создать сделку
Ручное создание процесса
Если вы хотите создать процесс с нуля и выстроить нужную логику передачи самостоятельно:
Нажмите на Создать процесс —> в списке доступных сервисов выберите Marquiz
Дайте процессу название
Процесс успешно создан, теперь необходимо перейти в процесс и скопировать ссылку для установки веб-хука из первого блока
Установка webhook в Marquiz
Для установки webhook необходимо перейти в раздел Редактировать в нужном квизе
Затем в раздел Интеграции, в нем ищем Webhook в разделе Другое
Вставляем скопированную ссылку на процесс MoreKIT и нажимаем Готово
Подключение выполнено. Теперь нужно пройти квиз и проверить, что данные с квиза придут на процесс
Проверка отправки данных из Marquiz
Пройдем квиз и проверим, что пришли данные
Для того, чтобы увидеть, пришли данные на процесс или нет, необходимо перейти во вкладку События в процессе MoreKIT
Переходим в события
Как видим — событие пришло, если развернуть Входящие данные, увидим данные, котоыре нам отправил Marquiz. Теперь эти данные необходимо передать в Bitrix24
Далее — необходимо выстроить нужную схему передачи данных в Битрикс24. В данном примере будет использована схема из готового шаблона, которая закрывает изначальную задачу
Тестирование процесса
Чтобы проверить процесс, можно либо пройти квиз заново, либо повторить уже ранее пришедшее событие в MoreKIT
Осуществлять проверку будем через повтор события. Во окне событий нажмите на значок повтора, событие отработает на текущую схему, которая у вас сохранена
После нажатия на повтор события — иконка повтора исчезнет, нажимайте на синюю кнопку Обновить, новое событие появится сверху
Как видим — появилось новое событие и все блоки выполнились успешно. Если нажать на серые цифры напротив блоков, то произойдет переход в сущность
Перейдем в сделку и посмотрим результат
Как видим — комментарий с ответами создался, контакт прикрепился
Итоги
В данной статье рассмотрели пример интеграции Marquiz и Битрикс24 через готовые шаблоны в MoreKIT. Был создан контакт, найдена сделка и прикреплены ответы на вопросы