Интеграция Asterisk c PlanFix через облачный сервис Telefum24

В прошлой статье мы рассмотрели интеграцию Asterisk и Planfix через облачный сервис Simplit.io, но данная интеграция обладала рядом недостатков:

1. Необходимость открытия AMI во внешнюю сеть
2. Отсутствует возможность дебажинга интеграции без помощи технической поддержки сервиса
3. Нестабильность соединения облачного сервиса с сервером Asterisk

В рамках данной статьи будет рассмотрено как выполнить интеграцию Asterisk 13 с PlanFix. Возможности интеграции:

1. Оповещение о входящем звонке
2. Исходящий звонок по клику из PlanFix
3. История звонков в карточке контакта
4. Детальная информация о звонке
5. Управление бизнес-процессом из карточки звонка
6. Формирование статистики звонков с доступ к записям разговоров из личного кабинета облачного сервиса Telefum24
7. Расширенная конфигурирование интеграции

Инструкция:

1. Необходимо создать AMI пользователя в Asterisk, для этого перейдём в WEB панель управления FreePBX через интернет обозреватель(Opera, Firefox, Google Chrome, Yandex Browser….) по ссылке вида: http://IP_адрес_сервера_Asterisk/ В примере ссылка имеет вид: http://192.168.170.163/

2. Пройдём авторизацию во FreePBX, нажмём «FreePBX Administration», введем «username и password» и нажмём «Continue»

3. Перейдём к созданию AMI пользователя. Для этого перейдём в меню «Settings»→»Asterisk Manager Users»→ «Add Manager»→ «Submit»→ «Apply Config», где основные поля для заполнения:

Manager name — имя AMI пользователя(логин)
Manager secret — пароль AMI пользователя
Deny — запрещённые подсети для обращения по AMI
Permit — разрешенные подсети для обращения по AMI 127.0.0.1/255.255.255.255, 5.200.55.23/255.255.255.255 и 176.122.20.120/255.255.255.255

4.Выполним предварительную настройку PlanFix, для этого пройдем авторизацию с учетной записью с правами администратора и Меню->Управление аккаунтом->Интеграция с другими сервисами->Виртуальные АТС

5.Найдем пункт интеграции  «Telefum24-Asterisk», активируем данный пункт и перейдем в настройки. Из раздела настроек необходимо скопировать и сохранить «Название аккаунта» и «Ключ авторизации (token) ПланФикса», а так же прописать следующие настройки:

Короткие номера сотрудников — необходимо выполнить закрепление сотрудника за внутренним номером используемым на Asterisk
Записи разговоров — в зависимости от выбранного параметра, возможно хранить записи разговоров на АТС или загружать в PlanFix

6.Выполним подключение по SSH к серверу IP АТС Asterisk для выполнения дальнейшей настройки. В зависимости от используемой системы(Windows, Linux, MacOS), подключение по SSH можно выполнить с использованием различного дополнительного программного обеспечения(Putty), либо системного терминала.

7. Облачный сервис Telefum24 осуществляет подключение к Asterisk через дополнительный модуль коннектор по портам 9000(TCP) и 9500(TCP), необходимо разрешить обращения с IP адресов облачного сервиса  5.200.55.23, 176.122.20.120 на данные порты. Для этого выполним в терминале ряд команд вида:

# iptables -I INPUT -p tcp -s 5.200.55.23 --dport 9000 -j ACCEPT
 # iptables -I INPUT -p tcp -s 5.200.55.23 --dport 9500 -j ACCEPT
 # iptables -I INPUT -s 176.122.20.120 -p tcp -m tcp --dport 9500 -j ACCEPT
 # iptables -I INPUT -s 176.122.20.120 -p tcp -m tcp --dport 9000 -j ACCEPT
 # service iptables save

8.Выполним установку модуль коннектора на сервер телефонии:

# mkdir /usr/src/telefum
 # cd /usr/src/telefum
 # wget http://telefum.com/EugenyData/webserver/redhat_pbx/toservice_run
 # chmod 755 toservice_run

9.После успешного скачивания модуль-коннектора необходимо выполнить его запуск с указанием внешнего IP адреса АТС

# ./toservice_run 1.1.1.1

где 1.1.1.1 — это внешний IP АТС(указыватся даже если АТС находится за NAT)

10.Приступим к конфигурированию модуль коннектора:

# cd /usr/src/telefum/toapi_server
 # nano mysql.ini

Выполним редактирование следующих параметров:
<login> — логин подключения к базе данных Asterisk
<password> — пароль подключения к базе данных Asterisk
<database> — имя базы данных Asterisk(по умолчанию: asteriskcdrdb)

# nano pbxserver_config.ini

В данном конфигурационном файле необходимо прописать только внешний IP Asterisk в соответствии со скриншотом:

где 1.1.1.1 — это внешний IP АТС (указываться даже если АТС находится за NAT)

# nano pbxserver2_config.ini

В данном конфигурационном файле так же необходимо прописать только внешний IP Asterisk в соответствии со скриншотом:

где 1.1.1.1 — это внешний IP АТС (указываться даже если АТС находится за NAT)

# nano ast_config.ini

где потребуется изменить ast_timezone — часовой пояс для корректного прописывания времени создаваемого события в PlanFix
call_history.recording_add_path — путь к записям разговора по http по порту 8080

Для возможности осуществления исходящих звонков выполним редактировании конфигурационного файла makecall

# nano makecall.txt

где потребуется изменить Channel — в зависимости от используемого протокола или технологии подключения внутренних номеров(SIP, IAX, Dahdi….)
Context – контекст для исходящих вызовов(по умолчанию: from-internal)

# nano transfer_call.txt

где потребуется изменить Context – контекст для исходящих вызовов(по умолчанию: from-internal)

11.Для корректного обращения к записям разговоров необходимо создать дополнительный VirtualHost в Apache.

# nano +1500 /etc/httpd/conf/httpd.conf

Добавить следующие строки:

NameVirtualHost *:8080
Listen 8080
<VirtualHost *:8080>
DocumentRoot /var/www/html/monitor
<Directory /var/www/html/monitor>
RewriteEngine off
Options +FollowSymLinks
</Directory>
</VirtualHost>

# mkdir /var/www/html/monitor
 # cd /var/www/html/monitor
 # ln -s /var/spool/asterisk/monitor

12. После описанных всех действий можно выполнить первый запуск модуль коннетора, для этого выполним ряд команд вида:

# cd /usr/src/telefum/toapi_server/
 # ./pbxserver_autorun
 # ps aux | grep pbx

13.Если запуск модуль коннектора прошел успешно, то приступим к конфигурированию интеграции в личном кабинете Telefum24, для этого перейдем по адресу https://www.online.telefum.com/auth через любой удобный интернет обозреватель(Google Chrome, Firefox, Opera, Yandex Browser…..) и пройдем процедуру авторизации введя логин и пароль:

14.Перейдем к добавлению интеграции с PlanFix, для этого нажмем «Добавить CRM» из выпадающего списка поля «тип CRM» выберем «PlanFix» и перейдем к следующему шагу настройки, заполним следующие данные и нажмем «Авторизоваться»:

Логин администратра — логин учетной записи PlanFix с правами администратора
Пароль администратора — пароль  учетной записи PlanFix с правами администратора
Название аккаунта — адрес портала PlanFix
Ключ авторизации — token полученный в п.9 данной статьи

15.Успешно добавив данные авторизации с PlanFix, перейдем к добавлению интеграции с Asterisk. Для этого вернемся в раздел «Общие»->«Добавить интеграцию»,  из выпадающего списка поля «Интеграция» выберем «Asterisk» и перейдем к следующему шагу настройки, заполним следующие данные и нажмем «Сохранить»:

Хост — внешний IP сервера Asterisk
Логин AMI – имя AMI пользователя полученного в п.3 данной статьи
Пароль AMI – пароль  AMI пользователя полученного в п.3 данной статьи

16.Перейдем к завершающему шагу сопоставления внутренних номеров и сотрудников компании, для этого перейдем в раздел «Сотрудники»->«Импортировать из CRM» в выпадающем списке выберем добавленную интеграцию с PlanFix и нажмем «Импортировать», данными действиями мы импортируем весь список сотрудников внесенных в Планфикс.

Напротив требуемого сотрудника нажмем редактировать и выполним назначение внутреннего номера.

17.При поступлении входящего звонка с городской линии на закрепленный за ним внутренний номер, в PlanFix будет отображена карточка шаблона: