AMI-канал Asterisk: события и адресация звонков

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

AMI-канал Asterisk: события и адресация звонков

AMI позволяет серверу TesLab получать события Asterisk без HTTP-запроса из дайлплана на каждом этапе звонка. По этим событиям TesLab показывает входящий вызов нужным сотрудникам, отмечает ответ и завершение. Голос передаётся отдельно: успешное подключение AMI не подтверждает работу звука.

Как настроить подключение

  1. В Asterisk подготовьте отдельного пользователя AMI и разрешите соединение с адреса сервера TesLab.
  2. Откройте «Конфигурация» → «АТС» → «Уведомления о звонках», блок «Подключение по AMI».
  3. Укажите адрес станции, порт, пользователя и пароль. Для обычного AMI порт по умолчанию 5038.
  4. Если подключение идёт по внутреннему адресу, а в карточках сотрудников указан другой адрес АТС, заполните поле «Адрес АТС в карточках» этим согласованным именем.
  5. Включите «Слушать события станции», сохраните параметры и выполните проверку подключения.
  6. После проверки совершите контрольный звонок и проверьте начало, ответ, завершение и журнал.

Сервер использует отдельное TCP-соединение с AMI. HTTPS программы и WSS софтфона его не шифруют. Параметр «Запретить открытый пароль AMI» запрещает переход к обычному логину, если станция не поддерживает Challenge/MD5. Сам Challenge/MD5 также не шифрует весь канал, поэтому подключение должно работать через защищённую сеть.

Учебные параметры AMI с короткими указателями адреса подключения, адреса АТС в карточках и проверки
1. Адрес соединения с AMI. 2. Имя станции, с которым сопоставляются карточки сотрудников. 3. Проверка введённых параметров.

Настройка полей и применение изменений подробнее описаны в статье «Уведомления о звонках: интеграция станции и AMI». Не меняйте рабочие реквизиты станции только ради проверки по примеру.

Что подтверждает проверка

Для чтения событий звонков нужны соответствующие права AMI, обычно read = call. Для адресного ответа требуются команды Redirect, CoreShowChannels и ShowDialPlan. В стандартной конфигурации они относятся к правам write = call,reporting; фактический набор возможностей показывает проверка.

Различайте четыре результата:

  • Параметры сохранены: TesLab записал настройку.
  • Авторизация успешна: тест смог войти в AMI.
  • Команды доступны: станция объявила нужные возможности. Это ещё не выполненный перевод реального звонка.
  • Контрольный звонок прошёл: работающий сервер получил события, нужные сотрудники увидели вызов, ответ и завершение обработались верно.
Учебный результат проверки AMI с указателями кнопки и сообщения о границах проверки
1. Кнопка проверки. 2. Успешная авторизация и доступность команд не заменяют проверку событий и разговора.

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

Как выбираются сотрудники

В карточке сотрудника должны быть заданы его добавочный и адрес АТС. Для события с известной станцией 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 не проверяет их.

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