> For the complete documentation index, see [llms.txt](https://docs.intellectdialog.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellectdialog.com/instrumenty/instrument-audio-rassylki.md).

# Инструмент Аудио рассылки

Аудио рассылки — инструмент для автоматических голосовых звонков клиентам. При дозвоне клиенту проигрывается аудиозапись; если он нажимает нужную клавишу — происходит переадресация и фиксируется конверсия.

***

### 1. Создание приложения Exolve

Зайдите в личный кабинет Exolve: <https://dev.exolve.ru/> → раздел **API**.

На главном экране нажмите **«Создать приложение»**:

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

Заполните поле **«Название»** (поле «Описание» — по желанию) и нажмите **«Создать приложение»**:

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

После создания откроется страница приложения. Выполните два действия:

1. Скопируйте **ApplicationId** (позиция 1 на скриншоте).
2. В левом меню перейдите в **«Ключи»** и скопируйте **Api-Key**.

Эти данные понадобятся при создании провайдера в IntellectDialog.

<figure><img src="/files/7QsPYb0XOxHTHpLhB0aI" alt=""><figcaption></figcaption></figure>

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

Перейдите в левом меню в **Настройки** и включите **«Управление записями разговоров»**:

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

Там же включите **«Детектирование автоответчика»**:

<figure><img src="/files/9qPuneHzigE0kTN6OYhz" alt=""><figcaption></figcaption></figure>

***

### 2. Покупка номеров в приложении Exolve

В левом меню перейдите в раздел **«Номера»** и приобретите нужное количество номеров.

{% hint style="info" %}
&#x20;**Важно:** необходимо купить **не менее двух номеров**: один — для совершения звонков, один — технический (для переадресации при нажатии клавиши).
{% endhint %}

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

В настройках **каждого** купленного номера подключите:

* «Хранение записей разговора»
* «Детектирование автоответчика»

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

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

{% hint style="info" %}
**Важно:** при докупке новых номеров в дальнейшем — эти две опции нужно включать вручную. Если номера покупаются через ЛК IntellectDialog — они подключатся автоматически.
{% endhint %}

Уже купленные номера отображаются в разделе **«Все номера»** (вкладка «Обзор»):

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

***

### 3. Создание провайдера в IntellectDialog

Создайте новый провайдер с типом **«Аудио рассылки»**. Укажите:

* Название провайдера
* ApplicationId (из п. 1)
* Api-Key (из п. 1)

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

***

### 4. Создание и настройка аудио сценариев

#### 4.1. Создание сценария

В созданном провайдере перейдите: **Аудио сценарии** → **Добавить**.

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

Выберите провайдер, введите название сценария и нажмите **«Сохранить»**:

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

#### 4.2. Настройка сценария

После создания сценарий откроется для редактирования (или нажмите **«Редактировать сценарий»** в списке):

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

**Обязательные поля** (отмечены красным на скриншоте):

| Поле                          | Описание                                              |
| ----------------------------- | ----------------------------------------------------- |
| Название                      | Название сценария                                     |
| Запуск при установке тега     | Тег, при назначении которого запустится сценарий      |
| Номера для совершения звонков | Номер 1 — для дозвона клиенту                         |
| Аудио при дозвоне             | Запись, которая проигрывается клиенту при соединении  |
| Нажатая клавиша               | Клавиша, при нажатии которой происходит переадресация |
| Номер редиректа               | Номер 2 — технический, для переадресации              |
| Аудио при редиректе           | Запись, которая проигрывается после переадресации     |

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

#### 4.3. Пояснения к полям

**Теги запуска**

Сценарий запускается для клиента только при назначении указанного тега. Если тег уже установлен — запуска не будет. Можно ввести несколько тегов, подтверждая каждый нажатием **Enter**.

**Номера для звонков**

Клиент получит звонок с одного из номеров, отмеченных как «номера для дозвона». Нужно включить хотя бы один. Один номер должен оставаться неотмеченным — он используется как **номер редиректа**.

{% hint style="info" %}
**Важно:** если на провайдере несколько сценариев — у каждого должен быть **свой уникальный номер редиректа**, который не используется для звонков. Номера для звонков могут совпадать в разных сценариях.
{% endhint %}

**Аудиозаписи**

При соединении клиенту проигрывается первая запись (при дозвоне). Если клиент нажмёт нужную клавишу — он будет переадресован и услышит вторую (при редиректе). В этот момент фиксируется конверсия.

{% hint style="info" %}
**Важно:** в первом аудио обязательно чётко скажите, **какую клавишу нажать**. Желательно упомянуть это в начале или несколько раз, чтобы клиент успел среагировать.
{% endhint %}

**Загрузка аудио**

Аудиозаписи загружаются через кнопку **«Загрузить новое аудио»**. Если готовых записей нет — можно синтезировать речь из текста: вкладка **«Синтезированные аудио»** → **«Создать новое аудио из текста»**.

**Необязательные поля:**

* **Описание сценария**
* **Теги-исключения** — если на персоне есть такой тег, сценарий не запустится. Несколько тегов вводятся через Enter.

#### 4.4. Конверсия и теги

Чтобы автоматически устанавливать тег на персону при конверсии — создайте связку с данным провайдером (не сценарием) и настройте правило **«В случае конверсии установить тег»**.

#### 4.5. Прослушивание записей звонков

Перейдите на портал <https://dev.exolve.ru/> → **Статистика** → **Звонки**. Нажмите на ID нужного звонка:

<figure><img src="/files/2MT8ZT8GOIBBpEUt9d2l" alt=""><figcaption></figcaption></figure>

Откроется детальное меню звонка — нажмите кнопку воспроизведения записи:

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

***

### 5. Покупка и управление номерами из IntellectDialog

#### 5.1. Покупка номеров

Перейдите в **Провайдеры** → нужный провайдер → нажмите **«Купить номера»**:

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

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

В форме покупки выберите:

* Тип номера
* Регион
* Категорию
* Желаемую последовательность цифр *(опционально)*

{% hint style="info" %}
Для номеров типа **«Федеральный»** выбирайте регион **«Россия»**. Категория — это «красивые номера» (стоят дороже). Для поиска золотых федеральных номеров выбирайте **«Золотой (Федеральный)»**.
{% endhint %}

Нажмите **«Поиск номеров»** — отобразится список из 20 номеров. При повторном нажатии список обновится. Для покупки нажмите соответствующую кнопку:

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

#### 5.2. Удаление номеров

Чтобы удалить номер из провайдера, нажмите кнопку удаления на странице провайдера:

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

{% hint style="info" %}
**Важно:** удалить можно только номер, который **не используется как номер редиректа** ни в одном сценарии. Чтобы удалить номер редиректа — сначала назначьте другой номер в настройках сценария.
{% endhint %}