saas de saúde
WhatsApp para software de clínicas, com o número de cada clínica dentro da agenda
Coloque WhatsApp no seu software de clínicas: cada clínica conecta o próprio número, a agenda confirma consultas com um toque do paciente e a recepção liga pelo WhatsApp sem sair do sistema.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Confirmação que volta para a agenda
O paciente escolhe confirmar, remarcar ou cancelar numa lista. A opção chega no webhook com o identificador que você definiu.
Uma conexão por unidade
Rede com três endereços, três números. Cada unidade fala com os próprios pacientes, e o seu banco mantém tudo ligado à mesma clínica.
Ligação pelo WhatsApp da clínica
Na API não-oficial, a recepção liga e atende chamadas de WhatsApp pelo seu sistema, sem custo extra por ligação.
Menos conteúdo sensível guardado
Por conexão, dá para desligar o armazenamento do conteúdo das mensagens na D-API sem perder os webhooks.
Quem desenvolve software de gestão para clínicas médicas, odontológicas ou de terapia conhece a cena: a secretária passa a tarde no celular confirmando consulta por consulta, copiando horários da agenda para o WhatsApp e voltando com as respostas. Levar o WhatsApp para dentro do software de clínicas tira esse trabalho da mão dela e coloca na agenda. Cada clínica conecta o próprio número ao seu sistema, as mensagens saem a partir dos eventos da agenda e a resposta do paciente atualiza o horário sozinha.
Esta página mostra os fluxos que um SaaS de saúde consegue entregar com a D-API e os cuidados específicos de um segmento que lida com dado de paciente.
O número da clínica dentro do seu sistema
O paciente reconhece o número da clínica, e é desse número que a mensagem precisa sair. Na D-API, cada clínica ganha uma conexão própria, criada pelo seu backend com um sessionId que você controla, e o QR code aparece numa tela de configuração do seu produto. A recepção escaneia uma vez e a agenda passa a falar pelo WhatsApp da clínica.
Para redes com várias unidades, o desenho natural é uma conexão por unidade. A unidade do centro confirma as consultas dela, a do bairro confirma as suas, e o seu banco liga as duas à mesma conta de cliente. Como cada conexão é isolada, com IP dedicado, uma unidade que desconecta o aparelho não afeta as outras, e o evento connection.status avisa o seu sistema para pedir a reconexão.
Confirmação de consulta que atualiza a agenda
O fluxo que mais economiza tempo da recepção é a confirmação. Na véspera, o seu sistema envia uma mensagem interativa de lista com as opções, usando o identificador da consulta no rowId:
POST /api/v1/interactive/send/list
{
"sessionId": "clinica-77-centro",
"to": "5511999999999",
"title": "Consulta amanhã, 14h30",
"description": "Dra. Paula, Clínica Centro. Você confirma a sua presença?",
"buttonText": "Responder",
"sections": [{
"title": "Sua consulta",
"rows": [
{ "rowId": "cons-88213:confirmar", "title": "Confirmar presença" },
{ "rowId": "cons-88213:remarcar", "title": "Preciso remarcar" },
{ "rowId": "cons-88213:cancelar", "title": "Cancelar consulta" }
]
}]
}
Quando o paciente toca numa opção, o webhook messages.received chega com type: "list_response" e o selected_row_id que você mandou. O seu handler separa o identificador da consulta da ação e atualiza o status na agenda. “Confirmar” marca o horário como confirmado, “remarcar” abre um fluxo de novos horários e “cancelar” libera a vaga para a lista de espera. A recepção só olha as exceções.
Orientações, endereço e documentos no momento certo
Boa parte das faltas e atrasos vem de informação que não chegou. O seu software já sabe que tipo de consulta ou exame está marcado, então pode mandar o conteúdo certo para cada caso:
- Preparo de exame em PDF.
POST /api/v1/messages/send/documentenvia o arquivo por URL ou base64, comfileNameecaption. Jejum, suspensão de medicação e o que levar no dia saem junto do lembrete. - Endereço da unidade.
POST /api/v1/messages/send/locationmanda latitude, longitude, nome e endereço, e o paciente abre o mapa direto da conversa. - Vídeo de orientação. Para pós-procedimento ou fisioterapia,
send/videoentrega o vídeo gravado pela própria clínica.
Fora do horário de atendimento, a mensagem que o paciente manda também tem destino. O seu sistema recebe pelo mesmo webhook e decide se responde com uma orientação automática ou se guarda para a recepção no dia seguinte.
Quando a mensagem não basta, a clínica liga
Tem paciente que não responde mensagem, mas atende ligação. Na API não-oficial, o seu software faz a chamada de WhatsApp pelo número da própria clínica, sem custo extra por ligação. O botão “ligar” fica na tela da agenda, ao lado do horário não confirmado. POST /api/v1/calls/place inicia a chamada, e os eventos call.ringing, call.connected, call.ended ou call.not_answered registram o resultado no histórico do paciente.
O caminho inverso também funciona. Com o recebimento de chamadas ligado na conexão, a ligação que o paciente faz para o WhatsApp da clínica aparece no seu sistema, e a recepcionista atende no navegador. O guia de receber ligações pela API mostra o fluxo de oferta, atendimento e áudio. Clínicas que preferem só mensagem podem recusar automaticamente com um texto como “Atendemos por aqui, pode escrever”.
Para o paciente que não está no WhatsApp ou não atendeu, a mesma conta oferece ligação telefônica com URA: a ligação toca um áudio gravado pela clínica e captura a tecla, e “pressione 1 para confirmar” volta como evento call.dtmf para o seu backend.
Consulta por vídeo com convite agendado
Clínicas que atendem a distância precisam mandar o link no horário certo. POST /api/v1/calls/send-event envia ao paciente um convite de chamada agendada, com title e scheduledTime. O convite pode criar um link de chamada do WhatsApp de áudio ou vídeo, com createCallLink, ou apontar para a URL de outra ferramenta de vídeo em customCallLinkUrl. O paciente abre o convite na conversa que já tem com a clínica.
Dado de paciente pede cuidado extra
Dado de saúde é dado pessoal sensível na LGPD, e isso deve orientar o que o seu software escreve no WhatsApp. Algumas práticas valem para qualquer clínica:
- Mensagem mínima. Lembrete com data, horário, profissional e endereço resolve. Resultado de exame, diagnóstico e detalhe clínico ficam no portal ou no atendimento.
- Conteúdo fora do armazenamento.
POST /api/v1/sessions/{sessionId}/disable-message-storage-settingsdesliga, por conexão, a persistência do conteúdo das mensagens no banco da D-API. Os contatos continuam armazenados e os webhooks seguem funcionando, então o seu sistema recebe tudo e decide o que guarda. - Autorização no seu backend. A API key da sua conta enxerga todas as conexões. O seu código confere se a sessão pertence à clínica do usuário logado antes de cada envio ou consulta.
A lista de campos de cada evento recebido, incluindo respostas de lista e de botão, está na documentação da D-API.
API Oficial para a clínica que pedir
Algumas redes têm política de usar apenas a API Oficial da Meta. Para elas, a conexão nasce pelo Embedded Signup num popup hospedado pela D-API, e o seu código de envio continua o mesmo. A diferença é a regra da Meta: fora da janela de 24 horas desde a última mensagem do paciente, o lembrete precisa sair como template aprovado. Na prática, o lembrete de véspera vira um template de utilidade, e as tarifas da Meta são cobradas na conta Meta da própria clínica. A D-API cobra do seu SaaS o mesmo preço por conexão nas duas modalidades.
Por onde começar
Comece pelo fluxo de confirmação, porque é o que a clínica sente no primeiro dia. Crie uma conexão de teste, envie a lista para o seu próprio número e trate o list_response no webhook. Depois acrescente o PDF de preparo, o botão de ligação na agenda e, para quem não respondeu, a URA. A visão geral de como o WhatsApp entra em qualquer produto está na página de API de WhatsApp para SaaS.
Time D-API. Atualizado em .
Perguntas frequentes
Cada clínica precisa ter uma conta na D-API?
Não. O seu software tem uma conta e cria uma conexão por número de clínica ou de unidade. A clínica só escaneia o QR code dentro do seu sistema.
Posso usar o mesmo número que a recepção já usa no celular?
Na API não-oficial, sim: o número é conectado como um aparelho, e as mensagens enviadas pelo celular também chegam ao seu sistema no webhook messages.received, com fromMe: true. Na API Oficial, o modo de coexistência permite manter o app WhatsApp Business no mesmo número.
A D-API tem integração pronta com algum software de clínica?
Não. A D-API é a infraestrutura de WhatsApp, voz e SMS. A integração com a agenda é feita pelo seu software, chamando a API REST e tratando os webhooks.
Dá para fazer teleconsulta pela API?
A API envia um convite de chamada agendada com título e horário, criando um link de chamada do WhatsApp de áudio ou vídeo, ou usando a URL de outra ferramenta de vídeo que a clínica já usa.
E se o paciente não tiver WhatsApp naquele número?
Antes de enviar, você pode verificar o número com POST /api/v1/contacts/check. Para quem não está no WhatsApp, a mesma conta envia SMS ou faz uma ligação de URA.