Кирилл Золотавин
11.06.2019
2277

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

Описание: В рамках данной статьи будет рассмотрено как выполнить интеграцию Asterisk 13 с AmoCRM средствами облачного сервиса Telefum24. Возможности интеграции: 1. Оповещение о входящем звонке 2. Исходящий звонок по клику из AmoCRM 3. История звонков в карточке контакта 4. Детальная информация о звонке 5. Управление бизнес-процессом из карточки звонка 6. Формирование статистики звонков с доступ […]

Описание:

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

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

Все описанные действия в статье необходимо выполнять от имени суперпользователя (root). Установка и настройка производилась на предустановленной системе CentOS 6.9 + Asterisk 13 + FreePBX 13.

Инструкция:

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


WEB панель FreePBX.

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


Авторизация во FreePBX.

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

Переход в меню «Settings»→»Asterisk Manager Users»
Добавление менеджера
Заполнение основных параметров AMI пользователя
Ограничение прав AMI пользователя.
Применение внесенных изменений
Установка слабого пароля для AMI пользователя и установка 0.0.0.0/0 подсети в качестве разрешенной может привести к несанкционированному доступу к серверу телефонии.

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
Настройка Iptables.
Если сервер Asterisk расположен за NAT, то помимо разрешения портов в Iptables, так же потребуется выполнить проброс портов на сетевом оборудовании.

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

# mkdir /usr/src/telefum
# cd /usr/src/telefum
# wget http://telefum.com/EugenyData/webserver/redhat_pbx/toservice_run
# chmod 755 toservice_run
Скачивание модуль коннектора Telefum24

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)

Во FreePBX Distro данные подключения к базе данных можно взять с конфигурационного файла FreePBX /etc/freepbx.conf

Настройка подключения к MySQL
# nano pbxserver_config.ini

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

Настройка конфигурационного файла pbxserver

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

# nano pbxserver2_config.ini

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

Настройка конфигурационного файла pbxserver2

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

# nano ast_config.ini

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

Редактирование  конфигурационного файла ast_config

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

# nano makecall.txt

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

Редактирование  конфигурационного файла ast_config

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

# nano makecall.txt

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

Редактирование  конфигурационного файла makecall
# nano transfer_call.txt

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

Редактирование  конфигурационного файла transfer_call

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
Добавление VirtualHost

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

# cd /usr/src/telefum/toapi_server/
# ./pbxserver_autorun
# ps aux | grep pbx
Успешный запуск модуль коннектора.

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

Авторизация в AmoCRM
Переход в меню установки приложения

Поставить галочку рядом с пунктом «Я даю согласие на передачу данных из своего аккаунта amoCRM на сервер Telefum24 для создания личного кабинета» и нажать «Установить»

Установка приложения Telefum24 в AmoCRM

Так же для прохождения авторизации в CRM системе из облачной платформы Telefum24 нам потребуется API ключ, для его получения перейдем в раздел Настройки → API и скопируем значения API ключа для последующего выполнения настройки интеграции.

Получение API ключа

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

Авторизация в личном кабинете Telefum24

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

Логин — логин учетной записи AmoCRM с правами администратора
Код API — API ключ полученный в п.11 данной статьи

Добавление CRM в личном кабинете Telefum24
Добавление CRM в личном кабинете Telefum24
Добавление CRM в личном кабинете Telefum24

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

Успешная синхронизация с CRM системой.

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

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

Добавление интеграции с Asterisk
Добавление интеграции с Asterisk

Добавление интеграции с Asterisk

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

Импортирование списка сотрудников из AmoCRM
Импортирование списка сотрудников из AmoCRM

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

Переход в раздел АТС.
Назначение внутреннего номера.

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

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