API de WhatsApp para clínicas: confirmação de consulta sem secretária no celular

A dor que a clínica sente é a cadeira vazia

Para o dono da clínica, falta de paciente é o problema que aparece no caixa. O horário ficou reservado, o profissional ficou parado e ninguém avisou. Hoje a solução é a recepção passar a tarde ligando ou mandando mensagem manual para a agenda do dia seguinte, e isso só funciona enquanto a recepção tem tempo.

Um software de clínica que resolve isso de forma automática vende sozinho na demonstração. E quem já tem o recurso de lembrete por SMS ou e-mail sabe que pouca gente responde por esses canais: o paciente lê o WhatsApp, e é lá que ele diz "não vou conseguir ir".

A linha do tempo de uma consulta no WhatsApp

O ganho não vem de uma mensagem, e sim de uma sequência bem cronometrada. Um desenho que funciona para a maioria das especialidades:

1. No agendamento: mensagem curta com data, hora, profissional e endereço. Serve de comprovante e reduz ligação de "qual era o horário mesmo?".
2. Na véspera: pedido de confirmação com as opções confirmar, remarcar e cancelar. É o envio que mais importa, porque ainda dá tempo de preencher a vaga.
3. Sem resposta até o fim da tarde: a agenda marca o horário como "não confirmado" e a recepção liga só para esses, não para todos.
4. Duas horas antes: localização da clínica e orientação prática, como jejum ou documento a levar.
5. Depois do atendimento: instrução administrativa, como retorno agendado ou pesquisa de satisfação. Nada de diagnóstico.

Cada clínica configura horários e textos no seu software; a sequência em si é regra do produto. O mesmo padrão aplicado a outros tipos de agenda aparece em confirmação de agendamento.

Exemplo: o pedido de confirmação da véspera

O paciente responde melhor quando não precisa digitar. Uma mensagem de lista resolve isso, e o rowId de cada opção carrega o id da consulta, então a resposta volta já amarrada ao horário certo:

import { DApi } from 'd-api-sdk'

const dapi = new DApi({ apiKey: process.env.DAPI_API_KEY })

await dapi.interactive.sendList({
  sessionId: 'clinica-sorriso-unidade-centro',
  to: '5511999999999',
  title: 'Consulta amanhã, 14h30',
  description: 'Olá, Maria. Sua consulta com Dra. Paula está marcada para amanhã às 14h30. Pode confirmar?',
  buttonText: 'Responder',
  footerText: 'Clínica Sorriso',
  sections: [
    {
      title: 'Sua consulta',
      rows: [
        { rowId: 'consulta-88213:confirmar', title: 'Confirmar presença' },
        { rowId: 'consulta-88213:remarcar', title: 'Preciso remarcar' },
        { rowId: 'consulta-88213:cancelar', title: 'Cancelar consulta' },
      ],
    },
  ],
})

A escolha do paciente chega ao webhook do software como messages.received com type igual a list_response. O sistema atualiza a agenda e, no caso de remarcação, responde com os próximos horários livres. Outros formatos de interação estão em botões e listas.

Dado de saúde pede outro nível de cuidado

Pela LGPD, informação sobre saúde é dado pessoal sensível. O WhatsApp é um canal de conveniência, e o software precisa ser desenhado para expor o mínimo. Algumas regras práticas para levar ao seu time de produto (e validar com o jurídico ou o encarregado de dados das clínicas):

• Mensagem mínima: data, hora, profissional e endereço bastam. Evite nome de procedimento em especialidades que o paciente pode não querer expor, como psiquiatria ou saúde sexual.
• Resultado e laudo fora da conversa: avise que estão prontos e entregue por um portal autenticado.
• Consentimento registrado: guarde no prontuário administrativo quando e como o paciente aceitou receber mensagens, e permita desligar por paciente.
• Número certo: telefone de responsável para menor de idade, não do próprio paciente.
• Retenção no seu lado: o conteúdo das respostas que chega por webhook fica no seu banco. Aplique a mesma política de retenção e acesso do prontuário.

Não existe configuração de API que torne o envio "compatível com a LGPD" por si só. O que a infraestrutura oferece é isolamento: na D-API cada conexão roda em ambiente próprio, com credenciais e webhook separados, então os eventos de uma clínica não passam pela conexão de outra.

Como implementar no seu software de gestão clínica

1. Adicionar "Conectar WhatsApp" na configuração da unidade, criando a conexão por API.
2. Criar o campo de consentimento e o de telefone para contato no cadastro do paciente.
3. Montar o job da véspera, que envia as confirmações com um intervalo entre elas.
4. Tratar o list_response no webhook e atualizar o status da consulta.
5. Criar a visão "não confirmados" para a recepção agir só onde precisa.
6. Monitorar connection.status por clínica e alertar quando um número cair.

O último passo é o que mais gera suporte se ficar de fora: a clínica só percebe que o número desconectou quando os pacientes começam a faltar de novo. A API de WhatsApp da D-API tenta recuperar a conexão sozinha, mas o seu software precisa mostrar o problema quando ele exige ação da clínica.

Modelo comercial para software de clínica

Cada clínica é uma conexão, e a cobrança da D-API é por conexão, não por mensagem. Para quem cobra mensalidade por clínica, isso vira um custo fixo previsível por cliente, que fica menor conforme a base cresce. Os detalhes do modelo estão em API de WhatsApp para SaaS. Se alguma rede de clínicas exigir a API oficial, a mesma integração atende: veja API oficial. Os 14 dias grátis falando com o time comercial incluem acompanhamento da implementação.