Omnidesk - сервис для поддержки и общения с клиентами

Функциональность интеграции

• уведомление о входящем вызове 
• автоматическое открытие профиля пользователя при входящем звонке
• создание обращений при входящем звонке от неизвестного пользователя
• создание обращений при пропущенных звонках
• исходящий звонок по клику

Подключение интеграции 

В Личном кабинете UIS войдите в раздел Тарифы и опции, разверните Все опции:

И подключите API Оптимальный:

Перейдите в раздел Правила и настройки безопасности, вкладка API и добавьте маску IP адреса 0.0.0.0/0

Войдите в Управление пользователями, разрешите одному из пользователей (например, Администратору) доступ к API и скопируйте ключ:

В аккаунте Omnidesk войдите в аккаунт администратора — раздел Настройки — Интеграции — кнопка Добавить интеграцию — опция UIS.

Вставьте скопированный ключ в соответствующее поле:

В этом же разделе соотнесите сотрудников UIS с сотрудниками Omnidesk:

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

Чтобы данные о звонках передавались из UIS в Omnidesk, необходимо настроить шесть уведомлений о событиях в личном кабинете UIS.

Для настройки уведомлений понадобится URL адрес Omnidesk, скопируйте его из настроек интеграции:

В личном кабинете UIS перейдите в раздел Уведомления и кликните Добавить уведомление:

В открывшейся форме заполните следующие поля:

• Первое уведомление:

Название уведомления: Поднятие трубки

Тип события: Поднятие трубки

Способ уведомления: HTTP

Метод: POST

URL: из карточки подключения интеграции в Омнидеске + /handset

Тело уведомления:

{
  "notification_name":{{notification_name}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "external_id": {{external_id}},
  "contact_info":{
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name": {{contact_full_name}}
  },
  "employee_info": {
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}}
  },
  "call_info": {
    "call_source": {{call_source}},
    "direction": {{direction}},
    "call_session_id":{{call_session_id}},
    "scenario_name": {{scenario_name}},
    "talk_time_duration": {{talk_time_duration}},
    "total_time_duration": {{total_time_duration}},
    "wait_time_duration": {{wait_time_duration}},
    "tag_names": {{tag_names}},
    "is_lost" : {{is_lost}}
  },
  "call_record_file_info": {
    "file_link": {{file_link}},
    "call_record_duration": {{file_duration}}
  },
  "leg_id": {{leg_id}},
  "leg_ids": {{leg_ids}}
}

Кликните Создать.

• Второе уведомление:

Название уведомления: Завершение плеча

Тип события: Завершение плеча

Способ уведомления: HTTP

Метод: POST

URL: из карточки подключения интеграции в Омнидеске + /endleg

Тело уведомления:

{
  "notification_name":{{notification_name}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "external_id": {{external_id}},
  "contact_info":{
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name": {{contact_full_name}}
  },
  "employee_info": {
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}}
  },
  "call_info": {
    "call_source": {{call_source}},
    "direction": {{direction}},
    "call_session_id":{{call_session_id}},
    "scenario_name": {{scenario_name}},
    "talk_time_duration": {{talk_time_duration}},
    "total_time_duration": {{total_time_duration}},
    "wait_time_duration": {{wait_time_duration}},
    "tag_names": {{tag_names}},
    "is_lost" : {{is_lost}}
  },
  "call_record_file_info": {
    "file_link": {{file_link}},
    "call_record_duration": {{file_duration}}
  },
  "leg_id": {{leg_id}},
  "leg_ids": {{leg_ids}}
}

Кликните Создать.

• Третье:

Название уведомления: Завершение звонка

Тип события: Завершение звонка

Способ уведомления: HTTP

Метод: POST

URL: из карточки подключения интеграции в Омнидеске + /end

Тело уведомления:

{
  "notification_name":{{notification_name}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "external_id": {{external_id}},
  "contact_info":{
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name": {{contact_full_name}}
  },
  "employee_info": {
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}}
  },
  "call_info": {
    "call_source": {{call_source}},
    "direction": {{direction}},
    "call_session_id":{{call_session_id}},
    "scenario_name": {{scenario_name}},
    "talk_time_duration": {{talk_time_duration}},
    "total_time_duration": {{total_time_duration}},
    "wait_time_duration": {{wait_time_duration}},
    "tag_names": {{tag_names}},
    "is_lost" : {{is_lost}}
  },
  "call_record_file_info": {
    "file_link": {{file_link}},
    "call_record_duration": {{file_duration}}
  },
  "leg_id": {{leg_id}},
  "leg_ids": {{leg_ids}}
}

Кликните Создать.

• Четвертое:

Название уведомления: Записанный разговор

Тип события: Записанный разговор

Способ уведомления: HTTP

Метод: POST

URL: из карточки подключения интеграции в Омнидеске + /recording

Тело уведомления:

{
  "notification_name":{{notification_name}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "external_id": {{external_id}},
  "contact_info":{
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name": {{contact_full_name}}
  },
  "employee_info": {
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}}
  },
  "call_info": {
    "call_source": {{call_source}},
    "direction": {{direction}},
    "call_session_id":{{call_session_id}},
    "scenario_name": {{scenario_name}},
    "talk_time_duration": {{talk_time_duration}},
    "total_time_duration": {{total_time_duration}},
    "wait_time_duration": {{wait_time_duration}},
    "tag_names": {{tag_names}},
    "is_lost" : {{is_lost}}
  },
  "call_record_file_info": {
    "file_link": {{file_link}},
    "call_record_duration": {{file_duration}},
    "record_file_links": {{record_file_links}}
  },
  "leg_id": {{leg_id}},
  "leg_ids": {{leg_ids}}
}

Кликните Создать.

• Пятое:

Название уведомления: Исходящее плечо

Тип события: Исходящее плечо

Способ уведомления: HTTP

Метод: POST

URL: из карточки подключения интеграции в Омнидеске + /legout

Тело уведомления:

{
  "notification_name":{{notification_name}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "external_id": {{external_id}},
  "contact_info":{
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name": {{contact_full_name}}
  },
  "employee_info": {
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}}
  },
  "call_info": {
    "call_source": {{call_source}},
    "direction": {{direction}},
    "call_session_id":{{call_session_id}},
    "scenario_name": {{scenario_name}},
    "talk_time_duration": {{talk_time_duration}},
    "total_time_duration": {{total_time_duration}},
    "wait_time_duration": {{wait_time_duration}},
    "tag_names": {{tag_names}},
    "is_lost" : {{is_lost}}
  },
  "call_record_file_info": {
    "file_link": {{file_link}},
    "call_record_duration": {{file_duration}}
  },
  "leg_id": {{leg_id}},
  "leg_ids": {{leg_ids}}
}

Кликните Создать.

• Шестое:

Название уведомления: Исходящий звонок

Тип события: Исходящий звонок

Способ уведомления: HTTP

Метод: POST

URL: из карточки подключения интеграции в Омнидеске + /callout

Тело уведомления:

{
  "notification_name":{{notification_name}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "external_id": {{external_id}},
  "contact_info":{
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name": {{contact_full_name}}
  },
  "employee_info": {
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}}
  },
  "call_info": {
    "call_source": {{call_source}},
    "direction": {{direction}},
    "call_session_id":{{call_session_id}},
    "scenario_name": {{scenario_name}},
    "talk_time_duration": {{talk_time_duration}},
    "total_time_duration": {{total_time_duration}},
    "wait_time_duration": {{wait_time_duration}},
    "tag_names": {{tag_names}},
    "is_lost" : {{is_lost}}
  },
  "call_record_file_info": {
    "file_link": {{file_link}},
    "call_record_duration": {{file_duration}}
  },
  "leg_id": {{leg_id}},
  "leg_ids": {{leg_ids}}
}

Кликните Создать.

Настройка завершена. Подробнее о работе со звонками в Omnidesk читайте в инструкции.