Omnidesk - сервис для поддержки и общения с клиентами
Функциональность интеграции
- уведомление о входящем вызове
- автоматическое открытие профиля пользователя при входящем звонке
- создание обращений при входящем звонке от неизвестного пользователя
- создание обращений при пропущенных звонках
- исходящий звонок по клику
Подключение интеграции
В Личном кабинете UIS войдите в раздел Тарифы и опции, разверните Все опции:
И подключите API «Базовые отраслевые решения»:
Перейдите в раздел Правила и настройки безопасности, вкладка API и добавьте маску IP адреса 0.0.0.0/0
0.0.0.0/0
Войдите в Управление пользователями, разрешите одному из пользователей (например, Администратору) доступ к API и скопируйте ключ:
В аккаунте Omnidesk войдите в аккаунт администратора — раздел Настройки — Интеграции — кнопка Добавить интеграцию — опция UIS.
Вставьте скопированный ключ в соответствующее поле:
В этом же разделе соотнесите сотрудников UIS с сотрудниками Omnidesk:
Настройка уведомлений
Чтобы данные о звонках передавались из UIS в Omnidesk, необходимо настроить шесть уведомлений о событиях в личном кабинете UIS.
Для настройки уведомлений понадобится URL адрес Omnidesk, скопируйте его из настроек интеграции:
В личном кабинете UIS перейдите в раздел Уведомления и кликните Добавить уведомление:
Необходимо настроить шесть уведомлений:
1) Название уведомления: Поднятие трубки
Тип события: Поднятие трубки
Способ уведомления: 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}}
}2) Название уведомления: Завершение плеча
Тип события: Завершение плеча
Способ уведомления: 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}}
}3) Название уведомления: Завершение звонка
Тип события: Завершение звонка
Способ уведомления: 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}}
}4) Название уведомления: Записанный разговор
Тип события: Записанный разговор
Способ уведомления: 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}}
}5) Название уведомления: Исходящее плечо
Тип события: Исходящее плечо
Способ уведомления: 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}}
}6) Название уведомления: Исходящий звонок
Тип события: Исходящий звонок
Способ уведомления: 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 читайте в инструкции.
