> For the complete documentation index, see [llms.txt](https://help.novatalks.com.ua/ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.novatalks.com.ua/ua/get-started/settings/inboxes/api.md).

# API канал

## Створення/Редагування каналу API <a href="#create-edit-an-api-channel" id="create-edit-an-api-channel"></a>

Для підключення API-каналу в NovaTalks при створенні нового Каналу необхідно обрати тип каналу - **API**.

<figure><img src="/files/cfZKDJ5EZHIAiTFE5dhS" alt=""><figcaption></figcaption></figure>

### Основні налаштування <a href="#main-settings" id="main-settings"></a>

**Основні налаштування** відображають Назву каналу, Чат-бот, Webhook URL, Тип розмови та опцію Писати першим новому  клієнту.

<figure><img src="/files/pObvTYKnBxUPCoojZaV6" alt=""><figcaption></figcaption></figure>

1. **Назва каналу**
2. **Чат-бот** - чат-бот, який буде підключено до каналу. Налаштовується в розділі [Чат-боти](/ua/get-started/settings/chatbots.md).
3. **URL вебхука** - URL вебхука, по якому здійснюється підключення месенджерів.
4. **Тип розмови** - це тип каналу, з якого звернувся клієнт, а саме - Чат, Соцмережі, Електронна пошта або Дзвінок.
5. **Можна писати першим новому клієнту** - функціонал необхідний для того, щоб оператор міг першим написати клієнту, навіть якщо він ще не писав в даний канал.&#x20;
6. **Канал, з якого можна писати першим новому клієнту -** опція вибору каналу, з якого можна писати першим.&#x20;

{% hint style="warning" %}
Писати першим новому клієнту можна з месенджерів Whatsapp,  Whatsapp Business API та Telegram. До 1-го каналу може бути підключений тільки 1 месенджер.&#x20;
{% endhint %}

***

### Налаштування обробки розмов <a href="#configure-conversation-handling" id="configure-conversation-handling"></a>

<figure><img src="/files/xetoSbsH7DUInvMQS4dO" alt=""><figcaption></figcaption></figure>

1. **Утилізація, %** - показник, який показує на скільки % певний діалог утилізує агента. Можливі значення: 0 – 100.

{% hint style="success" %}
В залежності від значення даного параметру розраховується поточна утилізація агента (сума утилізацій діалогів, призначених на даного агента). При автоматичному розподілі діалогів утилізація агента не повинна перевищувати 100%.

Тому чим нижче значення утилізації діалога, призначеного на команду, тим більше діалогів може бути автоматично розподілено на агента і навпаки.
{% endhint %}

2. **Ліміт автопризначення** - максимальна кількість розмов, які агент може одночасно обслуговувати в рамках даного Каналу. Якщо по агенту такий показник досяг встановленого значення, то ACD більше не призначить подібний діалог на такого агента.
3. **Автовідповідь -** чи потрібно автоматично прийняти діалог при призначенні на агента.
4. **Таймаут сповіщення** - час, протягом якого агенту необхідно прийняти або відхилити Розмову. Якщо агент не відреагує протягом заданого часу, то розмова повернеться на початок черги, а агент перейде в статус Зайнятий сабстатус Not responding.

Вибір параметру доступний тільки якщо опція Автовідповідь виключена.

1. **Коди завершення** - коди, які використовуються для класифікації діалогів. Обираються агентом після завершення розмови.
2. **Таймаут Кодів завершення** - час, протягом якого необхідно обрати Код завершення. Якщо агент не відреагує протягом заданого часу, то розмова завершиться і Код завершення не буде встановлено.

***

### Агенти <a href="#agents" id="agents"></a>

Список агентів, які включені в канал.

<figure><img src="/files/EyhhqKYPse9hCxy1LBr0" alt=""><figcaption></figcaption></figure>

***

### Перегляд та створення каналу <a href="#review-and-create-inbox" id="review-and-create-inbox"></a>

Крок для перегляду налаштувань нового каналу та підтвердження його створення.

<figure><img src="/files/mkLTvwyNV5qvFXsZZzFh" alt=""><figcaption></figcaption></figure>