Получение событий из Клиентикс CRM Создание клиента в maxma.com

Интеграция

Получение событий из Клиентикс CRM Создание клиента в maxma.com

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

  1. Приём событий из Клиентикс CRM через HTTP webhook: URL в clientix/admin/eventHandlers, настройка обработчика событий в админке CRM для выбранного типа события.
  2. Создание клиента в maxma.com через HTTP POST JSON на /new-client: заголовок X-Processing-Key и поля карточки клиента по документации сервиса лояльности.

Отдельные инструкции: источник «Получение событий из Клиентикс CRM» · действие «Создание клиента в maxma.com»

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

В списке типов источника выберите «klientiks.ru» и нажмите кнопку «Выбрать».

Источник «klientiks.ru»

Клиентикс CRM отправляет события на webhook URL. Создайте обработчик в eventHandlers и укажите URL источника.

URL вебхука

  1. Выберите нужный тип источника и нажмите «Выбрать».
  2. Нажмите «Сохранить».
  3. Скопируйте «URL» целиком - адрес уже содержит параметры приёма данных.

Обработчик в Клиентикс

  1. В Клиентикс CRM откройте https://klientiks.ru/clientix/admin/eventHandlers.
  2. Создайте или отредактируйте обработчик нужного события.
  3. Вставьте скопированный URL источника.
  4. Сохраните обработчик событий.

Действие «Создание клиента в maxma.com»

maxma.com регистрирует клиентов через API new-client. Передайте X-Processing-Key и JSON с полями карточки клиента.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

X-Processing-Key

  1. В кабинете maxma.com скопируйте X-Processing-Key.

Параметры запроса

Действие настраивается через «HTTP-запрос».

  1. Выберите «HTTP-запрос» и нажмите «Выбрать».
    Выберите «HTTP-запрос» и нажмите «Выбрать»
  2. В поле «HTTP-метод» выберите POST.
  3. В поле «Адрес» укажите https://api.maxma.com/new-client.
  4. В «Заголовки» добавьте X-Processing-Key и Content-Type: application/json.
  5. В поле «Тело» через «Компоновщик JSON» передайте поля клиента.
  6. Нажмите «Сохранить».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»