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

Интеграция

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

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

  1. Приём событий из Клиентикс CRM через HTTP webhook: URL в clientix/admin/eventHandlers, настройка обработчика событий в админке CRM для выбранного типа события.
  2. Настройка создания заказа в RetailCRM через HTTP: домен аккаунта, ключ API и JSON с именем, телефоном и другими полями заказа из сценария.

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

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

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

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. Сохраните обработчик событий.

Действие «RetailCRM»

В RetailCRM создаётся заказ через HTTP-запрос к API. Укажите домен аккаунта, ключ API и JSON с именем и телефоном клиента.

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

Ключ API

  1. В RetailCRM откройте раздел «Интеграция».
  2. Перейдите во вкладку «Ключи доступа к API» и скопируйте ключ.

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

Действие настраивается через «HTTP-запрос». Список полей заказа есть в документации API v5.

  1. Выберите «HTTP-запрос» и нажмите «Выбрать».
    Создание заказа в RetailCRM: Выберите «HTTP-запрос» и нажмите «Выбрать»
  2. В поле «HTTP-метод» выберите POST.
  3. В поле «Адрес» укажите https://ваш-домен.retailcrm.ru/api/v5/orders/create.
  4. В блоке «Параметры» добавьте apiKey со значением ключа API.
  5. В «Заголовки» добавьте Content-Type со значением application/json.
  6. В поле «Тело» нажмите «Фн», выберите «Компоновщик JSON» и передайте как минимум firstName и phone.
    Создание заказа в RetailCRM: В поле «Тело» нажмите «Фн», выберите «Компоновщик JSON» и передайте как минимум firstName и phone
  7. Нажмите «Сохранить».

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

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

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