Интеграция
Получение заявок из matomba.ru → Создание клиента в maxma.com
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Настройка приёма заявок из matomba.ru: HTTP-источник с URL вебхука, интеграция «Вебхук» в редакторе проекта и сохранение проекта.
- Создание клиента в maxma.com через HTTP POST JSON на /new-client: заголовок X-Processing-Key и поля карточки клиента по документации сервиса лояльности.
Отдельные инструкции: источник «Получение заявок из matomba.ru» · действие «Создание клиента в maxma.com»
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «matomba.ru» и нажмите кнопку «Выбрать».
Источник «matomba.ru»
Заявки из квизов matomba.ru начнут приходить на URL HTTP-источника. Создайте HTTP-источник, скопируйте URL и добавьте вебхук в интеграциях проекта.
Выбор типа источника
- Отметьте «HTTP» и нажмите «Выбрать».
URL приёма
- Не меняя параметры, нажмите «Сохранить».
- Откройте вкладку «Источник данных» и скопируйте «URL».
Webhook в matomba.ru
- В «Квизы» откройте «Редактор» выбранного квиза.
- Нажмите «Редактор проекта».
- В «Интеграции» нажмите «Выбрать интеграцию».
- Выберите «Вебхук - передача заявок в JSON по любой ссылке».
- Вставьте скопированный «URL» и нажмите «Добавить вебхук».
- Нажмите «Сохранить проект».
Тестирование источника
Для отправки тестовой заявки нажмите на значок конверта.
В открывшемся окне нажмите "Подтвердить".
Действие «Создание клиента в maxma.com»
maxma.com регистрирует клиентов через API new-client. Передайте X-Processing-Key и JSON с полями карточки клиента.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
X-Processing-Key
- В кабинете maxma.com скопируйте X-Processing-Key.
Параметры запроса
Действие настраивается через «HTTP-запрос».
- Выберите «HTTP-запрос» и нажмите «Выбрать».
- В поле «HTTP-метод» выберите
POST. - В поле «Адрес» укажите
https://api.maxma.com/new-client. - В «Заголовки» добавьте
X-Processing-KeyиContent-Type: application/json. - В поле «Тело» через «Компоновщик JSON» передайте поля клиента.
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».