Возврат звонка после безусловного перевода в Asterisk

Описание

В Asterisk версии 1.0.X:

Read(variable[|filename][|maxdigits][|option])

Начиная с Asterisk версии 1.2:Read(variable[|filename][|maxdigits][|option][|attempts][|timeout])

Начиная с Asterisk версии 1.6:Read(variable[,filename[&filename2…]][,maxdigits][,option][,attempts][,timeout])

Считывает в указанную переменную, вводимую пользователем, DTMF последовательность, завершенную символом ‘#’, заданное число раз.

Параметры команды:

• variable: имя переменной, в которой будет сохранена введенная пользователем последовательность.
• filename: имя звукового файла (или файлов, начиная с версии 1.6) или тона, если используется опция ‘i’, проигрываемых пользователю до считывания последовательности.
• maxdigits: максимально возможное число считываемых цифр. Считывание прекращается если введено максимальное количество цифр (в этом случае от пользователя не требуется нажатия кнопки ‘#’). Значение по умолчанию: 0 – нет лимита – команда ждет, пока пользователь не нажмет кнопку ‘#’. Любое значение меньше нуля приводят к такому же результату. Максимальное значение для этого параметра – 255.
• option: дополнительные параметры, допустимые значения ‘s’, ‘i’, ‘n’:
• attempts: если больше 1, то указывается число попыток чтения последовательности, в том случае, если пользователь ничего не набрал.
• timeout: Количество секунд ожидания ввода пользователя. Если значение больше нуля, то это значение будет использоваться вместо значения таймаута по умолчанию. (Начиная с версии 1.6, могут использоваться не целые значения).

Начиная с версии 1.6, данное приложение по завершении устанавливает значение переменной канала READSTATUS в соответствии с результатом своей работы, в одно из значений:

OK | ERROR | HANGUP | INTERRUPTED | SKIPPED | TIMEOUT

Asterisk cmd transfer() после ответа()

exten => s,1,Transfer(SIP/1120@xxx.xxx.xxx.xxx)

exten => s,1,Answer()
...
read some dtmf
...
exten => s,n,Transfer(SIP/1120@xxx.xxx.xxx.xxx)

[2021-01-22 07:31:56] NOTICE[32021]: chan_sip.c:20716 handle_response_refer: SIP transfer to <sip:1120@xxx.xxx.xxx.xxx> failed, REFER not allowed.
-- Auto fallthrough, channel 'SIP/1313001-000e0e7c' status is 'UNKNOWN'

Количество попыток для обратных вызовов

atxfercallbackretries – устанавливает количество попыток, когда Asterisk будет отправлять неудачный трансфер обратно инициатору. По умолчанию используется значение 2.

Пример конфигурации:

[general]
atxfernoanswertimeout = 15 
atxferdropcall = no 
atxferloopdelay = 10 
atxfercallbackretries = 2

Параметры поведения

Эти параметры настраиваются в разделе [general] файла features.conf

Общие варианты трансфера

; transferdigittimeout = 3; Количество секунд ожидания между цифрами при передаче вызова
; (по умолчанию - 3 секунды)

Варианты Attended трансфера

; xfersound = beep; указать, что передача участия завершена
; xferfailsound = beeperr; указать неудачную передачу
; transferdialattempts = 3; Количество попыток, по которому переводчик может набрать номер до
; возвращаясь к первоначальному вызову.
; transferretrysound = "beep"; Звук для воспроизведения, когда переводчик не набирает действительное расширение.
; transferinvalidsound = "beeperr"; Звук для воспроизведения, когда переводчик не набирает действительное расширение и не выполняет повторные попытки.

Команды cli (command line interface) asterisk (freepbx) | it блоги – windows, *nix, vmware, hyper-v, netapp, seo, html, видеонаблюдение

# rasterisk

# asterisk -rvvvvv

asterisk -rx "sip show peers"

Написание диалплана asterisk для обработки перевода вызовов

Предположим, что для совершения вызовов используется следующий несложный диалплан:

s,1,GotoIf($[«${RECORDING_STARTED}» = «true»]?end)same => n,Set(__RECORDING_FNAME=${STRFTIME(${EPOCH},,%Y%m%d-%H%M%S)}-${ARG1}-${CALLERID(num)}-${UNIQUEID}.wav)same => n,Set(__RECORDING_STARTED=true)same => n,MixMonitor(${RECORDING_FNAME},ab)same =>

n,Set(AUDIOHOOK_INHERIT(MixMonitor)=yes)same => n(end),Return[local]exten => _XXX,1,Gosub(sub-mixmonitor,s,1(${EXTEN}))same => n,Dial(SIP/${EXTEN},${DIAL_TIME},${DIAL_OPTS})same => n,ExecIf($[«${THIS_IS_TRANSFER}» = «true»]?Return)same =>

n,Hangupexten => _XXX,hint,SIP/${EXTEN}[queues]exten => 600,1,Set(__PREVIOUS_QUEUE=${EXTEN})same => n,Queue(reception,${Q_OPTS},,,600)same => n,Hangupexten => 601,1,Set(__PREVIOUS_QUEUE=${EXTEN})same => n,Queue(sales,${Q_OPTS},,,600)same =>

n,Hangup[internal-default]include => localinclude => queuesexten => _8[2-689]XXXXXXXXX,1,Gosub(sub-mixmonitor,s,1(${EXTEN}))same => n,Set(CALLERID(num)=${DEF_PROV_CID})same => n,Set(CALLERID(name)=)same =>

n,Dial(SIP/def_prov/${EXTEN},${OUT_DIAL_TIME},${OUT_DIAL_OPTS})same => n,ExecIf($[«${THIS_IS_TRANSFER}» = «true»]?Return)same => n,Hangup[from-10X]include => localinclude => queuesexten => _8[2-689]XXXXXXXXX,1,Gosub(sub-mixmonitor,s,1(${EXTEN}))same =>

n,Set(CALLERID(num)=${PROV1_CID})same => n,Set(CALLERID(name)=)same => n,Dial(SIP/prov1/${EXTEN},${OUT_DIAL_TIME},${OUT_DIAL_OPTS})same => n,ExecIf($[«${THIS_IS_TRANSFER}» = «true»]?Return)same => n,Hangup[from-110]include => localinclude => queuesexten =>

_8[2-689]XXXXXXXXX,1,Gosub(sub-mixmonitor,s,1(${EXTEN}))same => n,Set(CALLERID(num)=${PROV2_CID})same => n,Set(CALLERID(name)=)same => n,Dial(SIP/prov2/${EXTEN},${OUT_DIAL_TIME},${OUT_DIAL_OPTS})same => n,ExecIf($[«${THIS_IS_TRANSFER}» = «true»]?Return)same =>

n,Hangupexten => _810Z.,1,Gosub(sub-mixmonitor,s,1(${EXTEN}))same => n,Set(CALLERID(num)=${PROV2_CID})same => n,Set(CALLERID(name)=)same => n,Dial(SIP/prov2/${EXTEN},${OUT_DIAL_TIME},${OUT_DIAL_OPTS})same => n,ExecIf($[«${THIS_IS_TRANSFER}» = «true»]?Return)same =>

n,Hangup[from-trunk]exten => 78888888888,1,Set(CDR(did)=${EXTEN})same => n,ExecIf($[«${CALLERID(name)}» = «»]?Set(CALLERID(name)=${CALLERID(num)}))same => n,Goto(queues,600,1)exten => 71111111111,1,Set(CDR(did)=${EXTEN})same =>

n,ExecIf($[«${CALLERID(name)}» = «»]?Set(CALLERID(name)=${CALLERID(num)}))same => n,Goto(queues,601,1)exten => 72222222222,1,Set(CDR(did)=${EXTEN})same => n,ExecIf($[«${CALLERID(name)}» = «»]?Set(CALLERID(name)=${CALLERID(num)}))same => n,Goto(local,110,1)

Пояснения к диалплану:— вызовы пользователей 100-109 совершаются в контексте from-10X— вызовы пользователя 110 совершаются в контексте from-110— вызовы остальных пользователей совершаются в контексте internal-default— входящие вызовы приходят в контекст from-trunk— номер очереди сохраняется в переменную PREVIOUS_QUEUE перед входом в очередь — после вызова MixMonitor вызывается функция AUDIOHOOK_INHERIT, это нужно для того, чтобы запись продолжалась после перевода вызова

Для того, чтобы абоненты могли использовать сервисные коды перевода вызова, приложения, осуществляющие вызовы абонентов, должны использоваться с опциями разрешающими использование сервисных кодов для перевода вызова. В приведённом диалплане приложения Dial и Queue используются с опциями t и/или T.

Опция t позволяет вызываемой стороне перевести вызов с помощью сервисного кода.Опция T позволяет вызывающей стороне перевести вызов с помощью сервисного кода.Если не указать хотя бы одну из этих опций, сервисные коды перевода вызова не будут работать ни для одной из сторон вызова.

Обратите внимание на то, что исходящие вызовы пользователей 100-109 и 110 осуществляются через различных провайдеров, к тому же, пользователю 110 разрешены международные вызовы, а всем остальным пользователям — нет, эти условия должны быть соблюдены при переводе вызова.

Теперь нужно написать диалплан, который будет осуществлять сам перевод. По умолчанию перевод набирает введённый номер адресата в текущем контексте. Чтобы изменить это поведение, нужно установить значение переменной TRANSFER_CONTEXT, перевод будет выполняться в контексте имя которого указано в переменной TRANSFER_CONTEXT.

Можно добавить эту переменную в раздел [globals] файла extensions.conf, тогда переменная TRANSFER_CONTEXT будет автоматически устанавливаться на каждом новом канале (в приведённом диалплане это уже сделано).Ниже приведён сам контекст transfer, используемый для перевода вызовов:

n,GotoIf($[«${BLINDTRANSFER}» = «»]?after_blindxfer_check)same => n,Set(BL_TRANSFERER=${CUT(BLINDTRANSFER,-,1)})same => n,Set(FIELDNUM=${FIELDQTY(BL_TRANSFERER,/)})same => n,Set(BL_TRANSFERER=${CUT(BL_TRANSFERER,/,${FIELDNUM})})same =>

n,ExecIf($[«${BL_TRANSFERER}» != «»]?Set(TRANSFERER=${BL_TRANSFERER}))same => n(after_blindxfer_check),NoOp(transferer: ${TRANSFERER})same => n,GotoIf(${DIALPLAN_EXISTS(queues,${TRANSFER_TO},1)}?queues,${TRANSFER_TO},1)same => n,Set(TR_CONT=${SIPPEER(${TRANSFERER},context)})same =>

n,ExecIf($[«${TR_CONT}» = «»]?Set(TR_CONT=internal-default))same => n,Set(THIS_IS_TRANSFER=true)same => n,Set(DIALSTATUS=)same => n,Gosub(${TR_CONT},${TRANSFER_TO},1)same => n,ExecIf($[«${DIALSTATUS}» = «ANSWER»]?Hangup)same =>

n,Goto(failover)exten => failover,1,Playback(call-will-be-forwarded)same => n,ExecIf($[«${REGEX(«^XFER_FAIL:» ${CALLERID(name)})}» = «0»]?Set(CALLERID(name)=XFER_FAIL: ${CALLERID(name)}))same => n,Set(DIALSTATUS=)same => n,GosubIf($[«${EXTENSION_STATE(${TRANSFERER}@local)}» !

= «NOT_INUSE»]?local,${TRANSFERER},1)same => n,ExecIf($[«${DIALSTATUS}» = «ANSWER»]?Hangup)same => n,Set(THIS_IS_TRANSFER=)same => n,GotoIf($[«${PREVIOUS_QUEUE}» != «»]?queues,${PREVIOUS_QUEUE},1)same => n,Goto(${TRANSFER_FAILOVER})

Вкратце, контекст выполняет следующее:— К опциям приложений Dial и Queue добавляется опция H, она позволяет завершить вызов сервисным кодом (в случае приложения Queue, опция H позволяет завершить вызов нажатием *, поэтому сервисный код отбоя вызова должен начинаться со *, чтобы его ввод работал и для приложения Dial и для приложения Queue).

Выполнение этого сервисного кода во время управляемого перевода вызова позволит отменить перевод и вернуть вызов себе. В остальное время сервисный код будет недоступен, что предотвратит отбой вызоова из-за случайного ввода этого кода.— К опциям приложения Dial добавляется опция g, она нужна для того, чтобы выполнение диалплана продолжалось после завершения приложения Dial (кроме случая, когда уничтожается канал звонящего).

— Определяется номер переводящего (переменная TRANSFERER) и его контекст (переменная TR_CONT). Перевод осуществляется в контексте пользователя, выполняющего вызов.— Если переведённый вызов не был принят, проигрывается сообщение о том, что вызов будет переведён.

Если переводящий всё ещё на линии, он поймёт, что перевод не удался и сможет вернуть вызов сервисным кодом.— К CALLERID(name) добавляется префикс «XFER_FAIL: », чтобы пользователи видели, что это возврат после неудачного перевода.— Если номер переводящего свободен, то производится попытка возврата вызова на номер переводящего.

— Если переводящий занят или не принял вызов, то вызов возвращается в последнюю очередь, в которую он входил.— Если вызов ещё не был в очереди, он переводится на назначение по умолчанию (значение переменной TRANSFER_FAILOVER), в данном случае — очередь reception.

В результате, перевод вызова осуществляется следующим образом:неуправляемый перевод — во время разговора нужно набрать сервисный код ##, ввести номер адресата перевода и нажать # или подождать 4 секунды.управляемый перевод — во время разговора нужно нажать *, ввести номер адресата перевода и нажать # или подождать 4 секунды.

Если адресат перевода не принимает вызов, можно ввести сервисный код ** для отмены перевода и возврата вызова себе. Также можно положить трубку не дожидаясь ответа адресата, если он не ответит, вызов вернётся к переводящему или в очередь, если переводящий занят/не доступен/не взял трубку.

Настройка параметров сервисных кодов asterisk

Настройки сервисных кодов Asterisk находятся в файле features.conf, по умолчанию, сервисные коды следующие:управляемый перевод — не заданнеуправляемый перевод — #отбой вызова — *

Как видите, управляемым переводом вообще нельзя пользоваться по умолчанию. Вносим в раздел [featuremap] файла features.conf:

Для применения изменений в файле features.conf, нужно выполнить команду в CLI Asterisk «features reload»:

asterisk -rx «features reload»

Теперь имеем следующие сервисные коды:управляемый перевод — *неуправляемый перевод — ##отбой вызова — **

Схожесть кодов управляемого перевода и отбоя вызова не является проблемой, т.к. в описываемой схеме эти коды никогда не будут доступны пользователю одновременно.В разделе файла features.conf [general] указываются различные параметы сервисных кодов, обратите внимание на следующие:featuredigittimeout — максимальная задержка между вводом символов при наборе сервисных кодов в миллисекундах.

Значение по умолчанию — 1000, т.е. 1 секунда. Для ввода сервисных кодов, предлагаемых в этой статье, секунды должно хватить. Для ввода более сложных сервисных кодов пользователям может периодически не хватать времени, поэтому рекомендуется увеличить значение этого параметра до 2000.transferdigittimeout — максимальная задержка в секундах между вводом символов при наборе номера адресата перевода.

Значение по умолчанию — 3. Для более комфортного ввода номера, нужно увеличить это время до 4-5 секунд.Atxferdropcall — при значении по умолчанию «no», если при упарвляемом переводе переводящий кладёт трубку не дожидаясь ответа адресата перевода и адресат перевода так и не принимает вызов до достижения таймаута вызова (значение параметраatxfernoanswertimeout)

, Asterisk попытается вернуть вызов переводящему. Asterisk может пытаться вызвать переводящего определённое количество раз (значение параметра atxfercallbackretries) с определённым интервалом (значение параметра atxferloopdelay). Если установить значение параметра atxferdropcall равным «yes», то Asterisk не будет пытаться вернуть вызов переводящему после неудачного управляемого перевода.

Нужно установить значение «yes», если обработака вызова после неудачного перевода вызова реализована средствами диалплана.ПРИМЕЧАНИЕ: Стандартный механизм возврата вызова после неудачного управляемого перевода не очень хорош, т.к. он не проверяет, свободен ли абонент, на которого должен вернуться вызов, не позволяет выполнять диалплан и не имеет возможности перевести вызов кому-либо другому, если абонент, совершивший перевод, не берёт трубку. Рекомендуется использовать вместо этого возврат вызова, реализованный средствами диалплана.

Для примеров, приведённых в этой статье, использовались следующие значения параметров в разделе [general] файла features.conf:

Пример

 ; dial 307 = для перезапуска Asterisk
 ; Замечание: вместо Read() мы также можем использовать команду Authenticate() 
 exten => 307,1,DigitTimeout(4)         ; Установка Digit Timeout в 4 секунды
 exten => 307,2,ResponseTimeout(5)      ; Установка Response Timeout в 5 секунды
 ; Следующая команда проигрывает приглашение: "для перезапуска введите пароль"
 exten => 307,3,Read(Secret,posix-pass-restart-ast,3)   
 exten => 307,4,NoOp(${Secret})
 exten => 307,5,Gotoif($[${Secret} = 123]?6:9)
 exten => 307,6,Playback(posix-restarting) ; "Перезапуск asterisk"
 exten => 307,7,Wait(1)
 exten => 307,8,System(/usr/sbin/asterisk -rx reload)
 exten => 307,9,Hangup

С использованием dial()

Для всех номеров в диалплане после команды Dial выполняется проверка результатов звонка, и если переменная DIALSTATUS не равна ANSWER (т.е. абонент занят, недоступен, не ответил и т.п.), то выполняется следующая команда Dial, соединяющая абонента, например, с секретарем. В случае неответа секретаря (что тоже возможно) выполняется третья команда Dial и так далее.

; Файл extensions.conf:
[local-phones]
exten => _XXX,1,Answer()
exten => _XXX,n(begin),Dial(SIP/${EXTEN},240,tTg)
; g - после окончания вызова, независимо от результата, продолжить выполнение сценария
; если DIALSTATUS = Answer (ответ на вызов), то завершаем вызов:
exten => _XXX,n,GotoIf($["${DIALSTATUS}" = "ANSWER"]?end:) 
exten => _XXX,n,Dial(SIP/100,240,tTg)
; 100 - номер секретаря
exten => _XXX,n,GotoIf($["${DIALSTATUS}" = "ANSWER"]?end:) 
exten => _XXX,n,Dial(SIP/101,240,tTg)
; 101 - номер второго секретаря
exten => _XXX,n,GotoIf($["${DIALSTATUS}" = "ANSWER"]?end:) 
exten => _XXX,n,Dial(SIP/102,240,tTg)
; 102 - номер третьего секретаря
; если никуда не дозвонились - завершаем вызов (или можем сделать goto на begin и продолжать по кругу до бесконечности)
exten => _XXX,n(end),Hangup()

Включение attended и blind transfer

В функции features.conf вы должны настроить параметры blindxfer или atxfer в разделе Featuremap. Параметры настраиваются с помощью символьной строки DTMF, которую вы хотите использовать для доступа к этой функции.

[featuremap]
blindxfer = #1
atxfer = *2

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

В качестве примера, если вы хотите разрешить переводы через приложение Dial, вы можете использовать два варианта: «t» или «T».

• t – разрешить вызываемой стороне передавать вызывающую сторону, отправив последовательность DTMF, определенную в feature.conf. Этот параметр не выполняет принудительное выполнение политики при переводах, инициированных другими методами;
• T – разрешить вызывающей стороне передавать вызываемую сторону, отправив последовательность DTMF, определенную в features.conf. Этот параметр не выполняет принудительное выполнение политики при переводах, инициированных другими методами.

Установка этих параметров для Dial в extensions.conf будет выглядеть примерно так:

exten = 100,1,Dial(PJSIP/MAX,30,T)

Аргументы «t» и «T» работают для приложений Queue и Dial

С использованием attended transfer вместо blind transfer

Можно переделать attended transfer (сопровождаемый вызов), чтобы в случае неответа абонента вызов возвращался к тому, кто сделал перевод. Для этого в файле features.conf есть опции:

;atxfernoanswertimeout = 15
;atxferdropcall = no
;atxferloopdelay = 10
;atxfercallbackretries = 2

Рассмотрим ситуацию: абонент А звонит абоненту Б и пообщавшись с ним, просит перевести его на абонента С. Если абонент Б (делая attended transfer) дожидается ответа абонента С, возможно общается с ним, и отключается – то абоненты А и С связываются между собой и общаются. Это стандартный сопровождаемый перевод.

Если же абонент Б делает attended transfer на абонента С и сразу (не дожидаясь ответа) кладет трубку, то получается примерно та же ситуация, что и в случае blind transfer. Однако, всё хорошо только в случае, если абонент С снял трубку (или абонент А не дождавшись ответа, положил трубку сам).

atxferdropcall = yes – после неответа абонента С (или если этот абонент занят / сбросил вызов) происходит разрыв соединения, и абоненту А надо снова совершать вызов.

atxferdrpcall = no – теоретически, после неответа (или занятости/сброса вызова) абонента С, вызов абонента А должен вернуться обратно.

Blind transfer (unattended)

В случае “слепого” перевода всё сложнее: оператор переводит абонента А на абонента Б, и сразу после перевода отключается от разговора. При этом абонент А остается предоставлен судьбе: если абонент Б ему отвечает, то всё хорошо. Если же нет (например, абонент Б занят или не отвечает), то у абонента А в трубке раздаются короткие гудки, после чего ему остается только повесить трубку и попытаться еще раз дозвониться до оператора.

Функции передачи, предоставляемые ядром Asterisk, настраиваются в файлах .conf и доступны по кодами функций.

Технологии драйвера канала, такие как chan_sip и chan_pjsip, имеют встроенную возможность для различных типов трансфера. Эта встроенная функциональность переноса не зависит от функциональности передачи ядра. Функциональность передачи кода основной функции не зависит от канала.

Похожее:

AEL examples Теоретический материал. Debug.exe ‑ программа отладчик ,которую используют для проверки и отладки выполняемых — Мегаобучалка Как использовать команду Netstat Octa core android отзывы