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

Описание:

PlanFix ― это многофункциональный и эффективный инструмент управления коллективной работой. С помощью PlanFix возможно организовать совместную работу над проектами, задачами и поручениями, а также легко вести учет различных параметров деятельности компании.

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

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

Инструкция:

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

2. Выполним проверку активности Selinux, в случае если активен, то выполним отключение:

# sestatus
# sed -i 's/\(^SELINUX=\).*/\SELINUX=disabled/' /etc/selinux/config

• Облачный сервис Simplit.io осуществляет подключение к Asterisk по AMI, дефолтный порт 5038(TCP), необходимо разрешить обращения с IP облачного сервиса  138.201.156.168 на данный порт.

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

• Если сервер АТС расположен за NAT, то на сетевом маршрутизаторе необходимо выполнить проброс порта 5038(TCP) на внутрелокальный IP АТС, в примере данной статьи мы рассмотрим как выполнить проброс порта на оборудовании Микротик:

3. После успешной авторизации на Микротик, перейдем в окне WinBox в следующие пункты меню IP->FireWall->NAT->Add Rule и выполним следующие настройки на вкладке General:

Chain – для доступа из внешней сети во внутреннюю необходимо выбрать dstnat
Src. Address – источник обращения необходимо указать IP облачного сервиса Simplit.io 138.201.156.168
Protocol – выбираем TCP прокол
Dst. Port – порт назначения указываем 5038 или любой свободный нестандартный
In. Interface – выбираем внешний сетевой интерфейс используемый для выхода во внешнюю сеть

4. Перейдем на вкладку Action и выполним следующие настройки:

Action — для доступа из внешней сети во внутреннюю необходимо выбрать dstnat
To Addresses – указываем внутрелокальный IP АТС(в примере 192.168.170.163)
To Ports – указываем порт назначения AMI 5038

Сохраняем внесенные действие нажатием кнопки «Ok» и можем переходить к следующему пункту инструкции.

PlanFix_Simplit_8. Настройка на вкладке Action и применение настроек.

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

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

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

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

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

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

Адрес АТС — внешний IP сервера Asterisk, с которого будут приходить обращения в PlanFix
Ключ авторизации АТС — любой произвольный пароль, который необходимо будет так же указать в облачном сервисе Simplit.io для возможности осуществления исходящих звонков
Короткие номера сотрудников — необходимо выполнить закрепление сотрудника за внутренним номером используемым на Asterisk

1. Перейдем к настройке облачного сервиса Simplit.io. Пройдем авторизацию на портале и пропишем следующие настройки:

Раздел «Настройка сервера Asterisk»
IP адрес/DNS имя — внешний IP сервера Asterisk
Порт AMI – порт доступа к AMI по умолчанию 5038
Пользователь AMI – имя AMI пользователя(логин) создаваемый в п.7 данной статьи
Пароль AMI – пароль AMI пользователя создаваемого в п. 7 данной статьи
Тип АТС — Asterisk 13

Раздел «Настройки Планфикс»
Домен Планфис — доменное имя PlanFix портала полученное из п.9 данной статьи
Токен API – токен API полученный из п.9 данной статьи
АТС ключ — пароль для совершения исходящих звонков описанный в п. 9 данной статьи

Внеся все необходимые изменения можно выполнить сохранение настроек нажатием клавиши «Сохранить изменения» и переход к проверке работы интеграции.

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

2. Для получения тестового доступа к облачному сервису Simplit.io на период на 14 дней, необходимо через интернет обозреватель(Opera, Firefox, Google Chrome, Yandex Browser….) по ссылке вида: https://simplit.io/planfix.html и после нажатия кнопки «Начать пробный период» заполнить анкету о компании:

Сервис, с которым нужна интеграция: ПланФикс
Сайт компании: в качестве пример указан адрес тестового портала PlanFix
Фамилия — фамилия контактного лица, которая так же будет указана в личном кабинете облачного сервиса
Имя — имя  контактного лица, которая так же будет указана в личном кабинете облачного
Телефон — контактный телефон компании
email – адрес электронной почты на который прийдут доступы
АТС — Asterisk 13

Расписание курсов по Mikrotik

MTCNA26-29 сентября Подробнее MTCRE30 сентября — 1 октября Подробнее MTCWE2-4 октября Подробнее