МИС MEDODS - медицинская CRM

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

Входящие звонки

При поступлении входящего вызова всплывает уведомление:

По клику на уведомление открывается карточка звонка:

Пропущенные звонки

Исходящие звонки

Из любого интерфейса MEDODS можно совершить исходящий звонок по клику на номер абонента:

Автоматическое напоминание о записи и подтверждение записи на прием

В связке с телефонией MEDODS может генерировать автозвонки пациентам без участия человека:

История звонков

В модуле Коммуникации можно увидеть список всех звонков вместе с записями разговоров:

Определение рекламного источника для звонков 

Пользователям коллтрекинга в UIS доступна настройка соответствия номеров и рекламных кампаний для отображения в MEDODS:

Опции, которые нужно подключить в UIS

API Оптимальный - для всплывающих уведомлений о входящих и пропущенных звонках, идентификации звонящего, исходящих звонков по клику, определения рекламного источника и прослушивания звонков из CRM.

или

API Расширенный - для всего вышеперечисленного + для Автоматического напоминания о записи и Подтверждения записи на прием.

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

Обратитесь в поддержку МИС MEDODS для подключения модуля телефонии в вашем аккаунте. 

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

И подключите API Оптимальный (или API Расширенный, если вы будете использовать Автоматическое напоминание о записи и подтверждение записи на прием):

Чтобы UIS и MEDODS могли обмениваться данными, необходимо разрешить запросы к серверу UIS от любых IP-адресов и создать авторизационный ключ API.

Перейдите в раздел Аккаунт - Правила и настройки безопасности - вкладка API добавьте 0.0.0.0/0 в белый список:

Чтобы получить авторизационный ключ API, войдите в Управление пользователями и разрешите одному из пользователей (например, Администратору) доступ к API по ключу. Обязательно скопируйте и сохраните ключ - он показывается только один раз, при создании, и понадобится для финальной настройки:

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

Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в личном кабинете UIS, и в сервисе MEDODS.

Проверьте данные сотрудников: ФИО сотрудников в UIS и в MEDODS должны совпадать. В UIS необязательно копировать всех сотрудников, которые есть в MEDODS, нужны данные только тех сотрудников, которые будут принимать звонки.

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

Чтобы MEDODS принимал данные о звонках от UIS, нужно настроить вебхуки (HTTP-уведомления) в Личном кабинете UIS. Для этого понадобится:

1. Получить ключ API MEDODS. Для этого войдите в раздел Справочники:

Клиенты API:

Добавьте нового клиента, назовите его UIS и сохраните:

Откройте созданного клиента и скопируйте значение из поля Токен доступа:

Сохраните токен, он понадобится для дальнейшей настройки.

2. Сформировать URL-адрес для отправки вебхуков из UIS в MEDODS. URL-адрес имеет такой вид:

• для локальных версий 3.8 и выше: http://ip-адрес:№порта/api/v2/telephony/uis 

• для локальной версии 3.7: http://ip-адрес:№порта/telephony/uis

• для облачной версии: **https://URL.medods.ru/api/v2/telephony/uis** 

Подставьте ваш IP-адрес и номер проброшенного порта (локальные абоненты) или адрес, по которому вы заходите в Medods (облачные абоненты).

Сохраните URL и ключ API, они понадобятся для дальнейшей настройки.

Перейдите в Личный кабинет UIS, раздел Уведомления и кликните Добавить уведомление:

Количество уведомлений зависит от того, какую функциональность вы хотите использовать. Логика создания уведомлений одна: добавляете новое уведомление, заполняете параметры и сохраняете. 

Уведомления о входящих звонках

Для корректной работы всплывающих уведомлений нужно настроить четыре уведомления.

• первое уведомление

Название: Входящий звонок 

Тип события: Входящий звонок на виртуальный номер 

Условия: Включить - Направление звонка - Точно соответствует - Входящий звонок 

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

Метод: POST 

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст:

{
"access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
"calls": {
"notification_mnemonic": {{notification_mnemonic}},
"contact_phone_number": {{contact_phone_number}},
"direction": {{direction}},
"call_source": {{call_source}},
"called_phone_number": {{called_phone_number}},
"call_session_id": {{call_session_id}}
}
}

Нажмите Создать.

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

Название: Принятый звонок

Тип события: Начало разговора

Условия: Нет 

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

Метод: POST 

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст:

{
"access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
"calls": {
"notification_mnemonic": {{notification_mnemonic}},
"employee_full_name": {{employee_full_name}},
"employee_id": {{employee_id}},
"direction": {{direction}},
"call_session_id": {{call_session_id}},
"call_source": {{call_source}}
}
}

Нажмите Создать.

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

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

Тип события: Окончание разговора 

Условия уведомлений: Нет 

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

Метод: POST 

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст:

{
"access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
"calls": {
"notification_mnemonic": {{notification_mnemonic}},
"talk_time_duration": {{talk_time_duration}},
"direction": {{direction}},
"call_source": {{call_source}},
"call_session_id": {{call_session_id}}
}
}

Нажмите Создать.

• четвертое:

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

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

Условия уведомлений: Нет 

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

Метод: POST 

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст (для старой версии до 3.9):

{
 "access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
 "calls": {
 "notification_mnemonic": {{notification_mnemonic}},
 "file_link": {{full_record_file_link}},
 "call_session_id": {{call_session_id}}
 }
 }

{
 "access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
 "calls": {
 "notification_mnemonic": "talk_record_file",
 "file_link": {{full_record_file_link}},
 "call_session_id": {{call_session_id}}
 }
 }

Нажмите Создать.

Уведомления о пропущенных звонках

Название уведомления: Пропущенный звонок

Тип события: Потерянный звонок

Условия уведомлений:

* Группа 1:

Включить - Направление звонка - Точно соответствует - Входящий звонок

* Группа 2:

Исключить - Источник звонка - Точно соответствует - CallAPI Базовый набор

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

Метод: POST

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст:

{
"access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
"calls": {
"notification_mnemonic": {{notification_mnemonic}},
"noanswered_employee_full_names": {{noanswered_employee_full_names}},
"noanswered_employee_ids": {{employee_ids}},
"direction": {{direction}},
"call_source": {{call_source}},
"call_session_id": {{call_session_id}}
}
}

Нажмите Создать.

Автоматическое напоминание о записи и подтверждение записи на прием 

Для работы этих функций в Личном кабинете UIS должна быть подключена опция API Расширенный. Если вы изначально подключили опцию API Оптимальный, отключите ее после подключения новой опции.

Настройка автозвонков происходит в два этапа: настройка сценариев в Личном кабинете UIS и создание вебхуков.

Перейдите в раздел Виртуальная АТС - Сценарии, кликните Добавить сценарий и в открывшейся форме настройте следующий сценарий:

Обязательно задавайте сценариям такие же названия, как на скриншотах, от этого зависит дальнейшая настройка.

Сохраните и по аналогии создайте второй сценарий следующего вида:

В уже знакомом разделе Уведомления добавьте еще четыре уведомления:

• первое

Название уведомления: Автонапоминание

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

Условия уведомлений:

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

Метод: POST

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст:

{
"access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
"calls": {
"notification_mnemonic": "reminder_call",
"lost_call": {{is_lost}},
"call_session_id": {{call_session_id}}
}
}

Нажмите Создать.

• второе

Название уведомления: Автоподтверждение (прием подтвержден)

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

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

Метод: POST

Условия уведомлений:

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

Метод: POST

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст:

{
"access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
"calls": {
"notification_mnemonic": "confirmation_call",
"confirmation": true,
"call_session_id": {{call_session_id}}
}
}

Нажмите Создать.

• третье

Название уведомления: Автоподтверждение (прием отклонен)

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

Условия уведомлений:

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

Метод: POST

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст:

{
"access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
"calls": {
"notification_mnemonic": "confirmation_call",
"confirmation": false,
"call_session_id": {{call_session_id}}
}
}

Нажмите Создать.

• последнее

Название уведомления: Автоподтверждение (пропущен)

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

Условия уведомлений:

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

Метод: POST

URL: вставьте URL, сформированный ранее

В тело уведомления вставьте текст:

{
"access_token": "ВСТАВЬТЕ КЛЮЧ API ИЗ MEDODS",
"calls": {
"notification_mnemonic": "confirmation_call",
"lost_call": true,
"call_session_id": {{call_session_id}}
}
}

Нажмите Создать.

Финальная синхронизация настроек

Помните, в самом начале вы получили ключ API UIS? Отлично, мы подошли к его применению.

Перейдите в аккаунт MEDODS и выполните пошаговые действия, отмеченные на скриншоте:

После обновления страницы:

Теперь настройка завершена.