# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.novatalks.com.ua/ua/get-started/settings/inboxes/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.