UIS — IP-телефония

UIS — профессиональная облачная телефония для бизнеса. Интеграция с LiveSklad позволяет видеть данные клиента и его заказы при входящем звонке, звонить клиентам напрямую из заказа или карточки контрагента, а также отслеживать историю всех звонков в разделе аналитики.

Интеграция

Шаг 1. Создание API-ключа

В сервисе UIS перейдите в раздел: Настройки → Сотрудники и отделы

Откройте настройки пользователя – Администратор (⚙️)

Прокрутите вниз до раздела "Дополнительные настройки"

В блоке "Использование API" включите все три галочки:

Активируйте переключатель "Ключ API активен"

Установите время жизни "Всегда"

Скопируйте сгенерированный ключ

Нажмите "Сохранить"

Шаг 2. Настройка белого списка IP-адресов

Для работы интеграции необходимо добавить IP-адреса LiveSklad в белый список доверенных адресов, с которых разрешены запросы к API UIS. Без этой настройки интеграция работать не будет.

В личном кабинете UIS, используя аккаунт администратора, нажмите на иконку администратора в левом нижнем углу.

Перейдите в раздел «Безопасность → Настройки безопасности».

Перейдите на вкладку «API».

Нажмите «Добавить».

Добавьте следующие IP-адреса LiveSklad:

После добавления каждого адреса нажмите на значок дискеты рядом с полем, чтобы сохранить его.

Если необходимо разрешить работу API с любых IP-адресов, вместо адресов LiveSklad можно указать маску 0.0.0.0/0. Это разрешит запросы с любых адресов.

Шаг 3. Подключение в LiveSklad

В LiveSklad перейдите в раздел: Настройки → Телефония → UIS

Вставьте скопированный API-ключ и нажмите "Подключить"

При успешном подключении отобразится номера телефонов зарегистрированных в UIS

Скопируйте ссылку для уведомлений, которую сгенерирует система

Шаг 4. Настройка уведомлений в UIS

В сервисе UIS необходимо создать два уведомления — для входящих и завершённых звонков.

В UIS перейдите в раздел "Настройки → HTTP-уведомления" и нажмите "Добавить уведомление"

Создайте первое уведомление:

В разделе "Способы уведомлений" включите HTTP и заполните:

Тело уведомления (JSON-шаблон – одинаковое для обоих уведомлений):

{
  "notification_mnemonic": {{notification_mnemonic}},
  "notification_timestamp": {{notification_timestamp}},
  "call_session_id": {{call_session_id}},
  "contact_phone_number": {{contact_phone_number}},
  "extension_phone_number": {{extension_phone_number}},
  "direction": {{direction}},
  "talk_time_duration": {{talk_time_duration}},
  "employee_id": {{employee_id}},
  "is_lost": {{is_lost}},
  "full_record_file_link": {{full_record_file_link}}
}

Нажмите "Сохранить"

Создайте второе уведомление аналогично, но с типом события "Завершение звонка" — тело уведомления то же самое

Шаг 5. Настройка внутренних номеров

Привяжите сотрудников LiveSklad к внутренним номерам UIS:

В LiveSklad перейдите в Настройки → Телефония → UIS

Для каждого сотрудника укажите его внутренний номер из UIS

Сохраните изменения

Если всё сделано правильно, то при входящем звонке вы увидите всплывающее уведомление с данными клиента и его заказами. Также у вас будет возможность позвонить клиенту непосредственно из заказа или карточки контрагента.

В журнал звонков можно попасть через раздел “Аналитика / Звонки”.