artem
01.02.2017
6537

Реализация custom callback в elastix.

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

Другими словами, при входящем звонке в голосовом приветствии абоненту предлагается либо повесить трубку , либо нажать какую-либо клавишу для того чтобы система сама перезвонила абоненту. Для абонента он будет входящим, то есть бесплатным.

Такую схему часто используют различные службы и предприятия (такси, интернет магазины, контакт — центры и проч.) для удержания клиентов, при этом абонент не «висит» долго на линии и не тратит свои деньги на исходящую связь.

В Elastix и Asterisk для этого используются так называемые call-файлы. По сути это обычные текстовые файлы с расширением .call.

Структура этих файлов следующая:
Channel: : Канал, который будет использоваться для исходящего вызова.
CallerID: CallerID содержащий имя и/или номер абонент
MaxRetries: Количество попыток перед тем, как вызов будет считаться неудачным (не включая первую попытку, т.е. 0 = означает совершить 1 попытку вызова). Значение по умолчанию: 0.
RetryTime: Количество секунд между попытками вызова.Значение по умолчанию: 300 (5 минут)
WaitTime: Количество секунд для ожидания ответа на вызов. Значение по умолчанию: 45.
Account: Установка поля “account code”для записи в CDR.
Context: Контекст в файле extensions.conf.
Extension: Название екстеншена в extensions.conf..
Priority: Номер приоритета для екстеншена, с которого нужно начать выполнение.
Set: Установка переменных канала для использования их в логике обработки вызова на заданный екстеншен
Application: Имя приложения Asterisk, которое необходимо выполнить.
Data: Параметры для запускаемого приложения.
AlwaysDelete: Yes/No – Если время модификации .call файла больше текущего, то этот файл не будет удален.
Archive: Yes/No – Переносить или нет .call файл в поддиректорию «outgoing_done» с установленным значением поля «Status: значение», где значение может быть: Completed, Expired или Failed.

Если мы поместим этот файл в каталог /var/spool/asterisk/outgoing, то он будет немедленно исполнен, чего делать нельзя, поэтому создадим отдельный каталог для временного хранения файла и пропишем задания для crontab, чтобы он, например, каждую минуту перемещал call файл на исполнение.

Теперь к практике.
Есть некая очередь 700, есть IVR c голосовым приветствием «…если вы хотите , что бы мы вам перезвонили — нажмите клавишу 0 …» , необходимо сделать так , чтобы после нажатия 0 астериск сделал 5 попыток дозвона до оператора , при этом уведомив его , что это коллбэк , а не прямой дозвон. После того , как оператор снимет трубку — вызвать внешнего абонента.

Отредактируем файл /eetc/asterisk/extensions_custom.conf ,добавим в него контекст call-back, добавим из файла extensions_additional.conf используюмую IVR, а также контекст в котром располагаются очереди, по умолчанию это контекст ext-queues, также нам нужно создать вспомогательный конекст, который будет использоваться в качестве нашего канала.

Получаем следующее:

[call-back] — это наш основной контекст
exten =>s,1,System(echo -e «Extension: ${CALLERID(num)}\nCallerID:!!!Call Back!!! <${CALLERID(num)}>\ nMaxRetries: 10\nWaitTime: 60000\nContext: from-internal\nChannel: Local/s@from-script-n\nRetryTime: 600» > /var/spool/asterisk/out/${UNIQUEID}.call)

[from-script-n] — вспомогательный контекст для канала
exten = s,1,Goto(ext-queues1,700,1)

[ivr-3] ; Unnamed — наша IVR
include => ivr-3-custom
include => from-did-direct-ivr
exten => 0,1,Goto(call-back,s,1) – здесь указывается какую клавишу нажать и куда перейти
exten => s,n,Set(_IVR_CONTEXT_${CONTEXT}=${IVR_CONTEXT})
exten => s,n,Set(_IVR_CONTEXT=${CONTEXT})
exten => s,n,Set(__IVR_RETVM=)
exten => s,n,GotoIf($[«${CDR(disposition)}» = «ANSWERED»]?skip)
exten => s,n,Answer
exten => s,n,Wait(1)
exten => s,n(skip),Set(IVR_MSG=)
exten => s,n(start),Set(TIMEOUT(digit)=3)
exten => s,n,ExecIf($[«${IVR_MSG}» != «»]?Background(${IVR_MSG}))
exten => s,n,WaitExten(10,)
exten => i,1,Playback(sorry-youre-having-problems)
exten => i,n,Goto(hang,1)
exten => t,1,Playback(sorry-youre-having-problems)
exten => t,n,Goto(hang,1)
exten => return,1,Set(_IVR_CONTEXT=${CONTEXT})
exten => return,n,Set(_IVR_CONTEXT_${CONTEXT}=${IVR_CONTEXT_${CONTEXT}})
exten => return,n,Set(IVR_MSG=)
exten => return,n,Goto(s,start)
exten => h,1,Hangup
exten => hang,1,Playback(vm-goodbye)
exten => hang,n,Hangup
;—== end of [ivr-3] ==—;

[ext-queues1]
include => ext-queues-custom
exten => 700,1,Macro(user-callerid,)
exten => 700,n,Answer
exten => 700,n,Macro(blkvm-set,reset)
exten => 700,n,ExecIf($[«${REGEX(«(M[(]auto-blkvm[)])» ${DIAL_OPTIONS})}» != «1»]?Set(_DIAL_OPTIONS=${DIAL_OPTIONS}M(auto-blkvm)))
exten => 700,n,Set(__NODEST=${EXTEN})
exten => 700,n,Set(QCIDPP=${IF($[${LEN(${VQ_CIDPP})}>0]?${VQ_CIDPP}: )})
exten => 700,n,Set(VQ_CIDPP=)
exten => 700,n,ExecIf($[«${QCIDPP}»!=»»]?Macro(prepend-cid,${QCIDPP}))
exten => 700,n,Set(QAINFO=${IF($[${LEN(${VQ_AINFO})}>0]?${VQ_AINFO}: )})
exten => 700,n,Set(VQ_AINFO=)
exten => 700,n,ExecIf($[«${QAINFO}»!=»»]?Set(__ALERT_INFO=${QAINFO}))
exten => 700,n,Set(QJOINMSG=${IF($[${LEN(${VQ_JOINMSG})}>0]?${IF($[«${VQ_JOINMSG}»!=»0″]?${VQ_JOINMSG}: )}: )})
exten => 700,n,Set(VQ_JOINMSG=)
exten => 700,n,Set(QMOH=${IF($[«${VQ_MOH}»!=»»]?${VQ_MOH}:none)})
exten => 700,n,Set(VQ_MOH=)
exten => 700,n,ExecIf($[«${QMOH}»!=»»]?Set(__MOHCLASS=${QMOH}))
exten => 700,n,ExecIf($[«${MOHCLASS}»!=»»]?Set(CHANNEL(musicclass)=${MOHCLASS}))
exten => 700,n,Set(QCANCELMISSED=C)
exten => 700,n,Set(QRINGOPTS=r)
exten => 700,n,Set(QRETRY=${IF($[${LEN(${VQ_RETRY})}>0]?${VQ_RETRY}: )})
exten => 700,n,Set(VQ_RETRY=)
exten => 700,n(qoptions),Set(QOPTIONS=${IF($[${LEN(${VQ_OPTIONS})}>0]?${VQ_OPTIONS}:t)}${QCANCELMISSED}${QRINGOPTS}${QRETRY})
exten => 700,n,Set(VQ_OPTIONS=)
exten => 700,n(qgosub),Set(QGOSUB=${IF($[${LEN(${VQ_GOSUB})}>0]?${VQ_GOSUB}:${QGOSUB})})
exten => 700,n,Set(VQ_GOSUB=)
exten => 700,n(qagi),Set(QAGI=${IF($[${LEN(${VQ_AGI})}>0]?${VQ_AGI}:${QAGI})})
exten => 700,n,Set(VQ_AGI=)
exten => 700,n(qrule),Set(QRULE=${IF($[${LEN(${VQ_RULE})}>0]?${IF($[«${VQ_RULE}»!=»0″]?${VQ_RULE}: )}:${QRULE})})
exten => 700,n,Set(VQ_RULE=)
exten => 700,n(qposition),Set(QPOSITION=${IF($[${LEN(${VQ_POSITION})}>0]?${VQ_POSITION}:${QPOSITION})})
exten => 700,n,Set(VQ_POSITION=)
exten => 700,n,Set(MONITOR_OPTIONS=b)
exten => 700,n,Gosub(sub-record-check,s,1(q,700,dontcare))
exten => 700,n,Set(__CWIGNORE=TRUE)
exten => 700,n,ExecIf($[«${QJOINMSG}»!=»»]?Playback(${QJOINMSG}, ))
exten => 700,n,QueueLog(700,${UNIQUEID},NONE,DID,${FROM_DID})
exten => 700,n,Set(QAANNOUNCE=${IF($[${LEN(${VQ_AANNOUNCE})}>0]?${IF($[«${VQ_AANNOUNCE}»!=»0″]?${VQ_AANNOUNCE}: )}:custom/priv-trying )})
exten => 700,n,Set(VQ_AANNOUNCE=)
exten => 700,n,Set(QMAXWAIT=${IF($[${LEN(${VQ_MAXWAIT})}>0]?${VQ_MAXWAIT}: )})
exten => 700,n,Set(VQ_MAXWAIT=)
exten => 700,n,Set(QUEUENUM=700)
exten => 700,n,Set(QUEUEJOINTIME=${EPOCH})
exten => 700,n(qcall),Queue(700,${QOPTIONS},,${QAANNOUNCE},${QMAXWAIT},${QAGI},,${QGOSUB},${QRULE},${QPOSITION})
exten => 700,n,Macro(blkvm-clr,)
exten => 700,n,Gosub(sub-record-cancel,s,1())
exten => 700,n,Set(__NODEST=)
exten => 700,n,Set(_QUEUE_PRIO=0)
exten => 700,n,Set(MONITOR_OPTIONS=)
exten => 700,n,Set(__CWIGNORE=)
exten => 700,n,Set(QRINGOPTS=)
exten => 700,n,Set(QDEST=${VQ_DEST})
exten => 700,n,Set(VQ_DEST=)
exten => 700,n(gotodest),GotoIf($[«${QDEST}»=»»]?ext-queues,400,1:${CUT(QDEST,^,1)},${CUT(QDEST,^,2)},${CUT(QDEST,^,3)})
exten => 700*,1,Macro(agent-add,700,)
exten => 700**,1,Macro(agent-del,700)

SettingsВ самом elastix в настройках очереди необходимо указать следующий параметр
Для того чтобы клиентам приходило сообщение о возможности заказа обратного звонка.

И последнее что нам осталось сделать — это дать задание для crontab

crontab -e
*/1 * * * * mv /var/spool/asterisk/out/*.call /var/spool/asterisk/outgoing/

Книга 101 функция Asterisk
Познакомьтесь с возможностями Asterisk. Найдите инструменты, которые помогут вашей компании развиваться.
Скачать книгу
Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

Остались вопросы?

Я - Компаниец Никита, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование


ближайшие курсы

10 доводов в пользу Asterisk

Распространяется бесплатно.

Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.

Безопасен в использовании.

Любое программное обеспечение может стать объектом интереса злоумышленников, в том числе телефонная станция. Однако, сам Asterisk, а также операционная система, на которой он работает, дают множество инструментов защиты от любых атак. При грамотной настройке безопасности у злоумышленников нет никаких шансов попасть на станцию.

Надежен в эксплуатации.

Время работы серверов некоторых наших клиентов исчисляется годами. Это значит, что Asterisk работает несколько лет, ему не требуются никакие перезагрузки или принудительные отключения. А еще это говорит о том, что в районе отличная ситуация с электроэнергией, но это уже не заслуга Asterisk.

Гибкий в настройке.

Зачастую возможности Asterisk ограничивает только фантазия пользователя. Ни один конструктор шаблонов не сравнится с Asterisk по гибкости настройки. Это позволяет решать с помощью Asterisk любые бизнес задачи, даже те, в которых выбор в его пользу не кажется изначально очевидным.

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.

Повышает управляемость бизнеса.

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

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.