Как сделать автоинформатор на Asterisk
Автоинформатор сообщает звонящему, что номер свободен или изменён, и называет новый номер. Разбираем, как собрать его в диалплане 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, но в некоторых версиях могут сами ответить на вызов. Проверьте поведение в консоли на своей версии.
Подключение и проверка
- Включите контекст
autoinformerво входящий контекст транка:include => autoinformerили явныйGotoдля нужных номеров. - Перечитайте диалплан:
asterisk -rx "dialplan reload". - Проверьте разбор шаблонов:
asterisk -rx "dialplan show 2221005@autoinformer". - Позвоните на номер из каждого диапазона и послушайте, как читаются пары с нулём.
Если вместо русской речи звучат английские цифры, проверьте наличие каталога 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 — все примеры в статье написаны именно так.