AMI-канал Asterisk: события и адресация звонков
AMI позволяет серверу TesLab получать события Asterisk без HTTP-запроса из дайлплана на каждом этапе звонка. По этим событиям TesLab показывает входящий вызов нужным сотрудникам, отмечает ответ и завершение. Голос передаётся отдельно: успешное подключение AMI не подтверждает работу звука.
Как настроить подключение
- В Asterisk подготовьте отдельного пользователя AMI и разрешите соединение с адреса сервера TesLab.
- Откройте «Конфигурация» → «АТС» → «Уведомления о звонках», блок «Подключение по AMI».
- Укажите адрес станции, порт, пользователя и пароль. Для обычного AMI порт по умолчанию 5038.
- Если подключение идёт по внутреннему адресу, а в карточках сотрудников указан другой адрес АТС, заполните поле «Адрес АТС в карточках» этим согласованным именем.
- Включите «Слушать события станции», сохраните параметры и выполните проверку подключения.
- После проверки совершите контрольный звонок и проверьте начало, ответ, завершение и журнал.
Сервер использует отдельное TCP-соединение с AMI. HTTPS программы и WSS софтфона его не шифруют. Параметр «Запретить открытый пароль AMI» запрещает переход к обычному логину, если станция не поддерживает Challenge/MD5. Сам Challenge/MD5 также не шифрует весь канал, поэтому подключение должно работать через защищённую сеть.

Настройка полей и применение изменений подробнее описаны в статье «Уведомления о звонках: интеграция станции и AMI». Не меняйте рабочие реквизиты станции только ради проверки по примеру.
Что подтверждает проверка
Для чтения событий звонков нужны соответствующие права AMI, обычно read = call. Для адресного ответа требуются команды Redirect, CoreShowChannels и ShowDialPlan. В стандартной конфигурации они относятся к правам write = call,reporting; фактический набор возможностей показывает проверка.
Различайте четыре результата:
- Параметры сохранены: TesLab записал настройку.
- Авторизация успешна: тест смог войти в AMI.
- Команды доступны: станция объявила нужные возможности. Это ещё не выполненный перевод реального звонка.
- Контрольный звонок прошёл: работающий сервер получил события, нужные сотрудники увидели вызов, ответ и завершение обработались верно.

Кнопка проверки не запускает постоянный приём событий вместо серверной службы. Даже после успешного теста отдельно проверьте входящее уведомление и звук.
Как выбираются сотрудники
В карточке сотрудника должны быть заданы его добавочный и адрес АТС. Для события с известной станцией TesLab сопоставляет оба значения. Добавочный 105 на одной станции и 105 на другой не являются одним подключением. Разные IPv6-адреса также различаются.
Поле «Адрес АТС в карточках» нужно, например, когда TesLab подключается к 10.0.0.20, а в карточках записано ats.example.ru. Для уведомлений, адресного ответа и связанных HTTP hook используйте одно согласованное имя станции. Иначе одинаковый номер добавочного не доказывает принадлежность вызова.
Несколько сотрудников могут иметь один добавочный. При звонке на группу адресаты объединяются; повторное событие для того же разговора не должно создавать им повторные уведомления. Уволенные сотрудники и звонящий сотрудник исключаются из рассылки. Если добавочный не привязан к сотрудникам, уведомлять по нему некого.
Адресный ответ разрешается только сотруднику, включённому в известные адресаты этого звонка. Неизвестный вызов или другой источник не дают права на перехват. Такой отказ не должен запускать запасной набор кода перехвата.
Какие события нужны
| Событие | Как используется |
|---|---|
Newchannel | Сведения о новом канале и возможном вызываемом добавочном. |
DialBegin | Связь исходного и вызываемого каналов. Важны Uniqueid, DestUniqueid и DestChannel. |
BridgeEnter / BridgeLeave | Вход и выход канала из моста. Ответ определяется по известной вызываемой ветви и её связи с каналом разговора. Один служебный вход в мост не считается ответом сотрудника. |
DialEnd с DialStatus: ANSWER | Подтверждение ответа известного вызываемого канала. |
Hangup | Завершение конкретного канала. Отбой одной ветви группы не означает окончание всего звонка. |
Linkedid объединяет связанные каналы, Uniqueid обозначает конкретный канал. Если Linkedid отсутствует, используется Uniqueid и уже известные связи каналов. Сохраняйте идентификаторы точно, без округления и замены на номер телефона.
CallerIDNum является номером стороны канала. По нему одному нельзя определять ответившего сотрудника. Для вызываемой стороны учитываются известный ID ветви и её канал. Произвольный дайлплан с пустыми или служебными полями нужно проверять отдельно.

Пример одного разговора
Ниже сокращённая последовательность для вызова на добавочный 105. Это примеры AMI-пакетов от станции, не JSON-запросы к HTTP API TesLab. Идентификатор разговора 1787070849.762581 связан с вызываемой ветвью 1787070849.762582.
Event: DialBegin
Uniqueid: 1787070849.762581
Linkedid: 1787070849.762581
Channel: PJSIP/carrier-00000001
CallerIDNum: 70000000000
DestUniqueid: 1787070849.762582
DestChannel: PJSIP/105-00000002
Канал звонящего входит в мост:
Event: BridgeEnter
Uniqueid: 1787070849.762581
Linkedid: 1787070849.762581
BridgeUniqueid: training-bridge
BridgeType: basic
BridgeNumChannels: 1
Затем в тот же мост входит известная вызываемая ветвь:
Event: BridgeEnter
Uniqueid: 1787070849.762582
Linkedid: 1787070849.762581
BridgeUniqueid: training-bridge
BridgeType: basic
BridgeNumChannels: 2
Теперь есть подтверждённая связь с добавочным 105. Журнал отмечает ответ, у остальных адресатов снимается входящий вызов с указанием ответа коллеги. Время завершения пока не ставится.
Event: Hangup
Uniqueid: 1787070849.762581
Linkedid: 1787070849.762581
Cause: 16
При завершении разговора закрывается его запись. Если ответ был известен ранее, звонок сохраняет этот исход. Исчезновение состояния по таймеру или обрыв AMI не являются доказательством пропуска.
Старые события и переподключение
Поддерживаются также старые сочетания Dial с SubEvent: Begin/End и Bridge с BridgeState: Link, когда они содержат известные ID соответствующих каналов. Одного Newchannel достаточно не для всех этапов. Не считайте название или номер версии Asterisk гарантией полного набора событий: проверьте фактический поток станции.
После обычного переподключения сохраняются уже известные адресаты и факты ответа. Уборка временных файлов не должна стирать их в середине длинного разговора. Однако отключённый AMI не получает события задним числом. Если часть событий потеряна, потребуются проверка станции и журнала; полного восстановления любой истории переводов по одному последнему пакету нет.
Не включайте одновременно несколько независимых способов уведомления без согласования ID и источника. AMI и HTTP hook могут работать с одним разговором, если передают одинаковые значения станции и идентификатора. Если ваша внешняя программа пересылает уведомления TesLab, сохраняйте исходный id и признак источника call_scope во всех событиях.
Если уведомления не приходят
| Наблюдение | Что проверить |
|---|---|
| Тест не подключается | Адрес, порт, сетевую доступность от сервера TesLab, разрешённый адрес клиента AMI и реквизиты пользователя. |
| Тест успешен, входящего нет | Работает ли постоянная серверная служба, включён ли приём событий, приходят ли нужные события и соответствует ли добавочный карточке сотрудника. |
| Звонок видит не тот сотрудник | Добавочный и адрес АТС в его карточке, поле «Адрес АТС в карточках», совпадение источника hook и AMI. |
| Нет отметки ответа или завершения | Связи каналов и фактические DialBegin, BridgeEnter, DialEnd, Hangup. Не подменяйте отсутствующее событие предположением о пропуске. |
| Карточка есть, но разговора нет | SIP-регистрацию, микрофон, маршрутизацию вызова и медиасоединение. Успешный AMI не проверяет их. |
Проверьте отдельные сценарии: общий добавочный, ответ коллеги, отбой до ответа, длинный разговор, переподключение и перевод. Состояние и исходы сопоставляйте с журналом входящих звонков. Пустой или неполный поток событий не подтверждает правильность статистики пропусков.