Настройка передачи данных в Mindbox из другого сервиса через Albato
Задача: настроить передачу данных из другой системы в Майндбокс без привлечения разработки.
Для подключения понадобится аккаунт в Albato.
Почему настраиваем подключение через Albato? Albato дает возможность быстро создать связку между сервисами без привлечения ресурса разработки, так как позволяет доставать нужные данные из запросов и отправлять их в Mindbox.
В этой статье рассмотрим настройку на примере кейса: по завершении чата Jivo на сайте передавать контакты клиентов в Майндбокс и подписывать на рассылки. Стандартной интеграции между Mindbox и JivoSite нет.
Для создания связки понадобится:
- Завести операцию в Mindbox
- Создать связку в Albato
Операция в Mindbox
На стороне Майндбокс понадобится создать операцию с такими настройками:
Подробнее о создании операции в этой статье.
Обратите внимание на то, что для вызова операции можно выбрать уже существующую точку интеграции с сайтом или создать и использовать новую для большей безопасности.
Подробнее о том, как создать точку интеграции можно прочитать в этой статье.
Связка в Albato
На стороне Альбато перед созданием связки нужно будет добавить два подключения.
Подключение JivoSite
Добавить новое подключение с JivoSite можно таким образом на странице "Подключения".
Подробнее о том, как подключить JivoSite к Albato можно прочитать по ссылке.
Подключение через Http-запрос к Mindbox
Нужно настроить еще одно подключение.
Настройки подключения на стороне Albato будут выглядеть так:
Для того, чтобы правильно настроить запрос в Albato, нужно посмотреть описание созданной в Mindbox операции.
Если ваша операция в Mindbox называется так "JivoSiteSubscription", то URL запроса будет таким:
https://api.mindbox.ru/v3/operations/async?endpointId={Идентификатор точки интеграции}&operation=JivoSiteSubscription
Параметры http-запроса для того, чтобы передать полное имя, email, телефон и подписать клиента на рассылки в двух каналах:
customer.fullName
customer.email
customer.mobilePhone
customer.subscriptions.0.pointOfContact
customer.subscriptions.1.pointOfContact
Нужно также указать заголовок для передачи секретного ключа:
Authorization
Для Content-type следует выбрать формат Json.
Подробнее о настройке произвольного Http-запроса на стороне Albato можно прочитать по ссылке.
Создание связки
Далее перейдите на страницу "Мои связки" и создайте новую связку с такими шагами:
Первым шагом следует выбрать событие "JivoSite: Завершение чата".
Второй шаг - Http-запрос к Mindbox. В этом шаге нужно настроить соответствие полей таким образом.
В полях pointOfContact нужно прописать системные имена тех каналов, на которые хотим подписать в Майндбокс. В данном случае это Email и SMS.
В заголовке Authorization вместо {cекретный ключ точки интеграции Майндбокс} нужно ввести ключ в таком формате:
Mindbox secretKey="секретный ключ"
После того, как сохраните настройки второго шага, запустите связку в работу. Если все настроено корректно, то после завершения чата на сайте для вашего тестового клиента, вы сможете найти его в Майндбокс.
Также проверить, что связка работает, можно в журнале связки на стороне Albato.
На примере этой статьи можно настроить интеграцию с любым другим сервисом с Mindbox, настроив связку в Albato с произвольным http-запросом.