Подсистема «МАХ»

Подсистема «МАХ» предназначена для интеграции с национальным мессенджером МАХ. Подсистема обеспечивает двустороннюю связь между Системой и мессенджером MAX. Её ключевая задача — автоматизировать взаимодействие с клиентами через канал, которому пользователи доверяют. Через API MAX подсистема может отправлять сообщения, управлять чат-ботами, получать уведомления о событиях.
Основная функциональность подсистемы:
-   Оправка сообщений и уведомлений;
-   Работа с чат-ботом;
-   Получение статусов доставки.
Для обеспечения стабильной работы подсистемы реализована логика проверки доступности API. Это позволяет подсистеме корректно обрабатывать ситуации, когда связь с мессенджером временно отсутствует. Проверка может выполняться по расписанию или при каждом цикле запуска, с заданным интервалом. В случае недоступности API система генерирует соответствующее уведомление.

Сервис/подсистема консультаций с применением телемедицинских технологий и закрытия листка нетрудоспособности онлайн с использованием платформы МАХ
Сервис/подсистема предназначен/на для интеграции с национальным мессенджером МАХ в части проведения ТМК в мини-приложении и закрытии листка нетрудоспособности.
На стороне подсистемы реализован сервис в формате мини-приложения (mini-app).
Описание процесса проведения ТМК «Врач-Пациент» со стороны пациента-пользователя МАХ:
-        пациент переходит в чат-бот МАХ и запускает mini-app;
-        mini-app просит пациента МАХ авторизоваться в ЕСИА;
-        после авторизации пациента в ЕСИА запрашиваются согласия на обработку персональных данных, на оказание ТМК, согласие с политикой конфиденциальности (только при первом заходе);
-        пациент попадает на главный экран mini-app с возможностью перехода в раздел «Телемедицинские услуги»;
-        в разделе «Телемедицинские услуги» по данным ЕСИА пациента в Системе подгружаются ранее поданные заявки и доступные действия по подаче и работе с заявками на ТМК «Врач-Пациент»;
-        пациент может подать новую заявку по доступным профилям помощи (согласно прикреплению) в те МО, которые готовы оказать услугу ТМК «Врач-Пациент». У пациента должна быть возможность загрузить дополнительные файлы, оставить комментарий к заявке;
-        по назначении врача на заявку ТМК «Врач-Пациент» (или после записи к врачу напрямую) у пациента появляется возможность общения и обмена данными в чате по заявке;
-        пациент получает уведомления по событиям с поданной им заявкой на ТМК «Врач-Пациент»;
-        пациент имеет возможность предзагрузки вложений (файлов);
-        в назначенное время пациент может перейти к ВКС и получить консультацию. Инициатором ВКС является врач.
Описание процесса проведения ТМК со стороны врача:
-        врач работает в Системе и в соответствии с установленным процессом проведения ТМК «Врач-Пациент» получает заявку от пациента со всеми внесёнными им данными;
-        врач обрабатывает заявку предоставляя пациенту консультацию в чате и по ВКС;
-        врач также, как и пациент получает уведомления по событиям с заявкой по настроенным на уровне Системы каналам связи;
Заявка на ТМК «Врач-Пациент» остаётся доступна пациенту, а также администратору МО для сбора оперативной отчётности различного формата – о количестве проведённых ТМК «Врач-Пациент» по профилям помощи, по источникам заявок, по врачам в разрезе МО.

Сервис/подсистема «Сервис передачи статистических событий в МАКС»
Сервис/подсистема предназначен/предназначена для передачи статистических событий региональных сервисов здравоохранения в МАХ в информационную систему, агрегирующую события.
Реализован сервис передачи статистических событий в МАХ. Настоящий сервис предназначен для передачи статистических событий, произошедших в рамках взаимодействия пользователей с региональным сервисом MAX.
Формат запроса:
Передача статистических событий производится с помощью REST API запроса:
curl --location 'https://tracker-s2s.my.com/v1/customEvent/?idApp=<ID
ПРИЛОЖЕНИЯ>\ --header 'Authorization: <ТОКЕНАВТОРИЗАЦИИ>' \ --header 'Content-Type: application/json' \ --data '{
"customUserId": "<ID ПОЛЬЗОВАТЕЛЯ В MAX>",
"customEventName": "<ТИПСОБЫТИЯ>",
"customEventParams": {
"bot_name": "<НИКНЕЙМБОТА>",
"region": "<РЕГИОНБОТА>"
},
"eventTimestamp": <UNIX TIMESTAMP СОБЫТИЯ>
}'

Таблица 1 Описание параметров запроса
Коды ответов информационной системы, агрегирующей события, полученные от регионального Сервиса СП представлены в Таблица 2.
Таблица 2 Коды ответов


Описание параметров передаваемый событий с использованием Сервиса СП представлено в Таблица 3.
Таблица 3 Описание параметров событий

В рамках текущей интеграции, допустимы типы событий, указанные в Таблица 4, передаваемые в качестве параметра customEventName при запросе в REST API.
Таблица 4 Допустимые типы событий

В настройках системы могут отключаться типы событий, которые отправляются в Сервис МАХ, т.к. у Заказчика необходимые сервисы могут отсутствовать (например, событие appointment_open_znp).

Сервис записи на приём к врачу с использованием платформы МАХ
Сервис предоставляет возможность записи на прием с учетом «Методических рекомендаций организации записи на прием к врачу, в том числе через единый портал государственных и муниципальных услуг и единые региональные кол-центры». Последовательность прохождения шагов подбора слотов для записи определяется на уровне региона.
У пользователя имеется возможность записать на приём и посмотреть активные записи:
-   Себя;
-   Ребёнка;
-   Другого человека.
Основное меню
Сервис предоставляет пользователю основное меню с набором кнопок, соответствующих реализованным в чат-боте функциональным возможностям:
-   Запись на приём;
-   Посмотреть мои записи.
Запись на приём
Последовательность шагов включает:
1.              Выбор медицинской организации - отображение списка доступных МО. При выборе пользователем медицинской организации чат-бот должен предлагать пользователю выбрать медицинскую организацию. Должен отображаться список доступных к выбору медицинских организаций.
2.              Выбор специализации врача - отображение списка доступных специализаций. При выборе пользователем должности врача чат-бот должен предлагать пользователю выбрать должность врача. Если нет доступных должностей врача (специальностей врача) для записи, то вывести сообщение: "В настоящий момент нет специальностей доступных для записи, попробуйте позднее" с возможностью возврата на предыдущий шаг.
3.              Выбор врача. Необходимо отобразить список доступных врачей.
4.              Выбор даты записи - отображение доступных дат. Пользователю должны предлагаться доступные для записи. Если нет записи на прием, то вывести сообщение "Нет доступных дат для записи на прием" с возможностью возврата на предыдущий шаг.
5.              Выбор времени записи - отображение доступных временных слотов с возможностью переключения между датами. Если нет доступного времени на прием, то выводится сообщение "Нет доступного времени для записи на прием, попробуйте позднее." с возможностью возврата на предыдущий шаг.
6.              На каждом шаге должна быть предусмотрена кнопка «Назад» для возврата на предыдущий шаг или в основное меню.
Подтверждение записи
Сервис запрашивает подтверждение записи, отображая сводную информацию:
-   Медицинская организация (наименование, адрес);
-   Специальность врача;
-   Дата и время приема.
Должны быть предоставлены кнопки «Записаться» и «Назад».
Управление записями
Сервис предоставляет возможность:
-   Просмотра всех активных записей пациента «Посмотреть мои записи»;
-   Отмены записи с обязательным подтверждением действия.
Оповещение о записи на прием
Сервис отправляет уведомление о предстоящей записи:
-   За сутки;
-   За 15 минут.

Сервис обратной связи по оказанной мед. помощи
Сервис имеет возможность автоматизированного сбора оценок пациентов о качестве оказанных медицинских услуг (очный приём и телемедицинская консультация) и формирования на их основе рейтингов:
⸺     индивидуального рейтинга врача;
⸺     совокупного рейтинга медицинской организации.
Полученные данные будут использоваться для внутреннего контроля качества, мотивации персонала и информирования пациентов при выборе врача.
Основные сущности модуля представлены в Таблица 5.

Таблица 5 Основные сущности модуля
Условия отправки
Типы услуг, после которых отправляется запрос:
⸺            Очный приём (завершённый визит к врачу);
⸺            Телемедицинская консультация (ТМК) со статусом «Завершена».
Время отправки: на следующие сутки после даты оказания услуги.
Пример: приём был 15.05.2026 в 14:30 → запрос отправляется 16.05.2026 в 14:30.
Запрос на прохождения опроса отправляется в МАХ-бот.
На один завершённый приём/консультацию отправляется не более одного запроса.
Если пациент не ответил — повторных автоматических запросов не отправляется. Фиксируется что пациент отказался от прохождения опроса.
Типы вопросов и варианты ответов указаны в Таблица 6.

Таблица 6 Типы вопросов и варианты ответов

Каждый ответ сохраняется в базе данных.
Формирование рейтинга врача
Для формирования рейтинга врача берётся среднеарифметическое правило.
Рейтинг врача = (Сумма всех оценок по 5-балльным вопросам) / (Количество всех ответов по 5-балльным вопросам).
Учитываются только вопросы с 5-балльной шкалой (вопросы «Да/Нет» в рейтинг врача не включаются).
Один приём даёт несколько оценок (по каждому 5-балльному вопросу). Все они участвуют в расчёте.
Результат должен округляться до двух знаков после запятой (например, 4.42).
Рейтинг может рассчитываться:
⸺            За всё время (общий рейтинг врача);
⸺            За выбранный период (для отчётов).
Формирование рейтинга медицинской организации
Для расчёта рейтинга МО берётся рейтинг врача, который относится к данной МО.
Рейтинг МО = (Сумма рейтингов всех врачей МО) / (Количество врачей МО).
Учитываются только врачи, имеющие хотя бы одну анкету.
Врачи без оценок в расчёт рейтинга МО не включаются.

Сервис проведения ТМК(ВКС) средствами платформы МАКС
Осуществлена интеграция и перевод сервисов видеоконференцсвязи (ВКС) для проведения телемедицинских консультаций (ТМК) на интеграционные методы API национального мессенджера MAX (https://dev.max.ru/docs-api), на основании методических рекомендаций, предоставленных министерством здравоохранения Российской Федерации.