МИС 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, и в сервисе Юздеск.
Проверьте данные сотрудников: ФИО сотрудников в UIS и в MEDODS должны совпадать. В UIS необязательно копировать всех сотрудников, которые есть в MEDODS, нужны данные только тех сотрудников, которые будут принимать звонки.
Настройка уведомлений
Чтобы MEDODS принимал данные о звонках от UIS, нужно настроить вебхуки (HTTP-уведомления) в Личном кабинете UIS. Для этого понадобится:
1. Уточнить у поддержки MEDODS ключ API.
2. Сформировать URL-адрес для отправки вебхуков из UIS в MEDODS. URL-адрес имеет такой вид:
- для пользователей облачной версии: https://demomed.medods.ru/api/v2/telephony/uis
- для локальной версии 3.7: http://ваш ip-адрес:3000/telephony/uis
- для локальных версий 3.8 и выше: http://ваш ip-адрес:3000/api/v2/telephony/uis или http://ваш ip-адрес:32000/api/v2/telephony/uis
где
- ваш IP-адрес - это статический IP-адрес вашего офиса (клиники), его можно получить у вашего Интернет-провайдера.
- 3000 (или 32000 для версий 3.8 и выше) - порт, который нужно пробросить на роутере - это может сделать ваш системный администратор.
Чтобы проверить, верно ли сформирован URL, вставьте его в адресную строку в браузере: если откроется страница авторизации, адрес верный:
Сохраните 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, сформированный ранее
В тело уведомления вставьте текст:
{ "access_token": "{вставьте ключ API из MEDODS}", "calls": { "notification_mnemonic": {{notification_mnemonic}}, "file_link": {{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 и выполните пошаговые действия, отмеченные на скриншоте:
После обновления страницы:
Теперь настройка завершена 🙂