artem
04.10.2018
3454

Настройка связки RichCall и Asterisk

RichCall — программный продукт, предназначенный для организации видеозвонков с сайта, разработан компанией Aurus (https://aurus5.ru/richcall/). В этой статье будет описана настройка связки RichCall и Asterisk.

Связь RichCall и Asterisk

Описание связки и исходные данные

Между RichCall и Asterisk будет настроено обычное SIP-соединение, через которое во время видеозвонка будет передаваться только звук. Полная запись сессии с видео, звуком и прочими данными, переданными во время вызова, будет доступна на сервере RichCall, на сервере Asterisk может быть получена только запись звука. Соответственно, оператор, ответивший на вызов, сможет говорить, например, через гарнитуру, подключенную к IP-телефону, а видео во время звонка будет отображено в интерфейсе оператора RichCall. Также, по значению заголовка P-Asserted-Identity сервер RichCall определяет, какой оператор ответил на вызов.

В приведённой инструкции считается, что сервер Asterisk доступен для сервера RichCall по IP-адресу 192.168.101.10 и использует для обмена SIP-сообщениями стандартный порт 5060. Для приёма видеозвонков на сервере Asterisk настроена очередь 900 с тремя операторами — 101, 102 и 103. Также инструкция составлена с учётом того, что на сервере Asterisk установлен web-интерфейс FreePBX.

Настройки на стороне Asterisk

На стороне Asterisk нужно сперва настроить SIP-соединение с регистрацией для подключения RichCall, пример ниже:

[rich_call]
type=peer
host=dynamic
defaultuser=rich_call
secret=some_strong_password
context=from-rich-call
directmedia=no
nat=yes
allow=!all,alaw,ulaw
qualify=yes
sendrpid=pai

Параметр sendrpid=pai нужен для того, чтобы Asterisk передавал RichCall информацию из CONNECTEDLINE в заголовке P-Asserted-Identity.
Также нужно добавить в глобальные настройки chan_sip (раздел [general] в файле sip.conf или подраздел Settings → Asterisk SIP Settings, если используется FreePBX) параметр match_auth_username=yes, т.к. при входящем звонке от RichCall в поле From будет указан ID сессии, а не имя пользователя «rich_call».

Далее нужно описать контекст from-rich-call:

[from-rich-call]
exten => _.,1,Set(__RICHCALL_VIDEO_CALL=true)
same => n,Goto(from-trunk,${EXTEN},1)

В контексте from-rich-call просто задаётся переменная RICHCALL_VIDEO_CALL с наследованием, чтобы звонки от RichCall можно было отличить от других звонков, затем делается переход в контекст from-trunk. В FreePBX в подразделе «Inbound Routes» нужно будет создать маршрут для DID=900, ведущий в очередь 900.

Теперь нужно озаботиться тем, чтобы функция CONNECTEDLINE для звоноков от RichCall вызывалась только в момент ответа на вызов. RichCall реагирует только на первое сообщение с заголовком P-Asserted-Identity и считает, что номер, указанный в заголовке, ответил на вызов. Проблема в том, что в диалплане FreePBX по умолчанию функция CONNECTEDLINE вызывается в контексте macro-dial-one прямо перед совершением вызова — если не избавиться от этого поведения, видео всегда будет передаваться первому вызванному оператору, даже если он не ответит на вызов (естественно, это неприемлемо).
Чтобы устранить описанную проблему, нужно сделать оверрайд контекста macro-dial-one, для этого скопируйте контекст целиком из файла extensions_additional.conf в файл extensions_override_freepbx.conf. Затем найдите в контексте следующее условие (после этого условия должны быть вызовы функции CONNECTEDLINE):

exten => s,n,GotoIf($[«${DB(AMPUSER/${EXTTOCALL}/cidname)}» = «» || «${DB(AMPUSER/${AMPUSER}/cidname)}» = «»]?godial)

Добавьте сразу после этого условия следующее условие:

exten => s,n,GotoIf($[«${RICHCALL_VIDEO_CALL}» = «true»]?godial)

Мы добились того, чтобы CONNECTEDLINE не вызывался перед вызовом оператора, теперь нужно сделать так, чтобы CONNECTEDLINE вызывался в момент ответа на вызов. Проще всего использовать для этого контекст macro-auto-blkvm — он вызывается в момент ответа на вызов из очереди. Скопируйте контекст macro-auto-blkvm в файл extensions_override_freepbx.conf и добавьте в конец контекста следующие строки:

exten => s,n,ExecIf($[«${RICHCALL_VIDEO_CALL}» != «true»]?MacroExit)
exten => s,n,Set(MASTER_CHANNEL(CONNECTEDLINE(num))=${DIALEDPEERNUMBER})

RichCall требуется только номер оператора, поэтому CONNECTEDLINE(name) не нужно вызывать.

Описанное решение проблемы с CONNECTEDLINE подходит только для обычного сценария вызова номера из очереди, используемого в FreePBX. Решение для других сценариев (вызов с использованием Follow Me, вызов из очереди без использования канала Local и т.д.) не будет рассмотрено в рамках данной статьи.

Настройки на стороне RichCall

Ниже описаны минимальные настройки для того, чтобы заработал видеозвонок, описание остальных настроек RichCall можно прочитать в инструкции, прилагаемой к нему. Все настройки RichCall выполняются через web-интерфейс.

Зайдите в раздел «ICE settings» и добавьте пару STUN-серверов (можно использовать те же публичные STUN-серверы, которые указаны на скриншоте ниже):

Зайдите в раздел «IP-PBX», добавьте новое соединение с АТС и внесите параметры SIP-соединения, созданного ранее на стороне Asterisk:

Name — произвольное название соединения с АТС
Type — тип соединения, выберите «External», т.к. не используете встроенную АТС RichCall
Line number — внутренний номер, на который будут направляться вызовы
IP address — адрес сервера Asterisk
Transport — выберите UDP (с TCP у меня возникла проблема в том, что сервер RichCall не отправлял ACK в ответ на сообщения, которые этого требуют)
Call transfer signalling is supported — означает, что сервер RichCall будет определять ответившего оператора по значению заголовка P-Asserted-Identity (или Remote-Party-ID)
Use SIP Auth — включает регистрацию на сервере телефонии
User name и Password — укажите логин и пароль своего SIP-соединения
После сохранения настроек соединения, RichCall должен зарегистрироваться на Asterisk, если этого не произошло, устраните проблему прежде, чем продолжать настройку.

Зайдите в раздел «Agents» и добавьте учётную запись для каждого оператора очереди:

Name — произвольное название учётной записи
Line number — внутренний номер оператора на Asterisk
Login name — логин оператора в интерфейсе оператора RichCall (длина логина должна быть не менее пяти символов)
Password — пароль оператора в интерфейсе оператора RichCall

Для направления входящих звонков в Asterisk, зайдите в раздел «Question categories» и создайте новое меню с произвольным названием (в примере ниже — «inbound_calls»), после того как укажите название и сохраните меню, появятся остальные настройки. Теперь к меню нужно добавить категорию вопросов, название тоже произвольное (в примере ниже — «all»), в пункте IP-PBX сразу будет выбрано единственное созданное соединение с АТС, DTMF последовательность указывать не нужно:

Сохраните категорию вопросов, установите в настройках меню флажок «Use by default», должно получиться так:

Ещё раз сохраните настройки меню — входящие вызовы в RichCall теперь должны поступать на Asterisk.

Настройка RichCall завершена, код виджета из раздела «Widget» нужно разместить на web-странице и можно тестировать видеозвонки.

Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

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

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

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

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

ближайшие Вебинары

ONLINE

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