Кирилл Золотавин
19.02.2019
307

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

Описание: PlanFix ― это многофункциональный и эффективный инструмент управления коллективной работой. С помощью PlanFix возможно организовать совместную работу над проектами, задачами и поручениями, а также легко вести учет различных параметров деятельности компании. В рамках данной статьи будет рассмотрено как выполнить интеграцию Asterisk 13 с PlanFix. Возможности интеграции: 1. Оповещение о входящем звонке 2. Исходящий звонок […]

Описание:

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

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

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

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

Инструкция:

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

Подключение по SSH через Putty
Авторизация на сервере
Внимание, при авторизации на сервере, пароль в консоли не отображается.
SSH консоль подключения

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

# sestatus
# sed -i 's/\(^SELINUX=\).*/\SELINUX=disabled/' /etc/selinux/config
SELinux (Security Enhanced Linux) – это система безопасности основанная на моделях мандатного и ролевого доступа. SELinux реализована как компонент ядра Linux начиная с версии ядра 2.6.
Отключение Selinux
  • Облачный сервис 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
Добавление правила в Iptables.
В целях безопасности рекомендуется выполнить настройку PREROUTING с нестандартного порта на порт 5038.
  • Если сервер АТС расположен за NAT, то на сетевом маршрутизаторе необходимо выполнить проброс порта 5038(TCP) на внутрелокальный IP АТС, в примере данной статьи мы рассмотрим как выполнить проброс порта на оборудовании Микротик:

После успешной авторизации на Микротик, перейдем в окне 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 – выбираем внешний сетевой интерфейс используемый для выхода во внешнюю сеть

Переход к меню для добавлению проброса порта 5038
Настройка на вкладке General

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

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

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

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

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

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

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

    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

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

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

Авторизация в PlanFix
Переход в раздел управления дополнительными сервисами интеграции PlanFix

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

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

Включение интеграции по API
Настройка интеграции по API
  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 данной статьи

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

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

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

Заявка на получение тестового периода
Заполнение анкеты для тестового периода
Заполнение анкеты для тестового периода
 
avatar
  Подписаться  
Уведомление о

Остались вопросы?

Я - Кондрашин Игорь, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование

ближайшие курсы

ближайшие Вебинары

ONLINE

Why Choose HUGE?

Unlimited pre-designed elements

Each and every design element is designed for retina ready display on all kind of devices

User friendly interface and design

Each and every design element is designed for retina ready display on all kind of devices

100% editable layered PSD files

Each and every design element is designed for retina ready display on all kind of devices

Created using shape layers

Each and every design element is designed for retina ready display on all kind of devices