Александр Мисюрин
14.10.2019
4872

Настройка уведомлений через curl сообщений, полученных в SIP Header

В данной статье рассмотрим возможность реализации отправки сообщений, полученных из SIP Header в стороннюю систему учета заявок. В заголовке SIP пакета можно передавать различные данные, очень часто провайдеры телефонии используют это поле для передачи номера, при схеме подключения peer-to-peer и множестве номеров в одном подключении. Также в данном поле можно передавать другую полезную информацию, которую […]

Уведомления через curl сообщений от SIP Header

В данной статье рассмотрим возможность реализации отправки сообщений, полученных из SIP Header в стороннюю систему учета заявок.

В заголовке SIP пакета можно передавать различные данные, очень часто провайдеры телефонии используют это поле для передачи номера, при схеме подключения peer-to-peer и множестве номеров в одном подключении. Также в данном поле можно передавать другую полезную информацию, которую можно использовать как в простом отображении на телефонах операторов, так и для различных систем статистики/учета заявок/CRM систем.

Для получения данных в диалплане asterisk используется функция:

${SIP_HEADER(<name>)}
Данный функционал работает даже на старых версиях. В примере используется: asterisk 1.8, FreePBX 2.9. А также, использовалась статья: voxlink.ru/kb/asterisk-configuration/diversion/(откроется в новой вкладке)

Где в качестве <name> указывается необходимое поле. Проверить какие поля приходят к вам в заголовке можно с помощью утилиты sngrep, tcpdump или просто включить в консоли asterisk -> sip set debug <peer> (на необходимый транк).

Поля на вашу АТС приходят в заголовках пакета INVITE.

Sip headers
Sip headers

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

[from-trunk-pre]
exten => _X.,1,NoOp(${SIP_HEADER(x-header)})
same => n,Set(r_name=${SIP_HEADER(x-header)});присваиваем в переменную значение поля
same => n,Set(rname=${CUT(r_name,:,2-)});отрезаем все, что после символа :
same => n,Set(__rname=${REPLACE(rname,\",):0:-1});удаляем все символы “ и назначаем наследуемую переменную
same => n,NoOp(==  ${rname}  ==);выводим полученное значение
same => n,Goto(from-trunk,${EXTEN},1)
Важно, данный метод основывается на том, что формат присылаемого заголовка не изменится, соответственно вырезаться будет именно нужная часть. Если заголовок будет изменяться, лучше прибегнуть к регулярным выражениям и использованию скриптов.

Ниже пример реализации с некоторыми доработками:

Вызов с получением заголовка
Вызов с получением заголовка

Переменная необходима наследуемая, поскольку в дальнейшем вызов может быть переведен и не только средствами АТС, следовательно, переменную необходимо сохранить для всех наследующих каналов.

Отправка curl запроса в данном примере реализована через override базового диалплана, в частности при вызове каждого внутреннего номера из очереди.

Можно реализовать и при общем вызове на очередь, однако в таком случае получить номер оператора можно лишь при завершении вызова, что поможет определить только реально произошедший вызов и не инициировать отправку для каждого оператора.
[from-queue]
exten => _.,2,Set(WWWURL=https://user:[email protected]/index.php?number=${CALLERID(num):1}\&operator=${QAGENT})
exten => _.,n,ExecIf($["${rname}"!=""]?Set(WWWURL=https://user:[email protected]/index.php?number=${CALLERID(num):1}\&operator=${QAGENT}\&rname=${rname}));если переменная из заголовка не пуста, прописываем ее в строку
exten => _.,n,ExecIf($[${LEN(${CALLERID(num):1})}=10 & ${LEN(${EXTEN})}=2]?Set(result=${SHELL(curl --connect-timeout 2 --max-time 2 --retry 0 --retry-delay 0 ${WWWURL})}));если вызов не локальный (проверяем по длине номера), отправляем curl запрос
exten => _.,n,ExecIf($["${result}"=""]?NoOp(CURL ERROR))
exten => _.,n,Set(CHANNEL(musicclass)=New-MOH)
exten => _.,n,Goto(${NODEST},1)
Пример вызова в логе asterisk
Пример вызова в логе asterisk
Все звонки на операторов из очереди будут проходить этот контекст, необходимо добавлять условие срабатывания, в данном примере отправка осуществляется в любом случае, просто с разными наборами данных.

При входящем вызове на очередь и наличии переменной, отправляем ее с помощью curl на необходимый адрес, на котором реализован обработчик.

Если не используется очередь во входящем маршруте, то необходимо дополнить либо macro-dial-one, либо вызывать отправку запроса по какому либо событию, что рассмотрим в следующей статье.
Подписаться
Уведомить о
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 сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.