Atualizado em 25/10/2026
Com a API oficial do WhatsApp, a clínica envia automaticamente um lembrete de consulta com botões “Confirmar” e “Remarcar”, recebe a resposta no sistema e atualiza a agenda sem ninguém da recepção digitar nada. O lembrete usa um template de utilidade aprovado pela Meta, e a resposta do paciente abre uma janela de 24 horas para conversar livremente. Como dado de saúde é dado sensível pela LGPD, o template deve trazer o mínimo: nome, data, horário e local.
Este guia mostra o fluxo de lembrete e confirmação, como montar o template, como tratar a resposta no webhook e os cuidados com dados de pacientes.
Por que a API e não o celular da recepção
Muitas clínicas confirmam consultas com um celular na recepção, uma pessoa e uma lista impressa. Funciona até a agenda crescer. Com a API oficial, o envio sai do sistema de agenda, a resposta volta para o sistema e a recepção cuida só das exceções.
| Tarefa | Celular da recepção | API oficial do WhatsApp |
|---|---|---|
| Enviar lembretes | Manual, um a um | Automático, a partir da agenda |
| Registrar confirmação | Alguém anota | Webhook atualiza o status da consulta |
| Vários atendentes | Um aparelho, uma pessoa | Vários atendentes no mesmo número |
| Histórico | No aparelho | No seu sistema |
| Risco de bloqueio por automação | Alto, se usar ferramenta não oficial | Sem esse risco; depende de qualidade e política |
Se a clínica quer manter o app WhatsApp Business no celular da recepção, a coexistência permite usar o mesmo número no app e na API. Veja coexistência na API do WhatsApp.
O fluxo de lembrete e confirmação
Um fluxo enxuto, que cobre a maior parte das clínicas:
- Agendamento. O paciente marca a consulta (por telefone, site ou WhatsApp) e informa que aceita receber avisos da clínica por WhatsApp. Registre esse aceite.
- Lembrete (ex.: 48 horas antes). O sistema envia o template de utilidade com data, horário, unidade e dois botões: “Confirmar” e “Preciso remarcar”.
- Paciente confirma. O webhook recebe o toque no botão, o sistema marca a consulta como confirmada e responde com uma mensagem curta, já dentro da janela de 24 horas.
- Paciente pede para remarcar. O sistema oferece horários livres (texto ou lista interativa) ou passa a conversa para a recepção. O horário antigo volta para a agenda.
- Sem resposta. A recepção recebe a lista de consultas não confirmadas para ligar ou decidir o que fazer, conforme a regra da clínica.
O ganho prático está nos passos 4 e 5: o horário de quem não vai comparecer volta para a agenda a tempo de ser ocupado, e a recepção liga só para quem não respondeu. O número exato de faltas evitadas depende de cada clínica, então meça antes e depois.
O template de lembrete
Fora da janela de 24 horas aberta pelo paciente, só é possível enviar templates aprovados. A Meta define templates de utilidade como mensagens disparadas por uma ação ou pedido do usuário, sem conteúdo promocional. Um lembrete da consulta que o paciente marcou se encaixa nessa descrição. Se o texto incluir oferta, desconto ou convite para outro procedimento, a Meta recategoriza o template como marketing. Veja como a Meta classifica templates.
Exemplo de criação do template (formato da Meta):
{
"name": "lembrete_consulta",
"language": "pt_BR",
"category": "UTILITY",
"components": [
{
"type": "BODY",
"text": "Olá, {{1}}. Lembramos que você tem um horário marcado na {{2}} em {{3}}, às {{4}}. Endereço: {{5}}. Você confirma?",
"example": {
"body_text": [["Ana", "Clínica Exemplo", "28/10", "14h30", "Rua das Flores, 100"]]
}
},
{
"type": "BUTTONS",
"buttons": [
{ "type": "QUICK_REPLY", "text": "Confirmar" },
{ "type": "QUICK_REPLY", "text": "Preciso remarcar" }
]
}
]
}Repare no que não está no texto: especialidade, nome do exame, procedimento, diagnóstico, nome do médico quando ele indica a especialidade. Isso protege o paciente se outra pessoa vir a notificação no celular dele e também reduz o volume de dado sensível que circula. Detalhes clínicos ficam para o atendimento ou para um canal autenticado da clínica.
Outras regras que evitam reprovação: não deixar variável no começo ou no fim do texto, dar exemplos realistas e não usar o template para “e aproveite nosso pacote de…”. Se o template for reprovado, veja motivos comuns de reprovação e o guia de templates da API do WhatsApp.
Enviando o lembrete com um identificador da consulta
Na hora do envio, você pode colocar no botão de resposta rápida um payload próprio, como o ID da consulta. Ele volta no webhook quando o paciente toca no botão:
{
"messaging_product": "whatsapp",
"to": "5511988887777",
"type": "template",
"template": {
"name": "lembrete_consulta",
"language": { "code": "pt_BR" },
"components": [
{
"type": "body",
"parameters": [
{ "type": "text", "text": "Ana" },
{ "type": "text", "text": "Clínica Exemplo" },
{ "type": "text", "text": "28/10" },
{ "type": "text", "text": "14h30" },
{ "type": "text", "text": "Rua das Flores, 100" }
]
},
{
"type": "button", "sub_type": "quick_reply", "index": "0",
"parameters": [{ "type": "payload", "payload": "CONFIRMAR:CONS-8812" }]
},
{
"type": "button", "sub_type": "quick_reply", "index": "1",
"parameters": [{ "type": "payload", "payload": "REMARCAR:CONS-8812" }]
}
]
}
}Guarde o wamid devolvido na resposta junto da consulta. Ele serve para cruzar os status de entrega e leitura que chegam depois. Veja status de mensagem via webhook.
Tratando a resposta no webhook
Quando o paciente toca em um botão de resposta rápida de um template, a Meta envia um webhook com type: "button", os campos button.payload e button.text e o context.id com o ID da mensagem original. Um handler em Node.js:
export async function tratarMensagem(msg, db, whatsapp) {
if (msg.type !== 'button') return;
const [acao, consultaId] = (msg.button.payload || '').split(':');
const consulta = await db.consultas.buscar(consultaId);
if (!consulta || consulta.telefone !== msg.from) return;
if (acao === 'CONFIRMAR') {
await db.consultas.atualizar(consultaId, { status: 'confirmada' });
await whatsapp.texto(msg.from, 'Presença confirmada. Até lá!');
}
if (acao === 'REMARCAR') {
await db.consultas.atualizar(consultaId, { status: 'remarcar' });
await db.agenda.liberarHorario(consulta.horarioId);
await whatsapp.texto(msg.from, 'Sem problema. Já liberamos o horário e a recepção vai te mandar novas opções por aqui.');
await db.filaRecepcao.adicionar(consultaId);
}
}Como o toque no botão é uma mensagem do paciente, ele abre a janela de atendimento de 24 horas. Dentro dela, a clínica pode responder com texto livre, lista de horários ou botões, sem novo template. Veja janela de 24 horas do WhatsApp. Se quiser que a remarcação seja feita por um assistente automático, veja agendamento automático com IA no WhatsApp.
Dados de saúde, LGPD e política do WhatsApp
Três regras se somam aqui. Este trecho explica o que elas dizem, mas não substitui a orientação de um advogado ou do encarregado de dados (DPO) da clínica.
- LGPD (Lei 13.709/2018). O art. 5º, II, inclui o “dado referente à saúde” entre os dados pessoais sensíveis. O art. 11 lista as hipóteses em que eles podem ser tratados, entre elas o consentimento específico e destacado e a “tutela da saúde, exclusivamente, em procedimento realizado por profissionais de saúde, serviços de saúde ou autoridade sanitária”. O art. 46 exige medidas de segurança técnicas e administrativas para proteger os dados.
- Política de Mensagens do WhatsApp Business. A política diz para não usar o WhatsApp para telemedicina nem para enviar ou pedir informações de saúde se as leis aplicáveis proibirem a distribuição dessas informações a sistemas que não cumprem os requisitos para processá-las. Também proíbe pedir números completos de cartão, de conta financeira ou de documento de identidade.
- Consentimento para mensagens. A política exige que a pessoa tenha dado o número e a permissão para receber mensagens da empresa, e que pedidos para parar sejam respeitados.
Na prática, para lembretes:
- Use o mínimo de dados no template (nome, data, horário, local).
- Registre quando e como o paciente aceitou receber avisos por WhatsApp.
- Limite quem acessa as conversas no sistema e mantenha registro de acesso.
- Não peça foto de exame, carteirinha ou documento pelo WhatsApp sem avaliar com o jurídico se isso é adequado no seu caso.
- Ofereça um jeito simples de parar os lembretes e respeite o pedido.
Mais detalhes em LGPD e WhatsApp.
Volume e custo
Lembretes saem fora da janela de atendimento, então contam no limite de mensagens do portfólio. Um portfólio novo começa com 250 destinatários únicos em 24 horas fora da janela, e a verificação da empresa é um dos caminhos para chegar a 2.000. Se a clínica tem mais de 250 consultas por dia, faça a verificação da empresa antes de ligar a automação.
Cada template de utilidade entregue é cobrado pela Meta conforme a tabela do país do destinatário. Desde 1º de outubro de 2026, a Meta passou a cobrar também os templates de utilidade enviados dentro da janela de atendimento, que antes eram gratuitos. Para estimar o custo mensal, multiplique o número de lembretes pelo preço vigente. Veja preço da API do WhatsApp no Brasil e como simular o custo de uma campanha.
Como fazer com a Vectalk
Com a Vectalk, o sistema de agenda da clínica cria o template por POST /templates, envia o lembrete por POST /messages com type: "template" e recebe as respostas no webhook registrado em POST /webhooks, com o mesmo payload que a Meta envia. A Vectalk usa a Cloud API oficial e paga a Meta por você, e oferece coexistência para quem quer manter o app na recepção. Veja a documentação e crie sua conta. Para o panorama completo, leia o guia da API oficial do WhatsApp.
Perguntas frequentes
Lembrete de consulta é template de utilidade ou de marketing?
Um lembrete sobre a consulta que o paciente marcou, sem oferta nem promoção, se encaixa na definição de utilidade da Meta. A decisão final é da Meta, que pode recategorizar o template se encontrar conteúdo promocional.
Posso colocar o nome do exame no lembrete?
É melhor não. O nome do exame ou da especialidade pode revelar informação de saúde para quem vir a notificação. Deixe só data, horário e local, e passe detalhes no atendimento.
Quantas horas antes devo enviar o lembrete?
A Meta não define. Um intervalo de 24 a 48 horas costuma dar tempo para o paciente remarcar e para a clínica ocupar o horário. Teste e meça a taxa de confirmação.
O paciente respondeu “ok” em texto em vez de tocar no botão. E agora?
Trate também mensagens de texto (type: "text") de quem tem consulta pendente. Uma regra simples por palavra-chave resolve a maior parte; o resto vai para a recepção.
A recepção pode continuar usando o celular?
Pode, com coexistência: o número fica no app WhatsApp Business e na API ao mesmo tempo, e as mensagens sincronizam.
Fontes oficiais consultadas em 25/10/2026: Diretrizes de categorias de template, Templates de utilidade, Webhook de botão (messages/button), Limites de mensagens, Preços, Política de Mensagens do WhatsApp Business, Lei 13.709/2018 (LGPD), Documentação da API da Vectalk.