Ссылка скопирована
Мы используем cookie и Яндекс.Метрику, чтобы сайт работал лучше
Поиск

Процесс работы по лидогенерации

Содержание:

Процесс взаимодействия по лидогенерации

Процесс тестирования

Этапы реализации интеграции

Данная статья призвана помочь сервисам, предоставляющим генерацию лидов (далее "лидогенерация") в интеграции с МедФлексом.

Важно! Если у вас остались вопросы или вы столкнули с проблемой не описанной в данной статье, свяжитесь с вашим личным менеджером

Процесс взаимодействия по лидогенерации

1) Лидогенератор запрашивает общий список клиник от МедФлекса

Метод МедФлекса – GET /models/lpu/all/

Лидогенератор получает от МедФлексом общий список ID клиник, в которых возможна онлайн-запись по лидогенерации (у клиники имеется интеграция онлайн-записи с МедФлекс и хотя бы 1 врач, сопоставленный с ПроДокторов)

2) МедФлекс запрашивает "белый список" клиник от Лидогенератора

Метод на стороне Лидогенератора – GET /lpu_whitelist/

URL и параметры авторизации необходимо передать менеджеру по работе с партнёрами МедФлекса

МедФлекс получает от Лидогенератора список ID клиник, по которым Лидогенератор готов создавать онлайн-записи. При этом, МедФлекс также уведомляет клиники из белого списка о том, что им доступна интеграция и функционал лидогенерации на площадке Лидогенератора.

Ответ по методу всегда должен содержать актуальный список клиник со стороны Лидогенератора. Клиникам, не попавшим в этот список, будет недоступен функционал лидогенерации.

Обновление "белого списка" клиник

МедФлекс 1 раз в час опрашивает метод с "белым списком" клиник, актуализирует данные на своей стороне и дает возможность включить лидогенерацию только тем клиникам, которые были возвращены методом белого списка клиник со стороны Лидогенератора.

Если клиника была исключена Лидогенератором из своего "белого списка", МедФлекс отправит ей уведомление о недоступности лидогенерации на площадке Лидогенератора. Повторное включение интеграции клиникой возможно только вручную в личном кабинете МедФлекса.

3) Клиника включает интеграцию в личном кабинете МедФлекса

Менеджер клиники, которой доступна интеграция с Лидогенератором, включает её в личном кабинете МедФлекса. Так же клиника может самостоятельно включить интеграцию по лидогенерации, подробнее о включении описано в статье - Подключение лидогенератора.

Лидогенератору становится доступно создание онлайн-записи по лидогенерации сразу после включения интеграции клиникой.

4) Лидогенератор запрашивает от МедФлекса список клиник, включивших интеграцию с Лидогенератором

Метод МедФлекса – GET /models/lpu/

Успешный ответ содержит список клиник, удовлетворяющих обоим условиям:

  1. клиника включена в белый список Лидогенератора
  2. клиника включила интеграцию с Лидогенератором в личном кабинете МедФлекс

5) МедФлекс отправляет уведомление о статусе доступности / недоступности клиники для онлайн-записи

Веб-хук для получения уведомлений реализовывается на стороне Лидогенератора.

URL и параметры авторизации необходимо передать менеджеру по работе с партнёрами МедФлекса

Отправка МедФлексом запроса на переключение клиники в статус «недоступна» происходит при выполнении одного или более условий из списка:

  • автоматическое обнаружение технических проблем с онлайн-записью на стороне клиники;
  • выявление недостаточности средств на счёте клиники для оплаты записи;
  • расторжение договора с МедФлексом;
  • отключение интеграции с Лидогенератором в личном кабинете МедФлекса;
  • закрытие клиники.

Отправка запроса на переключение клиники в статус «доступна» происходит после того, как все указанные причины недоступности клиники для онлайн-записи были исправлены.

Пример запроса от МедФлекса:

{
⠀"id": int, // ID клиники, полученный через/models/lpu/all/
⠀"status": int, // 0 - недоступна, 1 - доступна
⠀"reason": int, // передается только, если status == 0
⠀"timestamp": str // время возникновения события в формате "2025-02-27T16:26:03.419752"
}

Возможные значения "reason":

1 - недоступна из-за проблем с онлайн записью;

2 - недоступна из-за недостаточного количества средств на балансе для оплаты записи;

3 - расторжение договора;

4 - клиника отключила интеграцию;

5 - клиника закрылась

6) Лидогенератор отправляет запрос на создание онлайн-записи

Лидогенератор отправляет запрос на создание онлайн-записи к врачу со своей площадки. МедФлекс фиксирует сумму оплаты за данный лид по согласованному в договоре прайс-листу

Методы API для реализации онлайн-записи в клинику:

  1. Группа методов "Модели"
  2. Получение расписания - GET /schedule/
  3. Создание онлайн-записи - POST /direct_appointment/doctor/execute/
  • Метод /direct_appointment/doctor/execute/ позволяет создать онлайн-запись, но для того, чтобы предварительно определить доступный для записи слот, необходимо получить расписание врача по методу GET /schedule
  • Методы в группе Модели необходимы для метчинга данных по врачам и клиникам, а также для реализации фильтров при выборе врача и клиники пользователем площадки Лидогенератора.

Процесс тестирования

Тестирование проходит в 3 этапа:

  1. Тестирование на тестовых клиниках
  2. Тестирование на реальных клиниках с имитацией записи в МИС (без реальной записи в МИС)
  3. Пилотный запуск с реальной клиникой

На 1 и 2 этапе используется один токен для тестирования. При проведении пилота будет выдан новый токен.

Этапы реализации интеграции

  1. Подписание договора между Лидогенератором и МедФлексом с фиксацией стоимости лидов по городам
  2. Отправка тестового токена Лидогенератору
  3. Разработка интеграции Лидогенератором с промежуточным тестированием на тестовых клиниках
  4. Тестирование полной цепочки взаимодействия на тестовых клиниках
  5. Тестирование на реальных клиниках с имитацией записи в МИС (без реальной записи в МИС)
  6. Отправка production-токена Лидогенератору
  7. Пилотный запуск с реальной клиникой