Настройка интеграции с UIS | Matrix. Внешние интеграции

Пути к api

Для корректной работы необходимо в поля "Адрес Call API" и "Адрес Data API" указать пути для строго определенных версий.
Путь к апи может отличаться в зависимости от того где был зарегистрирован проект. Уточнить корректный путь можно у поддержки UIS.

Call API работает с версией 4.0

https://callapi.uiscom.ru/v4.0

https://callapi.comagic.ru/v4.0

Data API работает с версией 2.0

https://dataapi.uiscom.ru/v2.0

https://dataapi.comagic.ru/v2.0

Номер телефона АТС

Данные для заполнения поля можно получить в ЛК UIS. Пункт меню Виртуальная АТС > Виртуальные номера и правила

Настройка уведомлений на сайте

Настройка уведомлений происходит в ЛК UIS. Пункт меню Уведомления.

Необходимо добавить 2 уведомления:

"Начало разговора"
"Окончание разговора"

Тип события - "Начало разговора"
Активно - "Вкл"
Способ уведомления - "HTTP"
Метод - "POST"
URL - https://matrix-address.ru/api/v1/call/uis/incoming где вместо matrix-address.ru нужно подставить адрес вашего Matrix GO
Тело -
{"number": {{contact_phone_number}}, "income_number":{{extension_phone_number}}, "direction": {{direction}}, "call_id": "{{call_session_id}}"}

Тип события - "Завершение звонка"
Активно - "Вкл"
Способ уведомления - "HTTP"
Метод - "POST"
URL - https://matrix-address.ru/api/v1/call/uis/end-call где вместо matrix-address.ru нужно подставить адрес вашего Matrix GO
Тело -
{"number": {{contact_phone_number}}, "income_number":{{extension_phone_number}}, "direction": {{direction}}, "call_id": "{{call_session_id}}"}

У уведомлений есть список IP адресов, с корых они будут рассылаться.

Дополнительно эти адреса можно внести в поле Доступные IP (через запятую) с которых будут обрабатываться уведомления от АТС в формате 127.0.0.1, 127.0.0.2, 127.0.0.3