# Базовый пример IVR

## Постановка задачи <a href="#postanovka_zadachi" id="postanovka_zadachi"></a>

Клиент звонит в компанию, звучит приветственное сообщение (голосовое приветствие).

Во время проигрывания голосового приветствия клиент может набрать любой внутренний номер, например, добавочный номер сотрудника.

Также клиент может ввести с телефона цифры:

* **1** - вызов в этом случае направится на сотрудника с внутренним номером 201.
* **2** - вызов направится на сотрудника с внутренним номером 202.

Если клиент ничего не ввел / некорректно набрал номер, то происходит переадресация на **номер по умолчанию** - сотрудника с внутренним номером 201.

Схематично задачу можно представить следующим образом:

<figure><img src="/files/FoFiXexqs5sXx9R0v3WT" alt=""><figcaption><p>Схема поставленной задачи</p></figcaption></figure>

## Решение <a href="#reshenie" id="reshenie"></a>

1\. Создаем **учетные записи сотрудников** по [инструкции](/mikopbx/manual/telephony/extensions.md). Подключаем программные или аппаратные телефоны к данным учетным записям.

<figure><img src="/files/HuNYVnGUi1lS5v3SEdUN" alt=""><figcaption><p>Сотрудники</p></figcaption></figure>

2. Добавляем **звуковой файл** приветствия по [инструкции](/mikopbx/manual/telephony/sound-files.md), который будет слышать клиент при звонке на номер компании.

<figure><img src="/files/r3Zs745vdtSqdCp5kpDt" alt=""><figcaption><p>Меню "Звуковые файлы"</p></figcaption></figure>

3. Добавляем новое **IVR-меню** по [инструкции](/mikopbx/manual/telephony/ivr-menu.md).

<figure><img src="/files/8jDrMMbh5fSZZqXpL6Wl" alt=""><figcaption><p>IVR меню</p></figcaption></figure>

При звонке на голосовое меню (**Номер IVR меню**) начинает проигрываться звуковой файл «**Голосовое приветствие**».

**Во время проигрывания голосового меню** можно набрать:

* любой внутренний номер, например, добавочный номер сотрудника. За эту возможность отвечает флаг **Разрешить донабор любого внутреннего номера**.
* цифру 1 - вызов направится на сотрудника с внутренним номером 201
* цифру 2 - вызов направится на сотрудника с внутренним номером 202

Если **во время** проигрывания голосового меню клиент **ничего не ввел**, то **после проигрывания** голосового меню происходит ожидание **7 секунд** для набора комбинации цифр.\
«Общее время для набора номера» = «Длительность звукового файла» + 7 секунд.

Если «Общее время для набора номера» истекло, то происходит переадресация на «**Номер по умолчанию**», т.е. на сотрудника с внутренним номером 101.

Если необходимо **повторно** воспроизвести голосовое приветствие и дать клиенту возможность снова ввести номер, то установите **«Количество повторов, перед переводом на номер по умолчанию»** в значение 2 и более. Происходит повторное голосовое оповещение и ожидание 7 секунд, то есть следующая попытка IVR. Как только попытки превышают указанное значение - происходит переадресация на «**Номер по умолчанию**».

Если пользователь **некорректно** набирает номер или вообще ничего не набирает, то происходит повторное голосовое оповещение (в случае если **Количество повторов** установлено **больше 2-х**), либо происходит переадресация на «**Номер по умолчанию**» (в случае если **Количество повторов** равно **1**).

4. Добавляем **учетную запись провайдера**, через которого будут совершаться звонки, по [инструкции](/mikopbx/manual/routing/providers.md). Примеры подключения провайдеров приведены [здесь](/mikopbx/faq/providers.md).

<figure><img src="/files/wycdvt4mqykIOZnm3w55" alt=""><figcaption><p>Провайдеры телефонии</p></figcaption></figure>

5. Настраиваем прием всех **входящих звонков** через заведенного провайдера на IVR-меню.

<figure><img src="/files/viqUZ1ZVj9VOLXY2AYrF" alt=""><figcaption><p>Новое правило обработки входящих вызовов</p></figcaption></figure>

{% hint style="info" %}
Инструкции по настройке входящей маршрутизации доступны по [ссылке](/mikopbx/faq/incoming-routing.md).
{% endhint %}


---

# 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://docs.mikopbx.com/mikopbx/faq/incoming-routing/basic-ivr-example.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.