32top - Облачная МИС для стоматологий
Функционал интеграции
- Открытие карточки в МИС
- История звонков в МИС
- Прослушивание записи звонка в МИС
Подключение и настройка
В Личном кабинете UIS войдите в раздел Администратор — Аккаунт — Тарифы и опции, разверните Все опции:
и подключите API «Базовые отраслевые решения»:
Перейдите в раздел Аккаунт — Правила и настройки безопасности — вкладка API и добавьте маску 0.0.0.0/0 в белый список IP-адресов:
Чтобы UIS и МИС 32top могли обмениваться данными, необходимо создать авторизационный ключ API. Для этого войдите в Управление пользователями:
Разрешите Администратору доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании, и понадобится для дальнейшей настройки:
В МИС 32top войдите в меню Настройки, выберите Интеграции, в разделе UIS введите скопированный ключ API:
Синхронизация сотрудников
Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в Личном кабинете UIS, и в сервисе МИС 32top.
В МИС 32top для каждого сотрудника, которому предоставлен доступ к телефонии, назначьте соответствующего сотрудника из Личного кабинета UIS:
Настройка передачи данных о звонках
Чтобы МИС 32top принимал данные о звонках от UIS, нужно настроить четыре вебхука.
В Личном кабинете UIS войдите в раздел Уведомления и кликните на Добавить уведомление:
Логика создания одинаковая для всех вебхуков, различаются только параметры. Заполните поля и сохраните вебхуки:
1) Название уведомления: Потерянный звонок.Метод: POST
URL https://api.32top.ru/uis-integration-api/events/call/missed
В тело уведомления вставьте код:
{
"app_id": {{app_id}},
"call_session_id":{{call_session_id}},
"contact_phone_number":{{contact_phone_number}},
"virtual_phone_number":{{virtual_phone_number}},
"employee_ids":{{employee_ids}},
"external_id": {{external_id}},
"direction":{{direction}},
"start_time": {{start_time}},
"finish_time": {{finish_time}}
}
2) Название уведомления: Ожидание ответа.
Метод: POST
URL https://api.32top.ru/uis-integration-api/events/call/waiting
В тело уведомления вставьте код:
{
"app_id": {{app_id}},
"call_session_id":{{call_session_id}},
"contact_phone_number":{{contact_phone_number}},
"virtual_phone_number":{{virtual_phone_number}},
"employee_id":{{employee_id}},
"external_id": {{external_id}},
"direction":{{direction}},
"start_time": {{start_time}}
}
3) Название уведомления: Начало разговора.
Метод: POST
URL https://api.32top.ru/uis-integration-api/events/call/started
В тело уведомления вставьте код:
{
"app_id": {{app_id}},
"call_session_id":{{call_session_id}},
"direction":{{direction}},
"start_time": {{start_time}},
"employee_id": {{employee_id}},
"external_id": {{external_id}}
}
4) Название уведомления: Завершение звонка.
Метод: POST
URL https://api.32top.ru/uis-integration-api/events/call/ended
В тело уведомления вставьте код:
{
"app_id": {{app_id}},
"call_session_id":{{call_session_id}},
"direction":{{direction}},
"talk_time_duration":{{talk_time_duration}},
"start_time":{{start_time}},
"finish_time":{{finish_time}},
"finish_reason":{{finish_reason}},
"virtual_phone_number":{{virtual_phone_number}},
"full_record_file_link":{{full_record_file_link}},
"lost": {{lost_reason}},
"external_id": {{external_id}}
}
