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

# Входящие маршруты

Описание и настройка входящей маршрутизации

В данном разделе необходимо создать правила и шаблоны распределения входящих звонков для созданных в MikoPBX провайдеров. Правила входящих звонков описывают маршрут звонка с момента его поступления в АТС до момента его завершения. Вы можете создавать неограниченное количество правил входящей маршрутизации. Для одного провайдера можно создать несколько правил.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FFm7wlqaMaFNCn4VVpu07%2Fvhod_marsh_0.png?alt=media&amp;token=cc837a4d-918c-45ba-956c-7cb0841139e3" alt=""><figcaption><p>Раздел "<strong>Входящие маршруты</strong>" в MikoPBX</p></figcaption></figure>

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

## Приоритет правил маршрутизации и маршрут по умолчанию

Правила располагаются в списке в порядке их приоритета. Если за указанный в правиле интервал времени никто не ответит на входящий вызов, то вызов направится на следующее по приоритету правило. Правила можно перемещать в списке вверх-вниз, то есть изменять их приоритет, перетаскивая их за стрелки.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F4fs4K4PrvSLOKU708v9x%2Fvhod_marsh_0.gif?alt=media&amp;token=d57d583b-48eb-4c00-9dee-e9882cbc6ed5" alt=""><figcaption><p>Настройка приоритета правил маршрутизации</p></figcaption></figure>

Если ни по одному из правил на звонок не ответили, применяется **входящий маршрут по умолчанию**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FMsB1C98ntY84M5uHvwOQ%2Fvhod_marsh_5.png?alt=media&amp;token=12bd25ba-c842-45b4-8e5a-887ce930afdb" alt=""><figcaption><p>Маршрут по умолчанию</p></figcaption></figure>

Доступны следующие действия, которые можно указать в качестве правила по умолчанию:

* **Воспроизвести сигнал занято** - клиент будет воспроизведен сигнал занято и входящий вызов будет завершен;
* **Положить трубку;**
* **Перевести вызов** - вызов можно перевести на номер, который вы можете выбрать в поле, расположенном справа от действия. В качестве номера для перевода можно выбрать IVR-меню, очередь вызовов, конференцию, внутренний номер сотрудника.

## Несколько маршрутов для одного провайдера

Для **одного** провайдера можно описать **несколько** входящих маршрутов.

Сперва вызов идет по верхнему маршруту. Если клиент не дозвонился, то вызов идет по нижнему правилу (более низкий приоритет). Если клиент не дозвонился и по второму маршруту, то вызов идет по **маршруту по умолчанию**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F4W6OnniPJq5IrfyXg2IL%2Fvhod_marsh_6.png?alt=media&amp;token=6a08d987-9ec7-416c-bbc1-187044bb203f" alt=""><figcaption><p>Несколько маршрутов для одного провайдера</p></figcaption></figure>

## Создание правила маршрутизации

Чтобы добавить новое правило входящей маршрутизации нажмите на кнопку **Добавить новое правило**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FpHswRe2NEpI3lPGS4eoC%2Fvhod_marsh_1.png?alt=media&amp;token=8fbd06a2-8b4b-4c2f-a4f1-780c78f6e24e" alt=""><figcaption><p>Элемент "<strong>Добавить новое правило</strong>"</p></figcaption></figure>

В поле **`Заметка`** опишите маршрут, который хотите реализовать. В дальнейшем это поможет вам в отладке схемы звонка.

Выберите **`Провайдера`**, для которого создаете новый шаблон распределения входящих звонков.

**`Дополнительный номер DID`** - это номер, на который вам позвонил клиент, в ряде случаев может совпадать с логином провайдера. Это не обязательное поле и его следует заполнять, если необходимо более точно маршрутизировать вызовы.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FB636jsigjd2NXDy2lFjN%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-07-31%20%D0%B2%2016.19.31.png?alt=media&amp;token=e92e828b-1808-40f1-b75b-71eddcf856ac" alt=""><figcaption><p>Параметры обработки входящих</p></figcaption></figure>

**`Голосовое приветствие`** - необязательное поле, допускается выбрать медиа файл для воспроизведения звонящему.

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

Укажите время, в течение которого вызов будет идти на указанный вами телефонный номер.

Если спустя указанный интервал времени никто не ответит на входящий вызов, то вызов направится на следующее по приоритету правило.

## Шаблоны поля «Дополнительный номер DID» и ограничение по CallerID <a href="#did-cid-templates" id="did-cid-templates"></a>

Поле **`Дополнительный номер DID`** можно задать как точный номер, как шаблон Asterisk, либо дополнительно ограничить вызов по номеру звонящего (CallerID).

### Шаблоны DID

Поле сопоставляется с номером, на который позвонил клиент (DID). Если значение состоит только из символов шаблона, MikoPBX воспринимает его как шаблон Asterisk; точные номера указываются как есть.

| Значение поля DID | Что сматчит                             | Примеры             |
| ----------------- | --------------------------------------- | ------------------- |
| пусто или `X!`    | любой входящий (маршрут по умолчанию)   | все звонки          |
| `XZZ`             | 3 цифры, 2-я и 3-я — от 1 до 9          | 711, 923            |
| `3XX`             | 300–399                                 | 300, 350, 399       |
| `4XX`             | 400–499                                 | 400, 455            |
| `[3-4]XX`         | 300–499                                 | 312, 489            |
| `NXX`             | первая цифра 2–9, далее две любые цифры | 234, 900            |
| `74952293042`     | точный DID                              | только 74952293042  |
| `+79066643322`    | точный DID с `+`                        | только +79066643322 |

Обозначения: `X` — цифра 0–9, `Z` — цифра 1–9, `N` — цифра 2–9, `[a-b]` — диапазон, `.` — один и более любых символов, `!` — ноль и более символов.

{% hint style="warning" %}
Используйте только **заглавные** `X`, `Z`, `N`. Строчные (например `3xx`) MikoPBX примет как точный номер, а не как шаблон.
{% endhint %}

### Ограничение по CallerID

Asterisk позволяет в одном поле задать и DID, и допустимый номер звонящего через `/`: часть до `/` сопоставляется с набранным номером (DID), часть после — с номером звонящего (CallerID).

| Значение поля DID          | Что сматчит                                                      |
| -------------------------- | ---------------------------------------------------------------- |
| `74951234567/+79261234567` | DID = 74951234567 **и** CallerID = +79261234567                  |
| `_X!/+79261234567`         | любой DID **и** CallerID = +79261234567                          |
| `_3XX/_79XXXXXXXXX`        | DID из диапазона 300–399 **и** CallerID по шаблону `79XXXXXXXXX` |

{% hint style="info" %}
Без `_` обе части трактуются как точное совпадение. Чтобы задать шаблон, начните соответствующую часть с `_` (например `_X!` — «любой DID», `_79XXXXXXXXX` — шаблон CallerID).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mikopbx.com/mikopbx/manual/routing/incoming-routing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.