Интеграции

Общее

Swagger: https://api.radist.online/v2/docs#/Integrations

Необходимые права доступа (scopes) для работы с API: integrations

Интеграция/integration - сущность, содержащая параметры для соединения одного внешнего сервиса с другим (tinkoff+amoCRM, whatsapp+bitrix24, ...)

Замечания

• Создание доступно только для интеграции с типом API. Другие интеграции создаются при установке в CRM-системе.

• Удаление доступно только для интеграции с типом API. Для удаления других интеграций обратитесь в поддержку.

Примеры

Изменение настроек интеграции amoCRM+чаты на примере whatsapp_amocrm:

Метод для изменения настроек: https://api.radist.online/v2/docs#/Integrations/IntegrationsUpdateItem

Пример запроса

{
  "name": "radist test", -- название можно изменить
  "status": "enabled", -- disabled, чтобы отключить интеграцию
  "type": "whatsapp_amocrm", -- тип должен совпадать с тем, что уже есть
  "whatsapp_amocrm": [  -- список с настройками подключений
    {
      "id": 15934, -- id подключения (в данном случае whatsapp)
      "pipeline_id": 5653852,  -- id воронки, в которой будут создаваться сделки
      "status_id": 49782925  -- id статуса, в котором будут создаваться сделки
    }
  ],
  "write_first_conn": 15934,  -- номер по умолчанию (боты будут начинать чат с него)
  "check_phones_enabled": false  -- включить/выключить индикатор наличия WhatsApp'а в  интерфейсе CRM
}

Чтобы убрать подключение из интеграции, достаточно не передавать его в списке подключений. Чтобы убрать все подключения из интеграции, нужно передать пустой список.

Если не передавать pipeline_id/status_id, то сделки будут создваться в неразобранном. Список воронок можно получить тут: https://api.radist.online/v2/docs#/AmoCRM/AmoCRMGetAmoPipelinesFromIntegration

Изменение настроек интеграции Битрикс24+чаты на примере waba_bitrix

Метод для изменения настроек: https://api.radist.online/v2/docs#/Integrations/IntegrationsUpdateItem

Пример запроса

{
  "name": "integration name",
  "status": "enabled",
  "type": "waba_bitrix",
  "waba_bitrix": [
    {
      "id": 16549,  -- id подключения (в данном случае waba)
      "open_line_id": 1  -- id открытой линии
    }
  ]
}

Список открытых линий можно получить тут: https://api.radist.online/v2/docs#/Bitrix/BitrixGetBitrixListOfOpenLinesFromIntegration