Получение заявок из bothelp.io Создание заказа в RetailCRM

Интеграция

Получение заявок из bothelp.io Создание заказа в RetailCRM

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

  1. Настройка приёма данных из bothelp.io: HTTP-источник с URL вебхука, действие «Отправить данные подписчика через Webhook» в боте.
  2. Настройка создания заказа в RetailCRM через HTTP: домен аккаунта, ключ API и JSON с именем, телефоном и другими полями заказа из сценария.

Отдельные инструкции: источник «Получение заявок из bothelp.io» · действие «Создание заказа в RetailCRM»

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

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

processing-01.png

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

Источник «bothelp.io»

Данные подписчика из bothelp.io начнут приходить на URL HTTP-источника. скопируйте URL и добавьте действие webhook в сценарии бота.

URL приёма

  1. Не меняя параметры, нажмите «Сохранить».
    https-source-2 (2).png
  2. Откройте вкладку «Источник данных» и скопируйте «URL».
    http-source-3.png

Webhook в bothelp.io

  1. В разделе «Боты» выберите бота и нажмите «Редактировать».
    1.jpg
  2. Нажмите «+» и выберите «Действие».
    2.jpg
  3. Нажмите «Добавить действие».
    3.jpg
  4. Выберите «Отправить данные подписчика через Webhook».
    4.jpg
  5. Вставьте скопированный «URL» и нажмите «Сохранить и закрыть».
    5.jpg

Действие «RetailCRM»

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

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
wj2-action-create-01.png

Ключ API

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

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

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

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

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

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

vk-ads-02.png