Интеграция IP-телефонии - История изменений

WikiSys в 08:56, 10 октября 2024

2024-10-10T08:56:08Z

WikiSys в 08:39, 5 июля 2022

2022-07-05T08:39:56Z

WikiSys в 06:56, 5 июля 2021

2021-07-05T06:56:16Z

Внесённые изменения

WikiSys в 06:52, 5 июля 2021

2021-07-05T06:52:49Z

WikiSys в 06:44, 5 июля 2021

2021-07-05T06:44:42Z

Внесённые изменения

WikiSys: /* Регистрация в Mango-Office */

2021-06-21T12:45:08Z

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

WikiSys: /* Asterisk */

2021-04-21T14:15:47Z

‎Asterisk

WikiSys: /* Asterisk */

2021-04-15T07:10:26Z

‎Asterisk

WikiSys: /* Asterisk */

2020-06-18T08:27:26Z

‎Asterisk

WikiSys: /* Asterisk */

2020-06-18T08:07:45Z

‎Asterisk

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

@@ Строка 27: / Строка 27: @@
 Ип с которых должен быть доступен Астериск по AMI<br>
 .251.195.241<br>
 .40.126.229<br>
 .251.22.175<br>
 Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf
@@ Строка 39: / Строка 41: @@
 secret = XXXXXXX<br>
 deny=0.0.0.0/0.0.0.0<br>
 permit=148.251.195.241/255.255.255.255<br>
 permit=188.40.126.229/255.255.255.255<br>
 permit=148.251.22.175/255.255.255.255<br>
 read = all,cdr<br>
 write = all,cdr<br>

@@ Строка 284: / Строка 284: @@
 . Подключить API
 Нужно подключить компонент «Call API Базовый набор» и «Уведомления». Для переадресации на ответственного нужно также подключить «Call API Управление вызовами»\
-Подключается компонент в разделе Администратор - Аккаунт - Тариф и опции:
+Подключается компонент в разделе Администратор - Аккаунт - Тариф и опции:<br>
 [[Файл:UIS1.png]]
@@ Строка 293: / Строка 293: @@
 Временный. Временный ключ имеет конкретную дату окончания действия ключа.
 Генерируем постоянный ключ.
-При этом, будьте внимательны: ключ виден в интерфейсе и доступен для копирования только в момент генерации, после сохранения настроек вы сможете его увидеть только в коде своего приложения или другом месте, куда вы сохранили этот ключ.
+При этом, будьте внимательны: ключ виден в интерфейсе и доступен для копирования только в момент генерации, после сохранения настроек вы сможете его увидеть только в коде своего приложения или другом месте, куда вы сохранили этот ключ.<br>
 [[Файл:UIS2.png]]
@@ Строка 299: / Строка 299: @@
 По умолчанию доступ к API запрещен всем, чтобы можно было делать запросы необходимо IP-адрес хоста с которого делается запрос добавить в белый список. Это можно сделать через личный кабинет "Администратор -> Аккаунт -> Правила и настройки безопасности" вкладка "API".
-Наши IP:
+Наши IP:<br>
-.251.195.241
+.251.195.241<br>
-.40.126.229
+.40.126.229<br>
-.251.22.175
+.251.22.175<br>
-.26.169.104
+.26.169.104<br>
 [[Файл:UIS3.png]]
 . Настройка IP телефонии в МАГЕ
-Для настройки ip телефонии перейдите в системе маг в администрирование (шестеренка в правом верхнем угле), далее в “Настройки ip телефонии”
+Для настройки ip телефонии перейдите в системе маг в администрирование (шестеренка в правом верхнем угле), далее в “Настройки ip телефонии”<br>
-[[Файл:UIS4.png]]
+[[Файл:UIS4.png]]<br>
 Здесь тип телефонии выбирайте UIS.
 Ключ доступа к API UIS вставьте, что вы сгенерировали в личном кабинете UIS.
-Ключ для API уведомлений придумайте сами, он понадобится в следующем пункте.
+Ключ для API уведомлений придумайте сами, он понадобится в следующем пункте.<br>
 [[Файл:UIS5.png]]
@@ Строка 318: / Строка 318: @@
 Чтобы настроить получение уведомлений, перейдите в раздел Сервисы и статистика, в боковом меню откройте Уведомления и нажмите добавить. В открывшемся окне необходимо заполнить параметры: название уведомления; тип события, о котором нужно вас уведомить; условия, при которых будет приходить уведомление; способ получения уведомлений.
-Нужно настроить 8 HTTP уведомлений
+Нужно настроить 8 HTTP уведомлений<br>
 [[Файл:UIS6.png]]
-При настройки уведомлений в каждый URL необходимо прописать свой ID Мага (В примере ID это 200). А также, в каждом шаблоне запроса вместо <ваш ключ в настройках телефонии в MAG.Travel> прописать Ключ для API уведомлений указанное в настройках телефонии в Маг, вы его создаете сами.
+При настройки уведомлений в каждый URL необходимо прописать свой ID Мага (В примере ID это 200). А также, в каждом шаблоне запроса вместо <ваш ключ в настройках телефонии в MAG.Travel> прописать Ключ для API уведомлений указанное в настройках телефонии в Маг, вы его создаете сами.<br>
 '''Входящее плечо'''
@@ Строка 327: / Строка 327: @@
 POST https://2015.mag.travel/tourclient/api/Telephony/Uis/200/IncomingLeg
+{<br>
-"notification_name":{{notification_name}},
+"notification_name":{{notification_name}},<br>
-"notification_time":{{notification_time}},
+"notification_time":{{notification_time}},<br>
-"external_id": {{external_id}},
+"external_id": {{external_id}},<br>
-"contact_info":{
+"contact_info":{<br>
-"contact_phone_number":{{contact_phone_number}},
+"contact_phone_number":{{contact_phone_number}},<br>
-"contact_id": {{contact_id}}
+"contact_id": {{contact_id}}<br>
-},
+},<br>
-"employee_info": {
+"employee_info": {<br>
-"employee_full_name": {{employee_full_name}},
+"employee_full_name": {{employee_full_name}},<br>
-"extension_phone_number": {{extension_phone_number}}
+"extension_phone_number": {{extension_phone_number}}<br>
-},
+},<br>
-"call_source": {{call_source}},
+"call_source": {{call_source}},<br>
-"call_session_id":{{call_session_id}},
+"call_session_id":{{call_session_id}},<br>
-"direction": {{direction}},
+"direction": {{direction}},<br>
-"leg_id": {{leg_id}},
+"leg_id": {{leg_id}},<br>
-"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"
+"mag_secret": "ваш ключ в настройках телефонии в MAG.Travel"<br>
+}<br>
 '''Исходящее плечо'''

@@ Строка 101: / Строка 101: @@
 Для начала интеграции с IP-телефонией Mango-Office, необходимо пройти регистрацию на сайте <code>http://mango-office.ru</code>, а также пополнить баланс.<br>
-Необходимо иметь услугу ''Виртуальная АТС'' и ''Подключение к API''.<br>
+Регистрация в Mango-Office
-Перейти в раздел ''Виртуальная АТС''.<br>
+Шаг 1. Войдите в Личный кабинет Виртуальной АТС (ВАТС).
-[[Файл:Ak_321.png]]<br>
+[[Файл:M1.png]]<br>
-Справа внизу расположен раздел ''Интеграции''.<br>
+Шаг 3. Откройте вкладку «API коннектор».
-[[Файл:Ak_323.png|border]]<br>
+[[Файл:M2.png|border]]<br>
-Данную функцию необходимо включить нажатием по кнопке ''Изменить'' и выбрать пункт ''Возможность использовать API'':<br>
+Шаг 4. Сохраните данные вашей АТС для дальнейшего копирования в виджет CRM-системы или не закрывайте вкладку до окончания настройки интеграции.':<br>
-[[Файл:Ak_324.png|border]]<br>
+[[Файл:M3.png|border]]<br>
 Также указать следующие данные:
-* Данные внешней системы: <code>https://2015.mag.travel/tourclient/api/Telephony/Mango/999</code>, где - '''999''' - Ваш '''ID''' который вы указываете при входе в MAG.Travel 2015;
+Адрес внешней системы: https://2015.mag.travel/tourclient/api/Telephony/Mango/999 , где - 999 - Ваш ID который вы указываете при входе в MAG.Travel 2015;
-* SSL-сертификат: ''Не проверять сертификат'';
+SSL-сертификат: Не проверять сертификат;
-* Разрешенные IP-адреса: ''Свободный доступ. Соединения по API возможны с любых IP-адресов''.
+[[Файл:M4.png|border]]<br>
-[[Файл:Ak_322.png|border]]<br>
+Шаг 6. Установите безопасность посредством IP-адресов. Если вы хотите прослушивать записи разговоров прямо из CRM, то установите флаг «записи разговоров» (при этом необходимо подключить услугу «запись разговоров» в личном кабинете → вкладка «инструменты» → выберите пункт «запись разговоров» и нажмите кнопку «подключить»). Для принятия настроек нажмите кнопку «сохранить».
-Скопируйте "Уникальный код вашей АТС" и "Ключ для создания подписи" (они потребуются для настройки телефонии в системе MAG.Travel 2015):<br>
+Скопируйте "Уникальный код вашей АТС" и "Ключ для создания подписи" (они потребуются для настройки телефонии в системе MAG.Travel 2015):
-[[Файл:Ak_325.png|border]]<br>
+Шаг 7 Необходимо создать в системе сотрудников и создать им SIP-аккаунт.
-Помимо этого, необходимо создать в системе сотрудников и создать им SIP-аккаунт на третьем шаге:<br>
+'''Настройка Mango-Office в MAG.Travel 2015'''
-[[Файл:Ak_331.png]]<br>
+Укажите внутренние номера сотрудников в MAG.Travel 2015 (в разделе "Настройки – Настройки ip телефонии") так, как они указаны у Вас в Виртуальной АТС Mango-Office.
-[[Файл:Ak_328.png]]<br>
+Для исходящего звонка нажмите на кнопку Позвонить в системе MAG.Travel 2015
 ===Настройка Mango-Office в MAG.Travel 2015===

@@ Строка 26: / Строка 26: @@
 Ип с которых должен быть доступен Астериск по AMI<br>
 .251.22.175<br>
 Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf
@@ Строка 35: / Строка 38: @@
 secret = XXXXXXX<br>
 deny=0.0.0.0/0.0.0.0<br>
 permit=148.251.22.175/255.255.255.255<br>
 read = all,cdr<br>
 write = all,cdr<br>

@@ Строка 26: / Строка 26: @@
 Ип с которых должен быть доступен Астериск по AMI<br>
-.23.157.106<br>
+.173.35.98<br>
-.23.157.107<br>
+.99.8.245<br>
-.23.157.108<br>
+.37.141.80<br>
-.23.157.109<br>
+.44.95.142<br>
 Посмотреть логин, пароль к AMI можно перейдя на сервере Asterisk по пути: /etc/asterisk/manager.conf
@@ Строка 99: / Строка 95: @@
 Затем нужно направить звонок в входящем маршруте в созданное дополнительное назначение magtransfer
 ==Mango-Office==