Различия

Показаны различия между двумя версиями страницы.

--- uis [2021/11/27 09:15] – timofeev
+++ uis [2022/04/05 11:44] (текущий) – timofeev
@@ Строка 1: / Строка 1: @@
-===Интеграция с АТС ЮИС (UIS) - идет разработка функции===
+===Интеграция с АТС ЮИС (UIS) ===
-Важно! Интеграция находится в процессе разработки.
 === Настройки сети ===
@@ Строка 10: / Строка 9: @@
 Чтобы Водяной получил доступ к возможностям ВАТС, придется подключить дополнительные ПЛАТНЫЕ услуги АТС - доступ к уведомлениям и CALL API.\\
 Ваш внешний ip-адрес надо будет добавить в белый список адресов ВАТС, для этого перейдите в раздел «Call API» и добавьте свой внешний адрес в раздел «IP адреса».\\
+Примечание. Если для связи используются софтфоны (например, microsip) и Водяной установлен локально, а не не на терминальном сервере, то можно не подключать доступ к услуге CALL API, а в настройках внутренних номеров указать применение callto.\\
 == Получение ключа (токена) ==
@@ Строка 17: / Строка 17: @@
 == Настройка уведомления при входящем звонке ==
 Перейдите в настройки «Уведомлений».\\
-Создайте уведомление для события "Поднятие трубки»", указав в поле url "ваш_внешний_ip:10385"\\.
+Создайте уведомление для события "Поднятие трубки", указав название "Водяной - поднята трубка" (важно), ограничив направление звонка входящими и указав в поле url "ваш_внешний_ip:10385". Остальные параметры менять не надо.\\
-Выберите метод POST, в тело вставьте следующий текст:
+Если необходимо получение информации о пока не отвеченном звонке, аналогичным образом создайте уведомление для события "Входящий на виртуальный номер" с названием "Водяной - идет звонок".
-<code>
-{"notification_name":"hook_up",
-"call_session_id":"{{call_session_id}}",
-"leg_id": {{leg_id}},
-"external_id": {{external_id}},
-"notification_time":{{notification_time}},
-"direction":{{direction}},
-"virtual_phone_number":{{virtual_phone_number}},
-"calling_phone_number":{{calling_phone_number}},
-"called_phone_number":{{called_phone_number}},
-"employee_phone_number":{{employee_phone_number}},
-"contact_phone_number":{{contact_phone_number}}}
-</code>
 === Настройка Водяного ===
@@ Строка 44: / Строка 33: @@
 В «Администрирование - Внутренние номера (настройки софтфонов)» надо создать строки, соответствующие каждому внутреннему номеру (пользователю АТС). Помимо наименования (номера), в поле «вариант подключения телефонии» выбираем «UIS (ЮИС)».\\
 На вкладке "Пользователь, пароль" в поле "имя пользователя" вносим числовой id сотрудника в АТС, а в поле "Городской, мобильный номер, соответствующий внутреннему" указываем внешний номер компании (например, 89111234567). Если внешний номер одинаков у всех сотрудников, достаточно указать его в одной из записей.\\
-Примечание. Получить id сотрудников можно запросом https://callapi.uiscom.ru/v4.0
+Примечание. Получить id сотрудников можно запросом
 <code>
+POST https://dataapi.uiscom.ru/v2.0
 {
   "jsonrpc":"2.0",
@@ Строка 55: / Строка 45: @@
 }
 </code>
+Если CALLApi не используется, можно не получать коды сотрудников, а вместо них в справочнике внутренних номеров указать ФИО (требуется точное совпадение с данными, внесенными в список сотрудников АТС).
-Создав внутренние номера, в справочнике «Администрирование — пользователи» для каждого сотрудника на вкладке «IP-телефония» выбираем внутренний номер. Если пользователь уже вошел в программу на момент назначения номера, он должен выйти и войти повторно для использования телефонии.\\
+Создав внутренние номера, в справочнике «Администрирование — пользователи» для каждого сотрудника на вкладке «IP-телефония» выбираем внутренний номер. Если пользователь уже вошел в программу на момент назначения номера, он должен выйти и войти повторно.\\
 Подробнее о настройке внутренних номеров:
@@ Строка 66: / Строка 57: @@
 [[телефония|К оглавлению раздела "телефония"]]