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

Как в Asterisk настроить переадресацию вызова с одного номера на другой

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

Разбираем три схемы переадресации в Asterisk: безусловный перевод на другой номер, переадресацию по результату набора (занято, нет ответа, абонент недоступен) и проверку регистрации абонента до вызова. Примеры написаны для PJSIP и Gosub, без устаревших Macro и chan_sip.

Какие бывают переадресации

В офисной АТС чаще всего нужны три сценария:

Сценарий Когда срабатывает Как реализуется
Безусловная Всегда, абонент A сразу получает вызовы на номер Б Отдельный экстеншен с Dial на номер Б
Условная Абонент занят, не ответил или недоступен Анализ ${DIALSTATUS} после Dial
По регистрации Телефон абонента не зарегистрирован Проверка контактов PJSIP до вызова

Все примеры ниже рассчитаны на Asterisk 18–22 с каналом PJSIP. Внешние вызовы уходят через транк provider, имя замените на своё из pjsip.conf.

Безусловная переадресация

Самый простой случай: вызовы на внутренний номер 2221526 всегда отправляются на мобильный. Номер звонящего при этом можно подменить, если провайдер не пропускает чужой Caller ID.

[transfer-full]
exten => 2221526,1,NoOp(Безусловная переадресация)
 same => n,Set(CALLERID(num)=2221526)
 same => n,Dial(PJSIP/89991234567@provider,60)
 same => n,Hangup()

Подмена CALLERID(num) нужна не всегда. Если оператор разрешает передавать исходный номер, уберите эту строку: сотрудник на мобильном увидит, кто звонит на самом деле.

Условная переадресация через Gosub

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

[from-internal]
exten => _58X,1,Gosub(sub-forward,s,1(${EXTEN},vm))
 same => n,Hangup()

exten => 2222020,1,Gosub(sub-forward,s,1(101,sorry))
 same => n,Hangup()

[sub-forward]
; ARG1 — внутренний номер, ARG2 — что делать при неудаче: vm или sorry
exten => s,1,Dial(PJSIP/${ARG1},20,tT)
 same => n,NoOp(DIALSTATUS=${DIALSTATUS})
 same => n,GotoIf($["${DIALSTATUS}" = "BUSY"]?fail)
 same => n,GotoIf($["${DIALSTATUS}" = "NOANSWER"]?fail)
 same => n,GotoIf($["${DIALSTATUS}" = "CHANUNAVAIL"]?fail)
 same => n,GotoIf($["${DIALSTATUS}" = "CONGESTION"]?fail)
 same => n,Return()
 same => n(fail),Wait(1)
 same => n,GotoIf($["${ARG2}" = "vm"]?voicemail:sorry)
 same => n(voicemail),VoiceMail(${ARG1}@default,u)
 same => n,Return()
 same => n(sorry),Playback(followme/sorry)
 same => n,Return()

Что важно в этом примере:

  • Опции tT разрешают обеим сторонам переводить вызов встроенным трансфером (по умолчанию #). Если трансфер не нужен, уберите их.
  • CANCEL в проверках нет: этот статус означает, что звонящий сам положил трубку, и переадресовывать уже некого.
  • Опция u у VoiceMail проигрывает приветствие «абонент недоступен», опция b — приветствие «занято». Можно разделить ветки и выбирать опцию по статусу.
  • Звук followme/sorry входит в стандартный набор звуков. Путь пишется без расширения и относительно каталога sounds; если русский пакет установлен, Asterisk возьмёт файл из sounds/ru по языку канала.

Переадресация, если телефон не зарегистрирован

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

[from-internal]
exten => 101,1,Set(CONTACTS=${PJSIP_DIAL_CONTACTS(101)})
 same => n,GotoIf($["${CONTACTS}" = ""]?offline)
 same => n,Dial(${CONTACTS},20,tT)
 same => n,Hangup()
 same => n(offline),NoOp(101 не зарегистрирован, уходим на мобильный)
 same => n,Dial(PJSIP/89991234567@provider,60)
 same => n,Hangup()

Вместо PJSIP_DIAL_CONTACTS можно использовать ${DEVICE_STATE(PJSIP/101)}: при отсутствии регистрации функция вернёт UNAVAILABLE. Для схемы «абонент на нескольких устройствах» первый вариант удобнее: PJSIP_DIAL_CONTACTS сразу возвращает строку набора на все зарегистрированные контакты.

Переадресация, которую включает сам пользователь

Чтобы не править диалплан под каждую просьбу, номер переадресации можно хранить во встроенной базе AstDB и управлять им сервисными кодами с телефона.

[from-internal]
; *21*89991234567 — включить безусловную переадресацию
exten => _*21*X.,1,Set(DB(CFIM/${CALLERID(num)})=${EXTEN:4})
 same => n,Playback(beep)
 same => n,Hangup()

; #21# — выключить
exten => #21#,1,NoOp(${DB_DELETE(CFIM/${CALLERID(num)})})
 same => n,Playback(beep)
 same => n,Hangup()

exten => _1XX,1,GotoIf(${DB_EXISTS(CFIM/${EXTEN})}?cf)
 same => n,Dial(PJSIP/${EXTEN},20,tT)
 same => n,Hangup()
 same => n(cf),Dial(PJSIP/${DB_RESULT}@provider,60)
 same => n,Hangup()

Проверить, что запись создалась, можно в консоли командой database show CFIM. Учтите, что такая схема даёт сотруднику возможность отправлять вызовы на любой внешний номер за счёт компании: ограничьте шаблон допустимыми префиксами.

Голосовая почта

Для ветки vm у абонента должен быть почтовый ящик в voicemail.conf:

[default]
585 => 1234,Техподдержка,support@example.com,,attach=yes|delete=yes

Формат строки: номер ящика, PIN, имя, адрес почты, адрес пейджера (пусто) и опции. attach=yes прикладывает запись к письму, delete=yes удаляет сообщение с сервера после отправки. Чтобы письма уходили, на сервере должен работать почтовый агент (Postfix, msmtp и т. п.), а в секции [general] указан корректный serveremail.

Проверка и отладка

  1. Перечитайте диалплан: asterisk -rx "dialplan reload", голосовую почту — asterisk -rx "voicemail reload".
  2. Убедитесь, что контекст подхватился: dialplan show 101@from-internal.
  3. Позвоните на номер и смотрите консоль asterisk -rvvv: строка NoOp(DIALSTATUS=...) покажет, какой статус вернул набор и по какой ветке пошёл вызов.

Если вы только разворачиваете АТС, начните с базовой настройки Asterisk после установки. Другие рецепты диалплана собраны в разделе Asterisk.

Что изменилось с 2016 года

  • Модуль chan_sip удалён в Asterisk 21, поэтому строки вида Dial(SIP/SMG2/номер) нужно переписать на Dial(PJSIP/номер@транк).
  • Приложение Macro удалено там же; его замена — Gosub с Return().
  • Для переадресации на мобильный через одного оператора без подмены номера проверьте, пропускает ли транк чужой Caller ID: многие операторы сейчас сбрасывают такие вызовы.

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

Почему в моём старом диалплане перестал работать Macro?

Приложение Macro давно объявлено устаревшим и удалено в Asterisk 21. Перепишите макросы на Gosub: контекст вызывается через Gosub(context,s,1(арг1,арг2)), аргументы доступны как ${ARG1}, ${ARG2}, а в конце ставится Return().

Нужно ли переадресовывать вызов при статусе CANCEL?

Нет. CANCEL означает, что звонящий сам положил трубку до ответа. Переадресовывать имеет смысл только при BUSY, NOANSWER, CHANUNAVAIL и CONGESTION.

Как проверить, зарегистрирован ли абонент PJSIP?

В консоли — командой pjsip show contacts или pjsip show aor 101. В диалплане — функцией PJSIP_DIAL_CONTACTS(101): если она вернула пустую строку, у абонента нет ни одного зарегистрированного контакта.

Как дать пользователю самому включать переадресацию с телефона?

Храните номер переадресации в AstDB: сервисный код вроде *21*номер записывает его через функцию DB, код #21# удаляет через DB_DELETE, а основной диалплан перед набором проверяет DB_EXISTS.