Уведомления о звонках: интеграция станции и AMI
Настройте передачу событий от АТС, чтобы TesLab сообщал сотрудникам о входящих звонках и снимал уведомления после завершения вызова. Подключение подготовьте вместе с администратором станции. Личное SIP-подключение сотрудника и передача звука настраиваются отдельно.
В этой статье
Что подготовить и как выбрать способ подключения
Откройте «Конфигурация → АТС → Уведомления о звонках». Блок доступен администратору. Проверьте, что у действующего сотрудника указаны добавочный и адрес станции в личном SIP-подключении.
- AMI: сервер TesLab подключается к Asterisk и слушает события. Нужны адрес и порт станции, отдельная учётная запись AMI и разрешение подключаться с сервера TesLab. Правка дайлплана для этого способа не требуется.
- Дайлплан: станция сама отправляет события по скопированной строке. Нужны доступ к изменению обработки входящих вызовов и согласованная передача начала и завершения звонка.
Согласуйте источник событий, чтобы один вызов не создавал повторные уведомления. Учётная запись AMI нужна также для адресного ответа на конкретный звонок. Телефонные линии и их получатели остаются отдельной настройкой.
Настроить и проверить AMI
Администратор Asterisk готовит учётную запись в manager.conf. Для событий звонков используется read = call. Для адресного ответа стандартному Asterisk нужны команды Redirect, CoreShowChannels и ShowDialPlan; обычно их покрывает write = call,reporting. Набор прав и доступ с адреса сервера подтвердите для своей станции.
| Поле | Что указать |
|---|---|
| Адрес станции, порт | Имя или IP, доступные серверу TesLab, без схемы и пути. Обычно порт 5038, но фактический порт задаёт специалист станции. |
| Пользователь, пароль | Реквизиты отдельной учётной записи AMI. Если пароль уже сохранён и менять его не нужно, оставьте поле пустым. |
| Адрес АТС в карточках | Имя станции у сотрудников, если оно отличается от адреса подключения. Например: сервер обращается к 10.0.0.20, сотрудники используют ats.example.ru. |
| Слушать события станции | Включает получение событий по AMI. |
| Запретить открытый пароль AMI | При включении допускается только вход через Challenge/MD5. Согласуйте поддержку со специалистом станции. Подключение AMI должно проходить по защищённой сети. |
- Заполните параметры AMI. Перед проверкой сверьте адрес, порт и пользователя: пустые поля при проверке могут использовать сохранённые значения.
- Нажмите «Проверить подключение». Проверка не сохраняет форму. Она проверяет авторизацию и доступность команд адресного ответа.
- Если доступны не все команды или возможности не подтверждены, передайте результат администратору станции.
- Включите «Слушать события станции» и нажмите «Сохранить» в блоке AMI. Дождитесь подтверждения записи.
- Работающий сервер проверяет изменения примерно раз в 5 секунд. Выполните контрольный звонок. Для проверки записанных полей нажмите «Перечитать настройки», учитывая, что несохранённый ввод будет заменён.

Успех проверки AMI ещё не подтверждает получение событий, доставку уведомлений и передачу звука. Эти этапы проверяются звонком.
Подключить события через дайлплан
- В блоке «Строка для дайлплана» нажмите «Скопировать».
- Передайте строку своей установки ответственному за АТС. Он выбирает контекст входящего вызова и проверяет, что обычная маршрутизация сохраняется.
- Согласуйте отправку завершения вызова с тем же идентификатором звонка. Скопированная строка сообщает только начало; сама по себе она не заменяет обработку завершения.

Строка содержит ключ доступа. Не используйте строку другой организации и не публикуйте свою. После подтверждённой смены ключа прежнюю строку нужно заменить на станции. Если результат смены неизвестен, сначала перечитайте настройки и проверьте фактическую строку.
Задать перехват и ICE
В поле «Перехват вызова при ответе с уведомления» укажите код, согласованный с администратором станции, затем нажмите соседнее «Сохранить». Например, **{ext} подходит некоторым настройкам FreePBX. Шаблон {ext} заменяется фактической целью перевода, если она известна, иначе добавочным из личного подключения.
Это запасной способ ответа, когда обычный входящий или адресный перевод не довели звонок до приложения. Пустое поле отключает только набор кода. При нескольких одновременных звонках код может забрать другой вызов на тот же добавочный.
В поле «ICE-серверы для звонков» вводите согласованные адреса stun: или stuns:, несколько через запятую. Например: stun:stun.example.ru:3478. Сохраните отдельной кнопкой. TURN с именем пользователя и паролем через это поле не настраивается. При прямой доступности медиапотока поле можно оставить пустым; сам по себе VPN не гарантирует прохождение звука.

Проверить входящий звонок
- Позвоните сотруднику с настроенным SIP-подключением. Проверьте номер, получателя и отсутствие повторных уведомлений.
- Ответьте на ещё идущий вызов при открытом приложении. Проверьте звук в обе стороны.
- Если нужны мобильные уведомления, отдельно проверьте согласованный сценарий в фоне и при закрытом приложении, разрешения устройства и ответ на звонок.
- Завершите вызов. Проверьте снятие карточки; при групповом вызове проверьте также ответ другого сотрудника.
- В журнале звонков сопоставьте время, добавочный и исход.
Если что-то не работает
- Ошибка авторизации. Проверьте реквизиты AMI, разрешённый адрес сервера TesLab и поддержку выбранной политики входа.
- Доступны не все команды. Согласуйте права адресного ответа со специалистом станции. Успешная авторизация не заменяет разрешение на команды.
- Тест прошёл, событий нет. Проверьте сохранение, прослушивание, работу серверного слушателя, разрешённые события, добавочный и имя станции у сотрудника.
- Уведомление есть, ответа нет. Проверьте личное SIP-подключение, доступные команды AMI и согласованный код перехвата. Убедитесь, что вызов ещё идёт.
- Настройки уже изменены или результат не подтверждён. Перечитайте значения и сверьте их перед новым сохранением. Не отправляйте изменённые поля поверх неизвестного результата.
- ICE-адрес не принят. Проверьте полный STUN/STUNS-адрес и порт. Обычная веб-ссылка или TURN-адрес для этого поля не подходят.
- Нет звука. Отдельно проверьте микрофон, устройство вывода и сетевой путь медиапотока.
Для разбора передайте специалисту время звонка, добавочный и точный текст ошибки. Укажите этап: авторизация, получение события, уведомление, ответ или звук. Пароль и строку с ключом в общедоступный отчёт не включайте.
Материалы
Связанные инструкции
- Приём звонков от АТС: WebRTC и SIP-подключение
- Телефонные линии: подключение АТС к TesLab
- Входящие звонки и чёрный список номеров
- Рабочее место администратора: конфигурация и доступные действия