Просмотр исходного текста страницы Интеграция IP-телефонии

Версия статьи от {{REVISIONDAY}}-{{REVISIONMONTH}}-{{REVISIONYEAR}}. 

==Введение==

Система MAG.Travel 2015 позволяет осуществлять интеграцию с рядом компаний, предоставляющих услуги IP-телефонии.<br>
На данный момент их 5:
* Asterisk;
* Mango-Office;
* Mobilon;
* Oktell;
* Zadarma.
Благодаря этому, появляется возможность осуществлять и принимать звонки от клиентов и фиксировать их в системе MAG.Travel 2015, а именно:
* Создавать клиентов из карточки звонка;
* Добавлять Лид, а также определять имеющийся лид по клиенту;
* Создавать предварительный заказ;
* Фиксировать звонки по лиду в списке обращений, а также в журнале звонков;
* Хранить записи телефонных разговоров (зависит от поставщика услуги IP-телефонии).

==Asterisk==

Перейдите в Администрирование (верхний правый угол с изображением шестерёнки). В открывшемся экране строчка – Настройка ip телефонии. В открывшемся экране Выберите «тип телефонии» - Asterisk и заполните такие данные как:<br>
* Адрес сервера Asterisk,
* Порт для подключения к AMI (Asterisk management Interface),
* Логин AMI,
* Пароль AMI.

Ип с которых должен быть доступен Астериск по AMI<br>
217.23.157.106<br>
217.23.157.107<br>
217.23.157.108<br>
217.23.157.109<br>
217.23.157.110<br>
217.23.157.178<br>
185.26.169.104<br>

Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf

Для этого в manager.conf должны быть прописаны логин и пароль ами, а также разрешения на all<br>
Пример конфигурации:<br>
[magtravel]<br>
secret = XXXXXXX<br>
deny=0.0.0.0/0.0.0.0<br>
permit=217.23.157.106/255.255.255.255<br>
permit=217.23.157.107/255.255.255.255<br>
permit=217.23.157.108/255.255.255.255<br>
permit=217.23.157.109/255.255.255.255<br>
permit=217.23.157.110/255.255.255.255<br>
permit=217.23.157.178/255.255.255.255<br>
permit=185.26.169.104/255.255.255.255<br>
read = all,cdr<br>
write = all,cdr<br>
writetimeout = 500<br>

*Вместо XXXXXXX необходимо указать пароль для подключения, который затем прописать в настройках телефонии в Маге.*<br>

Должно быть также настроено событие AgentCalledEvent - http://fshareit.com/java/asterisk/asterisk-java/1.1.0-beta-javadoc/org/asteriskjava/manager/event/AgentCalledEvent.html<br>
В файле queues.conf должна быть строка: eventwhencalled = yes<br>
И Астериск должен быть собран с модулем apps/app_queue.c<br>
<br>
Можно указать контекст Астериск для исходящих звонков.<br>
Этот контекст будет использоваться при звонке из Мага.<br>
Если он не заполнен, то по умолчанию используется default (в большинстве случаев используется именно он)<br>
<br>
Для прослушивания записей звонков необходимо настроить либо ftp либо http сервер<br>
в случае интеграции через HTTP сервер на компьютере с Астериск должен быть развернут сервис, который по определенному относительному пути отдает файлы из папки /var/spool/asterisk/monitor/<br>
в случае интеграции через FTP сервер аналогично должны отдаваться файлы из этой папки через FTP<br>
<br>
Mag.Travel позволяет настроить умную переадресацию на ответственного сотрудника.<br>
Умная переадресация - это перевод звонка от клиента, который в данный момент звонит, на ответственного менеджера, который указан в карточке этого клиента в CRM системе. Иными словами, клиент всегда дозванивается на менеджера, который ведет его дела в этой компании.<br>
Настраивается Умная переадресация в Freepbx через дополнительное назначения: Добавляем дополнительно назначение:<br>
 <br>
  
Указываем цель (target) magtransfer,s,1 (4), и можно указать направление из умной переадресации (5)<br>
 
Переходим в раздел Admin - Config Edit - extensions_custom.conf (FreePBX 13/14) (Для более ранних версий отредактируем файл /etc/asterisk/extensions_custom.conf вручную на сервере)<br>
  
[magtransfer]<br>
exten => s,1,Set(DEFEXT=200)<br>
exten => s,n,Set(API_key=API_KEY_TEXT)<br>
exten => s,n,Set(RingTime=15)<br>
exten => s,n,ExecIf($[("${MOHCLASS}"!="default") & ("${MOHCLASS}"!="")]?Set(CHANNEL(musicclass)=${MOHCLASS}))<br>
exten => s,n,Set(D_OPTIONS=m(${CHANNEL(musicclass)})Tt)<br>
exten => s,n,NoOp(FROM_DID=${FROM_DID})<br>
exten => s,n,NoOp(CALLERID(num)=${CALLERID(num)})<br>
exten => s,n,Set(TOEXT=${CURL(https://2015.mag.travel/tourclient/api/Telephony/PhoneRedirectNumber/ID_IN_MAG/API_KEY_TEXT/${CALLERID(num)})})<br>
exten => s,n,GotoIf($["${TOEXT}"!=""]?dst:nodst)<br>
exten => s,n(dst),Dial(SIP/${TOEXT},${RingTime},${D_OPTIONS})<br>
exten => s,n,Return()<br>
exten => s,n(nodst),Dial(SIP/${DEFEXT},${RingTime},${D_OPTIONS})<br>
exten => s,n,Return()<br>
<br>
где:<br>
* ID_IN_MAG – ID который указываете при входе в систему;
* API_KEY_TEXT – API ключ который Вы генерируете. - *Этот ключ так же должен быть прописан в настройках телефонии в MAG*
* DEFEXT - добавочный по умолчанию, на который пойдет звонок если TOEXT получит не верное значение
* FROM_DID - транк, на который поступил звонок
* TOEXT - номер телефона ответственного из настроек в ЛК (тут значение для нового клиента, или для известного)

Затем нужно направить звонок в входящем маршруте в созданное дополнительное назначение magtransfer

 



==Mango-Office==

Для интеграции с IP-телефонией '''Mango-Office''' необходимо '''быть действующим клиентом Mango-Office'''.<br>

===Регистрация в Mango-Office===

Для начала интеграции с IP-телефонией Mango-Office, необходимо пройти регистрацию на сайте <code>http://mango-office.ru</code>, а также пополнить баланс.<br>
Необходимо иметь услугу ''Виртуальная АТС'' и ''Подключение к API''.<br>
Перейти в раздел ''Виртуальная АТС''.<br>

[[Файл:Ak_321.png]]<br>

Справа внизу расположен раздел ''Интеграции''.<br>

[[Файл:Ak_323.png|border]]<br>

Данную функцию необходимо включить нажатием по кнопке ''Изменить'' и выбрать пункт ''Возможность использовать API'':<br> 

[[Файл:Ak_324.png|border]]<br>

Также указать следующие данные:
* Данные внешней системы: <code>https://2015.mag.travel/tourclient/api/Telephony/Mango/999</code>, где - '''999''' - Ваш '''ID''' который вы указываете при входе в MAG.Travel 2015;
* SSL-сертификат: ''Не проверять сертификат'';
* Разрешенные IP-адреса: ''Свободный доступ. Соединения по API возможны с любых IP-адресов''.

[[Файл:Ak_322.png|border]]<br>

Скопируйте "Уникальный код вашей АТС" и "Ключ для создания подписи" (они потребуются для настройки телефонии в системе MAG.Travel 2015):<br>

[[Файл:Ak_325.png|border]]<br>

Помимо этого, необходимо создать в системе сотрудников и создать им SIP-аккаунт на третьем шаге:<br>

[[Файл:Ak_331.png]]<br>

[[Файл:Ak_328.png]]<br>

===Настройка Mango-Office в MAG.Travel 2015===

Данные, скопированные из Личного кабинета Mango-Office, необходимо прописать в системе MAG.Travel 2015, в разделе "Настройки – Настройки ip телефонии". <br>

[[Файл:Ak_320.png|border]]<br>

[[Файл:Ak_326.png|border]]<br>

Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.<br>
В Mango-Office:<br>

[[Файл:Ak_328.png]]<br>

В MAG.Travel 2015:<br>

[[Файл:Ak_327.png|border]]<br>

После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br>

Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015 [[Файл:Ak_329.png]], сервис Mango-Office сначала позвонит Вам, а потом соединит Вас с клиентом (используется SIP-Клиент).<br>
При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br>

[[Файл:Ak_330.png]]<br>

'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).

====Назначение звонков ответственному менеджеру====

В разделе Администрирование - Вкладка "Настройки" необходимо выбрать менеджера в настройке "Назначать неотвеченные звонки менеджеру".<br>
Таким образом, неотвеченные звонки и клиенты, созданные на их основе будут назначены выбранному менеджеру, а также при повторных звонках - они будут перенаправлены именно на него.<br>

Для корректной работы перенаправления звонков, необходимо также настроить входящую линию в Виртуальной АТС Mango-Office:<br>

[[Файл:Ak_454.png|Пример схемы распределения звонков]]<br>

Необходимо настроить распределение звонков на группу абонентов за счёт создания схемы с установкой расписания, включающего Приветствие -> Переадресация на группу абонентов.<br>

==Mobilon==

Для интеграции с IP-телефонией '''Mobilon''' необходимо '''быть действующим клиентом Mobilon'''.<br>

===Настройка в Mobilon===

В личном кабинете Mobilon, в разделе ''Интеграция'', на вкладке ''Настройки'' необходимо прописать данные для интеграции с Mag.Travel 2015:<br>
* Тип: '''Webhook''';
* В поле URL для событий размещаем ссылку <code>https://2015.mag.travel/tourclient/api/telephony/Mobilon/999/events</code>, где - '''999''' - Ваш '''ID''' который вы указываете при входе в MAG.Travel 2015.<br>

[[Файл:Ak_432.png|border]]<br>

Также, необходимо создать Абонентов в разделе ''Конфигуратор'' подпункт ''Абонент'':<br>

[[Файл:Ak_433.png|border]]<br>

===Настройка Mobilon в MAG.Travel 2015===

Для настройки в Mag.Travel 2015 необходимо перейти в раздел Администрирования, справочник ''Настройки IP-телефонии'' и в поле ''Тип телефонии'' выбрать Mobilion:

[[Файл:Ak_435.png]]<br>

Также, далее нужно заполнить данные для пользователей системы, а именно внести у пользователя такие данные как:
* Внутренний номер;
* Userkey.

Данные для поля Userkey необходимо взять из данных абонентов в кабинете Mobilon:<br>

[[Файл:Ak_434.png|border]]<br>

После этого необходимо сохранить настройки в системе MAG.Travel 2015.<br>

При входящем звонке на ваш внутренний номер, вы увидите всплывающую карточку с номером телефона или сразу с именем туриста (если он есть в клиентской базе):<br>

[[Файл:Ak_330.png]]<br>

'''Внимание!''' Все разговоры ведутся по IP-телефонам (не через систему MAG.Travel 2015).

==Oktell==

==Zadarma==

В ЛК ZADARMA перейдите в раздел "Настройки" - "API и интеграции".
Здесь вы можете найти API ключ и ключ для создания подписи.
Их нужно прописать в настройках IP телефонии в системе MAG.Travel

В разделе "Уведомления о звонках в АТС", в поле "Ссылка вашего ресурса" нужно указать ссылку вида:
http://2015.mag.travel/TourClient/api/Telephony/Zadarma/999999/events при этом заменить 999999 на Ваш ID в MAG
и справа отметьте все события:
[[Файл:2019-10-02_12-03_Zadarma.jpg]]

Также в системе MAG.Travel, в настройках IP телефонии нужно прописать внутренние номера пользователей для которых будет доступна интеграция.
В ZADARMA можно найти внутренние номера сотрудников в разделе Моя АТС, внутренние номера. Поле с номером - "Внутренний номер АТС"

Также, для записи разговоров должен быть установлен флаг:
Запись разговоров - в облако

[[Файл:Zadarmarecording.jpg]]

Для приема входящих звонков в ЛК ZADARMA должны быть подключены номера в разделе Моя АТС, внешние линии.