WhatsApp API для клиник и медицинских центров
Обновлено
Клинике важно, чтобы пациент пришёл в своё время, а если не может — предупредил заранее и окно досталось другому. Обычно этим занимается регистратура: обзванивает пациентов накануне, до части не дозванивается, перезванивает. Напоминание в WhatsApp пациент прочитает, когда удобно, и подтвердит одной цифрой, а администратор займётся теми, кто попросил перенос или не ответил.
У медицины есть особенность, которой нет у салона или магазина: сведения о здоровье — деликатные данные. Поэтому здесь столько же внимания тому, что писать нельзя, сколько тому, что можно.
Сценарии
Подтверждение сразу после записи
Пациент записался на сайте, по телефону или у стойки — запись появилась в расписании. Сообщение: дата, время, адрес, что взять с собой (удостоверение, направление). Иногда пациент отвечает вопросом — «есть ли парковка?» — и его видит администратор.
Напоминание накануне
Вечером запускается задача: всем, у кого приём завтра, уходит напоминание с просьбой ответить «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 минут.