Shkerka.ruзаметки админа
Asterisk и IP-АТС

Как сделать автоинформатор на Asterisk

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция Shkerka.ru

Автоинформатор сообщает звонящему, что номер свободен или изменён, и называет новый номер. Разбираем, как собрать его в диалплане Asterisk для целых номерных ёмкостей: шаблоны, подпрограммы и правильное произношение цифр.

Задача

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

  • номер свободен — «Вы позвонили на номер 222-10-05. Номер свободен и может быть подключён»;
  • номер изменён — «Номер абонента изменён. Новый номер 222-28-05», где последние цифры совпадают со старым номером.

Делать отдельный экстеншен на каждый номер не нужно: Asterisk умеет разбирать номер на части по шаблону, а одна подпрограмма озвучит любой номер ёмкости.

Подготовка звуковых фраз

Цифры и числа Asterisk проговорит сам из стандартного русского пакета звуков. Записать нужно только связующие фразы:

Файл Текст
vy-pozvonili Вы позвонили на номер
nomer-svoboden Номер свободен и может быть подключён
nomer-izmenen Номер абонента изменён. Новый номер

Положите их в /var/lib/asterisk/sounds/ru/autoinf/ и приведите к телефонному формату — 8 кГц, моно, 16 бит:

sox vy-pozvonili-src.wav -r 8000 -c 1 -b 16 vy-pozvonili.wav
chown -R asterisk:asterisk /var/lib/asterisk/sounds/ru/autoinf

Маршрутизация по номерным ёмкостям

Входящий контекст определяет, к какому диапазону относится набранный номер, и вызывает нужную подпрограмму. Последние две цифры берутся срезом ${EXTEN:-2}.

[autoinformer]
; свободные номера 22210XX и 22211XX
exten => _2221[01]XX,1,Gosub(sub-free,s,1(${EXTEN}))
 same => n,Hangup()

; перенесённые номера: 35790XX -> 22228XX, 35791XX -> 22229XX
exten => _35790XX,1,Gosub(sub-changed,s,1(22228${EXTEN:-2}))
 same => n,Hangup()
exten => _35791XX,1,Gosub(sub-changed,s,1(22229${EXTEN:-2}))
 same => n,Hangup()

; исключения: эти номера заняты, информатор для них не нужен
exten => 3579000,1,Hangup()
exten => 3579001,1,Hangup()

Точное совпадение номера всегда приоритетнее шаблона, поэтому исключения можно перечислять отдельными строками — громоздкие проверки GotoIf с перебором аргументов не нужны.

Произношение семизначного номера

Номер вида 222-10-05 по-русски читается группами: «двести двадцать два — десять — ноль пять». Первая тройка произносится как число, пары — как число, если не начинаются с нуля, и по цифрам, если начинаются. Эту логику удобно вынести в отдельную подпрограмму:

[sub-say-phone]
; ARG1 — семизначный номер
exten => s,1,SayNumber(${ARG1:0:3})
 same => n,Set(p=${ARG1:3:2})
 same => n,ExecIf($["${p:0:1}" = "0"]?SayDigits(${p}):SayNumber(${p}))
 same => n,Set(p=${ARG1:5:2})
 same => n,ExecIf($["${p:0:1}" = "0"]?SayDigits(${p}):SayNumber(${p}))
 same => n,Return()

ExecIf выполняет первое приложение, если условие истинно, и второе — если ложно. Так пара 05 прозвучит как «ноль пять», а 28 — как «двадцать восемь».

Подпрограммы «свободен» и «изменён»

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

[sub-free]
exten => s,1,Progress()
 same => n,Set(CHANNEL(language)=ru)
 same => n,Wait(1)
 same => n,Set(i=0)
 same => n,While($[${i} < 3])
 same => n,Playback(autoinf/vy-pozvonili,noanswer)
 same => n,Gosub(sub-say-phone,s,1(${ARG1}))
 same => n,Playback(autoinf/nomer-svoboden,noanswer)
 same => n,Wait(1)
 same => n,Set(i=$[${i} + 1])
 same => n,EndWhile()
 same => n,Return()

[sub-changed]
exten => s,1,Progress()
 same => n,Set(CHANNEL(language)=ru)
 same => n,Wait(1)
 same => n,Set(i=0)
 same => n,While($[${i} < 3])
 same => n,Playback(autoinf/nomer-izmenen,noanswer)
 same => n,Gosub(sub-say-phone,s,1(${ARG1}))
 same => n,Wait(1)
 same => n,Set(i=$[${i} + 1])
 same => n,EndWhile()
 same => n,Return()

Опция noanswer у Playback проигрывает файл без ответа на вызов, а Progress() открывает медиапоток в сторону звонящего. Если ваш оператор не пропускает early media, замените Progress() на Answer() — вызов станет отвеченным и будет тарифицироваться.

Обратите внимание: SayNumber и SayDigits тоже работают в режиме early media, но в некоторых версиях могут сами ответить на вызов. Проверьте поведение в консоли на своей версии.

Подключение и проверка

  1. Включите контекст autoinformer во входящий контекст транка: include => autoinformer или явный Goto для нужных номеров.
  2. Перечитайте диалплан: asterisk -rx "dialplan reload".
  3. Проверьте разбор шаблонов: asterisk -rx "dialplan show 2221005@autoinformer".
  4. Позвоните на номер из каждого диапазона и послушайте, как читаются пары с нулём.

Если вместо русской речи звучат английские цифры, проверьте наличие каталога sounds/ru/digits. Пакет ставится через make menuselect (раздел Core Sound Packages, CORE-SOUNDS-RU) или скачивается с downloads.asterisk.org.

Что изменилось в современных версиях

  • Macro удалён в Asterisk 21. Старые диалпланы с Macro(...) и контекстами [macro-...] нужно переводить на Gosub(...) и Return().
  • Цикл While не требует Goto(s,1) внутри: возврат на начало делает EndWhile(). Переход на первую строку обнуляет счётчик и превращает цикл в бесконечный — частая ошибка старых примеров.
  • Для большого числа номеров списки удобнее хранить не в диалплане, а в AstDB или внешней базе через func_odbc. Тогда добавить перенесённый номер можно без перезагрузки диалплана.

Похожая техника повтора сообщений подробно разобрана в статье как проиграть звуковой файл несколько раз, а другие рецепты — в разделе Asterisk.

Частые вопросы

Чем SayNumber отличается от SayDigits?

SayNumber произносит число целиком («двести двадцать два»), SayDigits — каждую цифру отдельно («два, два, два»). Для пар с ведущим нулём, например 05, нужен SayDigits, иначе ноль потеряется.

Как не тарифицировать звонок на автоинформатор?

Используйте Progress() вместо Answer(): сообщение уйдёт как early media, а вызов останется неотвеченным. Учтите, что не все операторы и телефоны корректно пропускают early media, поэтому проверьте это на своём транке.

Почему автоинформатор не говорит по-русски?

Нужен русский пакет звуков (core-sounds-ru) и язык канала ru: Set(CHANNEL(language)=ru) в диалплане или language=ru в настройках endpoint. Без этого SayNumber будет использовать английские файлы.

Работает ли Macro в новых версиях Asterisk?

Нет, приложение Macro удалено в Asterisk 21. Используйте Gosub с Return — все примеры в статье написаны именно так.