WhatsApp API для клиник и медицинских центров

Обновлено

Клинике важно, чтобы пациент пришёл в своё время, а если не может — предупредил заранее и окно досталось другому. Обычно этим занимается регистратура: обзванивает пациентов накануне, до части не дозванивается, перезванивает. Напоминание в WhatsApp пациент прочитает, когда удобно, и подтвердит одной цифрой, а администратор займётся теми, кто попросил перенос или не ответил.

У медицины есть особенность, которой нет у салона или магазина: сведения о здоровье — деликатные данные. Поэтому здесь столько же внимания тому, что писать нельзя, сколько тому, что можно.

Пример сообщений клиенту
Асель, напоминаем: завтра, 21 октября, в 15:30 приём у врача, ул. Розыбакиева, 247. Ответьте «1» — подтвердить, «2» — перенести.
По вашей просьбе перенесли запись на четверг, 11:30. Ждём вас: пр. Мангилик Ел, 55, 3 этаж. Возьмите удостоверение личности.
Ваши результаты готовы. Получить их можно в регистратуре с удостоверением личности или в личном кабинете на сайте клиники.

Сценарии

Подтверждение сразу после записи

Пациент записался на сайте, по телефону или у стойки — запись появилась в расписании. Сообщение: дата, время, адрес, что взять с собой (удостоверение, направление). Иногда пациент отвечает вопросом — «есть ли парковка?» — и его видит администратор.

Напоминание накануне

Вечером запускается задача: всем, у кого приём завтра, уходит напоминание с просьбой ответить «1» или «2». «1» отмечает визит подтверждённым, «2» ставит администратору задачу связаться и перенести. Любой другой ответ тоже уходит администратору.

Перенос по инициативе клиники

Врач заболел или сдвинулось расписание. Пациентам этого дня уходит сообщение с извинением и двумя-тремя вариантами нового времени. Пациент выбирает цифрой или пишет своё — администратор подтверждает.

Освободилось окно

Пациент просил сообщить, если появится время раньше. Запись отменилась — первому из листа ожидания уходит предложение. Ответил «да» — записываете, молчит 15–20 минут — пишете следующему. Окно не уходит рассылкой всем сразу.

Подготовка к визиту и готовые результаты

Перед визитом, к которому нужно готовиться, пациент получает памятку файлом с нейтральным названием вроде «Памятка к визиту.pdf». Когда готовы анализы, приходит только уведомление — где и как получить результаты, без самих значений.

Как подключить

Запись обычно хранится в медицинской информационной системе (МИС), в сервисе онлайн-записи или просто в таблице. Если ваша система умеет отправлять HTTP-запросы или вебхуки при создании и изменении записи, подключайте их напрямую к POST /messages/send — формат в документации. Если у МИС есть только API для чтения расписания, задача по таймеру забирает приёмы на завтра и отправляет напоминания.

Небольшой клинике хватит Google Таблицы: скрипт Apps Script по расписанию отправляет напоминания. Ответы «1» и «2» надёжнее принимать через n8n, Make или свой сервер — веб-приложение Apps Script отвечает перенаправлением, а мы перенаправления не выполняем. Клиники на 1С отправляют запросы прямо из конфигурации. Логика напоминаний пошагово — в гайде напоминания о записи.

Ответы пациентов приходят событием message на ваш вебхук: телефон и текст. Код пишет разработчик вашей МИС или свой программист, без кода — интегратор на n8n или Make, или мы — по заявке из кабинета.

Что важно учесть

  • Никаких диагнозов в сообщениях. Не пишите диагнозы, результаты анализов, названия препаратов и процедур. Текст видно на заблокированном экране, а телефон могут взять родственники или коллеги. Для деликатных направлений лучше «приём у врача», чем название специальности.
  • Минимум данных: имя, дата, время, адрес. Всё остальное — в личном кабинете или на приёме.
  • Пишите тем, кто записался. Согласие на напоминания удобно получать при записи — галочкой в форме или вопросом администратора. Акции по базе пациентов — не для этого канала.
  • Где хранятся данные. Сервер, журнал сообщений и файлы wapi.kz находятся в Казахстане, история хранится без срока. Клинике стоит подумать о выключении хранения текстов: тогда останутся только время, направление и статус, а файлы перестанут сохраняться. Сами сообщения проходят через инфраструктуру WhatsApp — это верно для любого способа подключения. Требования закона РК «О персональных данных и их защите» разобраны в гайде о локализации данных; это не юридическая консультация, уточните у юриста.
  • Регистратура видит всё. Номер остаётся на телефоне: напоминания видны в чатах, администратор отвечает сам. Его ответы приходят событием message.out — автоматике в такой чат лучше не вмешиваться.
  • Фото и документы от пациентов видны на телефоне и сохраняются в хранилище wapi.kz в Казахстане — в зашифрованном виде, ссылка на файл есть в истории сообщений. Если хранить их не нужно, включите автоудаление файлов или выключите хранение переписки.
  • Новый номер разгоняется постепенно. Первые три дня после подключения — до 20 первых сообщений новым людям в сутки, к концу второй недели — до 80, затем 150 на базовом уровне. Не переводите все напоминания на WhatsApp в первый же день. Риск блокировки есть у любого неофициального подключения — как его снизить.

Сколько стоит

9 900 ₸ в месяц за номер, без платы за сообщения: напоминания десяти пациентам и тысяче стоят одинаково. Два филиала со своими номерами — 19 800 ₸ в месяц. Баланс пополняется через Kaspi или по счёту на ТОО/ИП, акт выполненных работ — по запросу. Подробности — на странице цен, подключение — после регистрации.

Частые вопросы

Можно ли отправлять пациенту результаты анализов в WhatsApp?

Мы не советуем: результаты — медицинские данные, а сообщение может прочитать посторонний. Безопаснее уведомить, что результаты готовы, и выдать их в регистратуре или личном кабинете. Как это соотносится с законом, уточните у юриста.

Регистратура и дальше будет переписываться с телефона?

Да. Номер работает как обычно на телефоне и в WhatsApp Web, автоматические сообщения видны в тех же чатах. Отдельного операторского окна у wapi.kz нет — администраторы отвечают там же, где и раньше.

Что если пациент ответит не цифрой, а текстом?

Обработчик распознаёт «1» и «2», а всё остальное пересылает администратору — в рабочий чат или CRM. В любом случае сообщение остаётся в WhatsApp, где его увидит регистратура.

Наша МИС не умеет отправлять запросы — что делать?

Выгружайте расписание на завтра в таблицу и отправляйте напоминания скриптом. Если у МИС есть API для чтения, задача по таймеру сама заберёт приёмы. Можно оставить заявку на интеграцию в кабинете.

Сколько пациентов можно напоминать с одного номера?

На базовом уровне — до 1 000 сообщений в сутки и до 150 первых сообщений новым людям, в первые две недели меньше. Остаток на сегодня виден в карточке номера и через GET /limits.

Подключите WhatsApp к своим системам

9 900 ₸ в месяц за номер, без платы за сообщения. Сервер в Казахстане, оплата Kaspi или счётом на ТОО/ИП. Подключение — около 5 минут.

Гайды по теме

Смотрите также