Это старая версия документа!
Интеграция с АТС ЮИС (UIS) - идет разработка функции
Важно! Интеграция находится в процессе разработки.
Настройки сети
Для работы с АТС потребуется статический внешний ip, если его еще нет, подключите услугу у оператора связи.
Порт 10385 следует «пробросить» на тот компьютер, где будет запущена служба Водяного (не забудьте, что его локальный адрес должен быть постоянным), методика зависит от модели маршрутизатора, через который вы выходите в интернет.
В брандмауэре на сервере надо разрешить Водяному входящие подключения.
Настройки со стороны виртуальной АТС
Чтобы Водяной получил доступ к возможностям ВАТС, придется подключить дополнительные ПЛАТНЫЕ услуги АТС - доступ к уведомлениям и CALL API.
Ваш внешний ip-адрес надо будет добавить в белый список адресов ВАТС, для этого перейдите в раздел «Call API» и добавьте свой внешний адрес в раздел «IP адреса».
Получение ключа (токена)
В разделе «управление пользователями» откройте настройки Администратора и активируйте настройку «Использовать ключ API» в разделе «Доступ к функциональности API». Скопируйте ключ (показывается один раз, при создании) и сохраните его для указания в справочнике ОАТС Водяного. Подробнее о получении токена: https://new.uiscom.ru/academiya/spravochnyj-centr/instrumenty-integratsii-so-storonnimi-servisami/kak-poluchit-postoyannyy-klyuch-api/
Настройка уведомления при входящем звонке
Перейдите в настройки «Уведомлений».
Создайте уведомление для события «Поднятие трубки»», указав в поле url «ваш_внешний_ip:10385»\\.
Выберите метод POST, в тело вставьте следующий текст:
{"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}}}
Настройка Водяного
Со стороны Водяного потребуется заполнить справочник «облачные АТС», а также задать внутренние номера пользователей.
Справочник "Облачные АТС"
Откройте администрирование - "облачные АТС" и создайте новую строку
В поле «адрес сервера провайдера» указываем https://callapi.uiscom.ru/v4.0
В поле «Пароль (токен) АТС» указываем ключ, который ранее получили в личном кабинете АТС.
В поле «запускать сервер от имени …» выбираем пользователя «Служба» (если есть в списке, иначе оставляем пустым и затем устанавливаем службу).
Включение функции телефонии для пользователей программы
В справочнике «Администрирование - Внутренние номера (настройки софтфонов)» надо создать строки, соответствующие каждому внутреннему номеру (пользователю АТС). Помимо наименования (номера), в поле «вариант подключения телефонии» выбираем «UIS (ЮИС)».
На вкладке «Пользователь, пароль» в поле «имя пользователя» вносим числовой id сотрудника в АТС, а в поле «Городской, мобильный номер, соответствующий внутреннему» указываем внешний номер компании (например, 89111234567). Если внешний номер одинаков у всех сотрудников, достаточно указать его в одной из записей.
Создав внутренние номера, в справочнике «Администрирование — пользователи» для каждого сотрудника на вкладке «IP-телефония» выбираем внутренний номер. Если пользователь уже вошел в программу на момент назначения номера, он должен выйти и войти повторно для использования телефонии.
Подробнее о настройке внутренних номеров: Внутренние номера (настройки софтфонов)
Инструменты страницы
