Интеграция Asterisk c AmoCRM с использованием модуль коннектора Простые звонки

CRM расшифровывается как Customer Relationship Management – управление взаимоотношениями с клиентами. Это специальная программа, которая позволяет хранить данные о клиентах, сделках, текущих задачах и многом другом в одном месте. Благодаря таким программам нужная информация всегда под рукой, а задачи — выполнены в срок. Как результат, CRM-система экономит время специалистов и способствует росту продаж. amoCRM — одна из ведущих CRM в России. Она создана специально для отделов продаж, содержит много уникальных и полезных инструментов, в ней просто работать. Не менее важным моментом является возможность интеграции CRM с офисной IP АТС на базе Asterisk.

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

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

При написании статьи так же использовались следующие модули:

1. Модуль коннектор «Простые звонки» — <prostiezvonki_asterisk13.zip>
2. Модуль статистики(не является обязательным к установке) «Простые звонки» — <prostiezvonki_statistika.zip>
3. Модуль прокси сервера(не является обязательным к установке) «Простые звонки» — prostiezvonki_multiproxy.zip

Инструкция:

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

# cd /usr/src/
 # wget http://prostiezvonki.ru/installs/prostiezvonki_asterisk13.zip
 # unzip prostiezvonki_asterisk13.zip
 # cd /usr/src/prostiezvonki/
 # ./install

В ходе выполнения скрипта автоустановки модуля, потребуется ввести следующие параметры:

1) Set license — полученный лицензионный ключ модуля «Простые звонки». Демо лицензию можно запросить на официальной странице разработчика. Лицензионный ключ в последующем можно будет изменить из web интерфейса FreePBX.
2) Set password — пароль доступа к модуль коннектору, потребуется в ходе проведения настроек на стороне CRM. Так же данный пароль можно в последующем будет изменить из web интерфейса FreePBX.

3) Set port – пароль доступа к модуль коннектору, потребуется в ходе проведения настроек на стороне CRM. Так же данный параметр можно в последующем будет изменить из web интерфейса FreePBX.
4) Set internal number lenght — длина(количество символов) внутренних номеров
5)  Set type of channel — тип используемого протокола для внутренних номеров(SIP, IAX…)
6) Use SSL – использование защищенного SSL подключения между CRM и модуль коннектором. Рекомендуется установить параметр «true» если сервер телефонии и CRM не будут находиться в рамках одной локальной сети.
7) Hostname for SSL — доменное имя для генерации самоподписанного SSL сертификата
8) Do you want have public link audio records — если уже создана символьная ссылка на директорию записей разговоров, то рекомендуется установить параметр «true»
9) Port of the server Statistics — порт доступа к системе статистики звонков «Простые звонки»(по умолчанию 8090)
10) Address of BPX-connector — адрес доступа к модуль коннектору(без использования SSL: ws://192.168.170.197:10150 ; с использованием SSL: wss://192.168.170.197:10150; где вместо 192.168.170.197 необходимо указать Ваш IP адрес или доменное имя сервера Asterisk)
11) Install MultiProxy – рекомендуется к установке если планируется использование более одного модуль коннектора

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

4. Необходимо указать ссылку доступа к записям разговоров в настройках модуль коннектора, для этого перейдём в WEB панель управления FreePBX через интернет обозреватель(Opera, Firefox, Google Chrome, Yandex Browser….) по ссылке.
В примере ссылка имеет вид.

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

6. Applications → Prostie Zvonki и отредактируем параметр «Внешняя директория» в соответствии с созданным VirtualHost в п.3. В примере ссылка имеет вид:  , где вместо 192.168.170.197 необходимо указать Ваш IP адрес или доменное имя сервера Asterisk.

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

8. Для выполнения установки необходимо настроить следующие ключевые параметры интеграции:

1) Пароль — пароль доступа к модуль коннектору, настраиваемый в п.6 данной статьи
2) Адрес сервера — адрес доступа к модуль коннектору(без использования SSL: ws://192.168.170.197:10150 ; с использованием SSL: wss://192.168.170.197:10150; где вместо 192.168.170.197 необходимо указать Ваш IP адрес или доменное имя сервера Asterisk)
3) Добавочные номера — внутренний номер сотрудника в соответствии с учетной записью в CRM
4) Длина номера — минимальное количество символов по которым будет выполнять поиск клиента в базе CRM(отсчет с конца номера)
5) Автоматически создавать клиентов для входящих — автоматически заводить клиента в amoCRM при условии: при поступлении, при ответе, при ответе и пропуске, никогда
6) Создавать нового клиента для входящих в виде — форма создания нового клиента: неразобранное, контакт, сделка+контакт
7) Автоматически создавать клиента для исходящих — автоматически заводить клиента в AmoCRM при условии: никогда, всегда
8) Создавать нового клиента для исходящих в виде — форма создания нового клиента: контакт, сделка+контакт
9) Добавлять номер линии в имена новых контактов — при создании «Неразобранного\Контакта\Сделки+Контакта» в его имя будет добавлено название городской линии, на которую поступил звонок
10) Показывать сообщения с историей пропущенных звонков — отображение уведомлений о пропущенных звонках
11) Отображать дополнительную информацию о звонке — отображать расширенную информацию о звонящем клиенте если клиент имеется в базе AmoCRM
12) Отправлять диагностическую информацию — пункт не обязателен и требуется для решения технических вопросов.

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

10. В разделе Аналитика → Звонки возможно просмотреть историю всех звонков с возможностью использования фильтров «Период времени, менеджеры, продолжительность звонка», а так же прослушать или скачать запись разговора.

11. Так же записи разговоров звонков прикрепляются в карточку клиента

12. Осуществив клик по номеру клиента начнётся инициализация исходящего звонка, сперва звонок поступит на закрепленный внутренний номер сотрудника и после поднятия трубки сотрудником вызов поступит клиенту. В момент осуществления исходящего звонка в CRM отобразится карточка клиента.