> 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/whatsapp-by-phone.md).

# Номерной Whatsapp

## Создание/редактирование канала «Номерной WhatsApp».

Для подключения номерного WhatsApp при создании нового канала необходимо выбрать тип канала — «Номерной WhatsApp».

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

### Основные настройки

Основные настройки отображают название канала, чат-бот, тип разговора и опцию «Можно писать первым новому клиенту».

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

1. **Название канала**
2. **Чат-бот** — чат-бот, который будет подключён к каналу. Настраивается в разделе «Чат-боты».
3. **Тип разговора** — это тип канала, из которого обратился клиент, а именно: чат, соцсети, электронная почта или звонок.
4. **Можно писать первым новому клиенту** — функционал, необходимый для того, чтобы оператор мог первым написать клиенту, даже если он ещё не писал в данный канал.

***

### Настройки провайдера

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

1. **Провайдер** — провайдер, через которого осуществляется подключение номерного WhatsApp. Доступный провайдер — Nova.ChatsConnector.
2. **API URL** — URL-адрес, по которому выполняется запрос к провайдеру.

***

### Настройки обработки разговоров

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

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

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

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

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

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

***

### Агенты

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

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

***

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

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

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

***

### Добавление номеров телефонов в канал

После создания канала необходимо перейти в настройки редактирования канала, добавить конфигурацию номеров телефонов и выполнить их подключение.

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

{% hint style="info" %}
Для завершения интеграции предоставьте URL вебхука и номера телефонов, которые вы хотите подключить к каналу, команде поддержки NovaTalks.

**API-ключ** будет предоставлен командой поддержки.
{% endhint %}

1. **Провайдер** — провайдер, через которого осуществляется подключение номерного WhatsApp. Доступный провайдер — Nova.ChatsConnector.
2. **API URL** — URL-адрес, по которому выполняется запрос к провайдеру.
3. **URL вебхука** — URL вебхука, по которому осуществляется подключение канала.

В разделе «Номера телефонов» доступны два подраздела:

* Активные — отображается список активных номеров;
* Удалённые — отображается список удалённых номеров.

4. **Номер телефона** — номер телефона для подключения.
5. **API-ключ** — API-ключ номера для подключения к NovaTalks.

{% hint style="info" %}
Чтобы убедиться, что интеграция настроена успешно и ключ API введён верно, необходимо нажать кнопку «Проверить».
{% endhint %}

6. **Включить/Выключить** — кнопка, которая позволяет активировать или отключить интеграцию для указанного номера телефона.

Для добавления нового номера телефона необходимо выбрать «Добавить номер телефона».