> For the complete documentation index, see [llms.txt](https://help.novatalks.com.ua/ru/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/ru/get-started/settings/inboxes/api.md).

# API канал

## &#x20;Создание/Редактирование канала API <a href="#create-edit-an-api-channel" id="create-edit-an-api-channel"></a>

Для подключения API-канала в NovaTalks при создании нового Канала необходимо выбрать тип канала - API.

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

### Основные настройки <a href="#main-settings" id="main-settings"></a>

**Основные настройки** отображают Название канала, Чат-бот, Webhook URL, Тип разговора и опцию Писать первым новому клиенту.

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

1. **Название канала**&#x20;
2. **Чат-бот** - чат-бот, который будет подключен к каналу. Настраивается в разделе Чат-боты. URL вебхука - URL вебхука, по которому осуществляется подключение мессенджеров.&#x20;
3. **Тип разговора** - это тип канала, с которого обратился клиент, а именно - Чат, Соцсети, Электронная почта или Звонок.&#x20;
4. Можно писать первым новому клиенту - функционал необходим для того, чтобы оператор мог первым написать клиенту, даже если он еще не писал в данный канал.&#x20;
5. **Канал, с которого можно писать первым новому клиенту** - опция выбора канала, с которого можно писать первым.

{% hint style="warning" %}
Писать первым новому клиенту можно с мессенджеров Whatsapp, Whatsapp Business API и Telegram. К 1-му каналу может быть подключен только 1 мессенджер.
{% endhint %}

***

### Настройки обработки разговоров <a href="#configure-conversation-handling" id="configure-conversation-handling"></a>

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

1. **Утилизация, %** - показатель, который показывает на сколько % определенный диалог утилизирует агента. Возможные значения: 0 - 100.

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

Поэтому чем ниже значение утилизации диалога, назначенного на команду, тем больше диалогов может быть автоматически распределено на агента и наоборот.
{% endhint %}

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

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

1. **Коды завершения** - коды, которые используются для классификации диалогов. Выбираются агентом после завершения разговора.&#x20;
2. **Таймаут Кодов завершения** - время, в течение которого необходимо выбрать Код завершения. Если агент не отреагирует в течение заданного времени, то разговор завершится и Код завершения не будет установлен.

***

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

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

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

***

### Просмотр и создание канала&#x20;

Шаг для просмотра настроек нового канала и подтверждения его создания.

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