> 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="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FQpXlInvot8wLRik623bR%2Fimage.png?alt=media&amp;token=2039aedc-59f2-4825-83e4-8a27314f322d" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FuhN6Ft0YQSWtbVAXrPco%2Fimage.png?alt=media&amp;token=62af2795-e1d9-4212-9dd2-d519f2591a73" 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="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2F3JwOjIoAJEuI5xBhznPs%2Fimage.png?alt=media&amp;token=6029a7b4-4cf6-4719-9371-16f0f71e6c09" 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="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2Fk5Cy27BqP6AbKyuJLu0t%2Fimage.png?alt=media&amp;token=962ca65c-9cbe-4304-89df-bc4a771766f5" alt=""><figcaption></figcaption></figure>

***

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

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FOBz6OVcsdCB6BGhqZcLr%2Fimage.png?alt=media&amp;token=4f45b605-c8dd-4f82-9e2c-99e0180b2b0f" alt=""><figcaption></figcaption></figure>