Интеграция Asterisk с Terrasoft (BPM Online CRM)

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

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

Инструкция:

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 (в примере данной статьи это локальная подсеть 192.168.170.0/255.255.255.0)

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

5. Т.к. BPM Online CRM осуществляет подключение к Asterisk через дополнительный модуль коннектор по AMI порту 5038(TCP), необходимо разрешить обращения с IP адреса Windows сервера на который будет производиться установка дополнительного модуль коннектора. Для этого выполним в терминале ряд команд вида:

# iptables -I INPUT -p tcp -s 192.168.170.168 --dport 5038 -j ACCEPT

6. Выполним установку модуль коннектора на Windows сервер. Установочный файл модуль коннектора можно получить обратившись в службу поддержки Terrasoft по email [email protected]

7. По завершению установки модуль коннектора перейдем к редактированию конфигурационного файла «Terrasoft.Messaging.Service.exe.config», который располагается в директории. Где ключевыми параметрами для редактирования является:

URL — IP-адреса сервера Asterisk.
Port — AMI порт 5038(TCP)
OriginateContext — Контекст для осуществления исходящего вызова. Значение по умолчанию для FreePBX — «from-internal».
parkingLotContext — Контекст для инициации звонка на получение паркованной линии. Значение по умолчанию — «from-internal».
AutoPauseOnCommutationStart — Автоматическое постановка агента очереди обзвона на паузу.
queueExtensionFormat — Формат определения канала звонка при получении звонков из очереди. При использовании LocalChannel в FreePBX значение по умолчанию — «Local/{0}@from-queue«.
sendRingStartedOnRingingState — Признак отвечает за корректную обработку получения звонка из очереди. При установленном признаке bpm’online будет отображать звонок у пользователя после получения AMI события «NewState» с параметром Ringing. Значение по умолчанию — «включено».

8. По завершению редактирования конфигурационного файла необходимо выполнить перезапуск службы «TerrasoftMessagingService». Путь к разделу «Службы» может отличаться в зависимости от используемой Windows системы, в нашем случае(Windows Server 2008 R2) необходимо перейти в «Пуск->Администрирование->Службы» и выполнить перезапуск службы в соответствии со скриншотом:

• Успешно выполнив описанные ранее действия, перейдем к настройки CRM системы, для этого пройдем авторизацию в системе с правами администратора и перейдем в раздел «Настройки → Системные настройки → Телефония → Библиотека обмена сообщениями по умолчанию» и в пункте меню «Значение по умолчанию» выберем из выпадающего списка: «Библиотека интеграции с телефонией по протоколу Asterisk (AMI)» и сохраним внесенные изменения нажатием клавиши «Сохранить».

1. Перейдем в раздел «Настройки → Системные настройки → Телефония → Сервер обмена сообщениями»   и в пункте меню «Значение по умолчанию» пропишем адрес Windows сервера на который производилась установка модуль коннектора, в формате: ws://IP:Port (Пример на основе данной статьи: ws://192.168.170.168:2013) . Где ключевые параметры для изменения:

ws или wss – WebSocket без шифрования и с шифрованием
IP – IP адрес Windows сервера с установленным и настроенным модуль коннектором
Port – порт модуль коннектора(по умолчанию 2013(TCP))

11. Завершающим этап настройки интеграции является закрепление внутреннего номера за профилем пользователя CRM системы. Для того чтобы прописать внутренний номер перейдем в раздел «Настройки профиля → Настройка параметров Call Centre» и в пункте меню «Номер» пропишем соответствующий внутренний номер.

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