# Настройка источника

## Создание источника

1. Откройте раздел **Речевая аналитика** → **Задачи** → вкладка **Источники**
2. Нажмите **Добавить источник**
3. Выберите тип источника
4. Выберите платформу
5. Заполните учётные данные
6. Нажмите **Подключить**

### Шаг 1: Тип источника

| Тип                    | Описание                              |
| ---------------------- | ------------------------------------- |
| **Голосовые звонки**   | Интеграция с АТС, контакт-центром     |
| **Чаты и мессенджеры** | WhatsApp, Telegram, support-платформы |

### Шаг 2: Платформа

После выбора типа отображается список доступных платформ (фильтруется по типу). Выберите нужную из выпадающего списка.

### Шаг 3: Учётные данные

Набор полей зависит от выбранной платформы:

<details>

<summary>Helpdeskeddy</summary>

| Поле         | Обязательное | Описание                  |
| ------------ | ------------ | ------------------------- |
| `entrypoint` | Да           | Домен (валидация формата) |
| `email`      | Да           | Email (валидация формата) |
| `api_key`    | Да           | API-ключ (скрытое поле)   |

</details>

<details>

<summary>Usedesk</summary>

| Поле        | Обязательное | Описание                 |
| ----------- | ------------ | ------------------------ |
| `api_token` | Да           | API-токен (скрытое поле) |

</details>

<details>

<summary>Chatwoot</summary>

| Поле        | Обязательное | Описание                 |
| ----------- | ------------ | ------------------------ |
| `base_url`  | Да           | URL API                  |
| `api_token` | Да           | API-токен (скрытое поле) |

</details>

<details>

<summary>Mango Office</summary>

| Поле            | Обязательное | Описание                |
| --------------- | ------------ | ----------------------- |
| `vpbx_api_key`  | Да           | API-ключ ВАТС           |
| `vpbx_api_salt` | Да           | API-соль (скрытое поле) |

</details>

<details>

<summary>Bitrix</summary>

| Поле          | Обязательное | Описание    |
| ------------- | ------------ | ----------- |
| `webhook_url` | Да           | URL вебхука |

</details>

<details>

<summary>Omnidesk</summary>

| Поле       | Обязательное | Описание                |
| ---------- | ------------ | ----------------------- |
| `base_url` | Да           | URL API                 |
| `api_key`  | Да           | API-ключ (скрытое поле) |

</details>

<details>

<summary>LiveChat, Jivochat</summary>

| Поле        | Обязательное | Описание                 |
| ----------- | ------------ | ------------------------ |
| `api_token` | Да           | API-токен (скрытое поле) |

</details>

Для всех платформ также доступно поле **Ограничение частоты запросов** (запросов в секунду, по умолчанию 5). Чем выше значение — тем быстрее загружаются диалоги, но тем больше нагрузка на API внешней системы. Если источник начинает отвечать ошибками или замедляться, уменьшите значение.

## Редактирование

При редактировании существующего источника:

* Учётные данные **нельзя изменить** (отображаются как замаскированные)
* Можно изменить только **ограничение частоты запросов**

## Удаление

При удалении источника связанные задачи сбора и собранные данные сохраняются.