# Интеграции

## Общее

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>

{% code title="Пример запроса" %}

```json
{
  "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
}
```

{% endcode %}

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

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

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

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

{% code title="Пример запроса" %}

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

{% endcode %}

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