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

Описание:

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

1. Оповещение о входящем звонке
2. Исходящий звонок по клику из CRM
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. Выполним подключение по SSH к серверу IP АТС Asterisk для выполнения дальнейшей настройки. В зависимости от используемой системы(Windows, Linux, MacOS), подключение по SSH можно выполнить с использованием различного дополнительного программного обеспечения(Putty), либо системного терминала.

5. Облачный сервис 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

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

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

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

# ./toservice_run 1.1.1.1

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

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

# 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 — часовой пояс для корректного прописывания времени создаваемого события в Мегаплан CRM
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)

9. Для корректного обращения к записям разговоров необходимо создать дополнительный 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

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

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

11. Если запуск модуль коннектора прошел успешно, то выполним предварительную настройку CRM, для этого пройдем авторизацию в Мегаплан с правами администратора и перейдем в меню Учетная запись →Расширения →Интеграция с Asterisk → Установить

12. После успешной установки расширения необходимо получить значения UUID и Token для последующего проведения интеграции, для этого перейдем в меню Учетная запись →Настройки →Интеграция →Телефония →Настройки телефонии и скопируем необходимые значения

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

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

UUID — значение UUID учетной записи полученный в п.12 данной статьи
API Token — API токен полученный в п.12 данной статьи

О успешности прохождения авторизации будет свидетельствовать сообщение о прохождении полной синхронизации.

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

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

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

После успешного импортированния списка сотрудников из CRM, переведем необходимых сотрудников в статус активности и назначим внутренний номер из выпадающего списка при редактировании

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