Интеграция IP-телефонии — различия между версиями

Версия 11:41, 2 октября 2019

Версия статьи от 2-10-2019.

Введение

Система MAG.Travel 2015 позволяет осуществлять интеграцию с рядом компаний, предоставляющих услуги IP-телефонии.
На данный момент их 5:

• Asterisk;
• Mango-Office;
• Mobilon;
• Oktell;
• Zadarma.

Благодаря этому, появляется возможность осуществлять и принимать звонки от клиентов и фиксировать их в системе MAG.Travel 2015, а именно:

• Создавать клиентов из карточки звонка;
• Добавлять Лид, а также определять имеющийся лид по клиенту;
• Создавать предварительный заказ;
• Фиксировать звонки по лиду в списке обращений, а также в журнале звонков;
• Хранить записи телефонных разговоров (зависит от поставщика услуги IP-телефонии).

Asterisk

Перейдите в Администрирование (верхний правый угол с изображением шестерёнки). В открывшемся экране строчка – Настройка ip телефонии. В открывшемся экране Выберите «тип телефонии» - Asterisk и заполните такие данные как:

• Адрес сервера Asterisk,
• Порт для подключения к AMI (Asterisk management Interface),
• Логин AMI,
• Пароль AMI.

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

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

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

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

Должно быть также настроено событие AgentCalledEvent - http://fshareit.com/java/asterisk/asterisk-java/1.1.0-beta-javadoc/org/asteriskjava/manager/event/AgentCalledEvent.html
В файле queues.conf должна быть строка: eventwhencalled = yes
И Астериск должен быть собран с модулем apps/app_queue.c

Можно указать контекст Астериск для исходящих звонков.
Этот контекст будет использоваться при звонке из Мага.
Если он не заполнен, то по умолчанию используется default (в большинстве случаев используется именно он)

Для прослушивания записей звонков необходимо настроить либо ftp либо http сервер
в случае интеграции через HTTP сервер на компьютере с Астериск должен быть развернут сервис, который по определенному относительному пути отдает файлы из папки /var/spool/asterisk/monitor/
в случае интеграции через FTP сервер аналогично должны отдаваться файлы из этой папки через FTP

Mag.Travel позволяет настроить умную переадресацию на ответственного сотрудника.
Умная переадресация - это перевод звонка от клиента, который в данный момент звонит, на ответственного менеджера, который указан в карточке этого клиента в CRM системе. Иными словами, клиент всегда дозванивается на менеджера, который ведет его дела в этой компании.
Настраивается Умная переадресация в Freepbx через дополнительное назначения: Добавляем дополнительно назначение:

Указываем цель (target) magtransfer,s,1 (4), и можно указать направление из умной переадресации (5)

Переходим в раздел Admin - Config Edit - extensions_custom.conf (FreePBX 13/14) (Для более ранних версий отредактируем файл /etc/asterisk/extensions_custom.conf вручную на сервере)

[magtransfer]
exten => s,1,Set(DEFEXT=200)
exten => s,n,Set(API_key=API_KEY_TEXT)
exten => s,n,Set(RingTime=15)
exten => s,n,ExecIf($[("${MOHCLASS}"!="default") & ("${MOHCLASS}"!="")]?Set(CHANNEL(musicclass)=${MOHCLASS}))
exten => s,n,Set(D_OPTIONS=m(${CHANNEL(musicclass)})Tt)
exten => s,n,NoOp(FROM_DID=${FROM_DID})
exten => s,n,NoOp(CALLERID(num)=${CALLERID(num)})
exten => s,n,Set(TOEXT=${CURL(https://2015.mag.travel/tourclient/api/Telephony/PhoneRedirectNumber/ID_IN_MAG/API_KEY_TEXT/${CALLERID(num)})})
exten => s,n,GotoIf($["${TOEXT}"!=""]?dst:nodst)
exten => s,n(dst),Dial(SIP/${TOEXT},${RingTime},${D_OPTIONS})
exten => s,n,Return()
exten => s,n(nodst),Dial(SIP/${DEFEXT},${RingTime},${D_OPTIONS})
exten => s,n,Return()

где:

• ID_IN_MAG – ID который указываете при входе в систему;
• API_KEY_TEXT – API ключ который Вы генерируете. - *Этот ключ так же должен быть прописан в настройках телефонии в MAG*
• DEFEXT - добавочный по умолчанию, на который пойдет звонок если TOEXT получит не верное значение
• FROM_DID - транк, на который поступил звонок
• TOEXT - номер телефона ответственного из настроек в ЛК (тут значение для нового клиента, или для известного)

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

Mango-Office

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

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

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

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

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

Также указать следующие данные:

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

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

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

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

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

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

В MAG.Travel 2015:

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

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

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

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

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

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

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

Mobilon

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

Настройка в Mobilon

В личном кабинете Mobilon, в разделе Интеграция, на вкладке Настройки необходимо прописать данные для интеграции с Mag.Travel 2015:

• Тип: Webhook;
• В поле URL для событий размещаем ссылку https://2015.mag.travel/tourclient/api/telephony/Mobilon/999/events, где - 999 - Ваш ID который вы указываете при входе в MAG.Travel 2015.
  

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

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

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

Также, далее нужно заполнить данные для пользователей системы, а именно внести у пользователя такие данные как:

• Внутренний номер;
• Userkey.

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

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

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

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

Oktell

Для Интеграции с ip-телефонией Oktell необходимо:

В поле «Тип телефонии» выбрать Oktell

В поле «Автоматическое создание клиента» выбрать в каком из предложенных вариантов будет автоматически создан клиент: - Не создавать – при поступлении входящего звонка новый клиент создан не будет - При входящем с неизвестного номера – новый клиент создастся, если входящий звонок поступит с номера телефона, которого ещё нет в вашей базе - При пропущенном входящем с неизвестного номера - новый клиент создастся, если на входящий звонок не было ответа и такого номера телефона нет в вашей базе

Выбрать один из предложенных вариантов в поле «Автоматическое создание лида», где: - Не создавать – Лид в базе создан не будет - При каждом входящем звонке – Лид создается по каждому входящему звонку, не важно от кого и с какого номера телефона поступил звонок - При входящем с неизвестного номера – Лид создается только в том случае, если звонок поступил с неизвестного номера При пропущенном входящем с неизвестного номера - Лид создается, если на звонок не было ответа и он поступил с неизвестного номера

В поле «Изменять статус лида при пропущенном звонке» выбрать на какой статус Лида изменять статус, если звонок был пропущен (статусы подтягиваются из соответствующего справочника)

В поле «Сервер Oktell» прописать ссылку на ваш сервер Oktell с префиксом «ws://»

Zadarma

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

В разделе "Уведомления о звонках в АТС", в поле "Ссылка вашего ресурса" нужно указать ссылку вида: http://2015.mag.travel/TourClient/api/Telephony/Zadarma/999999/events при этом заменить 999999 на Ваш ID в MAG и справа отметьте все события:

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

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

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