Различия

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

--- uis [2021/11/27 08:53] – создано 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>
 === Настройка Водяного ===
-Со стороны Водяного потребуется заполнить справочник "облачные АТС", а также задать внутренние номера пользователей.\\
-== Справочник "Облачные АТС" ==
 Откройте администрирование - [[облачные_атс|"облачные АТС"]] и создайте новую строку\\
 В поле "адрес сервера провайдера" указываем https://callapi.uiscom.ru/v4.0
 В поле "Пароль (токен) АТС" указываем ключ, который ранее получили в личном кабинете АТС.
+В поле "запускать сервер от имени ..." выбираем пользователя "Служба" (если его нет в списке, то оставляем пустым, а после сохранения введенных в справочник ОАТС данных [[служба|устанавливаем службу Водяного]]).\\
-В поле "запускать сервер от имени ..." выбираем пользователя "Служба" (если есть в списке, иначе оставляем пустым и затем [[служба|устанавливаем службу]]).\\
+{{:uiscom.png}}
+Помимо указанных действий, надо заполнить справочник "внутренние номера" и указать эти номера в справочнике пользователей.
 ==== Включение функции телефонии для пользователей программы ====
-В справочнике «Администрирование - Внутренние номера (настройки софтфонов)» надо создать строки, соответствующие каждому внутреннему номеру (пользователю АТС). Помимо наименования (номера), в поле «вариант подключения телефонии» выбираем «UIS (ЮИС)».\\
+В «Администрирование - Внутренние номера (настройки софтфонов)» надо создать строки, соответствующие каждому внутреннему номеру (пользователю АТС). Помимо наименования (номера), в поле «вариант подключения телефонии» выбираем «UIS (ЮИС)».\\
 На вкладке "Пользователь, пароль" в поле "имя пользователя" вносим числовой id сотрудника в АТС, а в поле "Городской, мобильный номер, соответствующий внутреннему" указываем внешний номер компании (например, 89111234567). Если внешний номер одинаков у всех сотрудников, достаточно указать его в одной из записей.\\
+Примечание. Получить id сотрудников можно запросом
+<code>
+POST https://dataapi.uiscom.ru/v2.0
+{
+  "jsonrpc":"2.0",
+  "id":"number",
+  "method":"get.employees",
+  "params":{
+ "access_token": "ВАШ ТОКЕН"
+  }
+}
+</code>
+Если CALLApi не используется, можно не получать коды сотрудников, а вместо них в справочнике внутренних номеров указать ФИО (требуется точное совпадение с данными, внесенными в список сотрудников АТС).
-Создав внутренние номера, в справочнике «Администрирование — пользователи» для каждого сотрудника на вкладке «IP-телефония» выбираем внутренний номер. Если пользователь уже вошел в программу на момент назначения номера, он должен выйти и войти повторно для использования телефонии.\\
+Создав внутренние номера, в справочнике «Администрирование — пользователи» для каждого сотрудника на вкладке «IP-телефония» выбираем внутренний номер. Если пользователь уже вошел в программу на момент назначения номера, он должен выйти и войти повторно.\\
 Подробнее о настройке внутренних номеров:
 [[внутренние_номера|Внутренние номера (настройки софтфонов)]]
-[[телефония|К оглавлению раздела "телефония"]]
+Дополнительная информация:
+[[https://new.uiscom.ru/blog/integratsiya-samopisnoy-crm-s-telefoniey/|Инструкция по настройке на сайте АТС]]
+[[телефония|К оглавлению раздела "телефония"]]