Confirmação de agendamento pela API de WhatsApp

Confirmar agendamento pelo WhatsApp é enviar um lembrete na véspera e outro horas antes, deixar o cliente responder se vem, cancela ou quer remarcar, e atualizar a agenda sozinho com essa resposta. O horário que seria falta volta a tempo de ser vendido de novo.

Por que o cliente falta, e o que o lembrete resolve

Falta em consulta, aula experimental, visita a imóvel ou serviço de estética raramente é má vontade. Na maioria dos casos a pessoa esqueceu, confundiu o dia ou teve um imprevisto e não achou fácil avisar. A ligação da recepção na véspera resolve parte disso, mas custa horas de trabalho e não alcança quem não atende número desconhecido.

Uma confirmação automática pela API de WhatsApp ataca as três causas: lembra no momento certo, repete a data e o local sem margem para confusão e torna cancelar tão fácil quanto tocar numa opção. O ganho não é só a pessoa que aparece. É também o horário devolvido a tempo de encaixar outro cliente.

A régua de lembretes

Uma sequência que funciona para a maioria dos serviços com hora marcada:

MomentoObjetivoConteúdo
Na marcaçãoRegistrar o compromissoData, hora, endereço e profissional
D-1, fim da manhãPedir confirmaçãoLista com confirmar, remarcar e cancelar
H-2Lembrar quem confirmouAviso curto, com link de localização se ajudar
D-1, fim da tardeResgatar quem não respondeuSegunda tentativa ou alerta para a recepção ligar

Envie o D-1 num horário comercial razoável e sempre no fuso do cliente, não do servidor. Para agendamentos de manhã cedo, o H-2 pode cair de madrugada: nesse caso, antecipe para a noite anterior ou pule.

Como montar o envio com lista de opções

O WhatsApp não tem botão de resposta rápida comum para esse tipo de envio. A lista interativa é o formato que funciona em qualquer aparelho e devolve ao sistema qual opção foi escolhida. O truque é colocar o identificador do agendamento dentro do rowId, assim a resposta já diz o que fazer e com qual registro:

curl -X POST https://api.d-api.cloud/api/v1/interactive/send/list \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "clinica-agenda",
    "to": "5511999999999",
    "title": "Consulta amanhã, 14h30",
    "description": "Olá, Ana. Sua consulta com a Dra. Paula é amanhã, às 14h30, na Rua das Flores, 120. Você confirma?",
    "buttonText": "Responder",
    "footerText": "Clínica Exemplo",
    "sections": [{
      "title": "Agendamento 7781",
      "rows": [
        { "rowId": "confirmar:7781", "title": "Confirmo presença" },
        { "rowId": "remarcar:7781", "title": "Quero remarcar" },
        { "rowId": "cancelar:7781", "title": "Preciso cancelar" }
      ]
    }]
  }'

Outros formatos interativos e suas limitações estão em botões e listas no WhatsApp.

Tratando a resposta pelo webhook

A resposta chega no seu servidor como evento messages.received. Quando o cliente usa a lista, o type vem como list_response, com a opção escolhida. Quando ele digita, vem como text. O processamento segue estes passos:

  1. Ignore eventos com fromMe verdadeiro e mensagens de grupo.
  2. Se for list_response, separe ação e identificador do rowId escolhido e confira se o agendamento pertence a quem respondeu.
  3. Se for texto, busque o último agendamento pendente daquele número e interprete respostas óbvias. Na dúvida, encaminhe para a recepção.
  4. Atualize a agenda: confirmar marca presença esperada, cancelar libera o horário na hora, remarcar abre o fluxo de reagendamento.
  5. Responda com uma mensagem curta confirmando o que foi feito. O cliente precisa saber que foi ouvido.
  6. Responda o webhook rápido, com status 2xx, e faça o trabalho pesado em fila.

O formato completo dos eventos e o comportamento de reenvio estão em webhook de WhatsApp.

Reagendamento sem ligação

Remarcar é onde a automação economiza mais tempo da recepção. Quando o cliente escolhe remarcar, envie uma nova lista com os próximos horários livres daquele profissional, cada linha com o horário no rowId. A seção aceita até 10 linhas, o que costuma bastar para os dois ou três dias seguintes.

  • Reserve o horário escolhido de forma provisória e confirme numa transação, para não vender duas vezes.
  • Se o horário foi ocupado entre o envio e a resposta, mande a lista atualizada em vez de um erro.
  • Se nenhum horário serve, ofereça falar com alguém. Não prenda o cliente num menu.

O que medir

  • Taxa de confirmação: quantos responderam confirmando sobre o total de lembretes D-1.
  • Taxa de cancelamento antecipado: horários devolvidos com tempo de reocupar.
  • Faltas sem aviso: comparar antes e depois da automação, por profissional e por dia da semana.
  • Respostas em texto livre que foram para a recepção: se crescerem, a mensagem está pouco clara.

Depois do atendimento, o mesmo número pode perguntar como foi a experiência, tema de pesquisa NPS pelo WhatsApp. Se você não programa e prefere montar essa régua em ferramenta visual, veja os fluxos de automação. O trial de 3 dias é suficiente para rodar a régua completa com uma agenda de teste.

Perguntas frequentes

Quando devo enviar o lembrete de agendamento?

O arranjo mais usado é um lembrete na véspera, pedindo confirmação, e outro de duas a três horas antes, só para quem confirmou. Serviços marcados com muita antecedência podem ganhar um terceiro aviso uma semana antes.

Botão ou lista para o cliente confirmar?

O WhatsApp não oferece botões de resposta rápida comuns para esse fim. A lista funciona no celular e no computador e devolve ao seu sistema exatamente qual opção foi escolhida, por isso é a escolha mais segura para confirmar, cancelar ou remarcar.

E se o cliente responder com texto em vez de usar a lista?

Acontece com frequência. Trate respostas simples como sim, confirmo, ok ou 1 como confirmação, e não como cancelamento. Qualquer coisa fora do previsto deve ir para uma pessoa da recepção, e não ser ignorada.

Lembrete por WhatsApp reduz mesmo as faltas?

Reduz principalmente as faltas por esquecimento, que são a maior parte. E quando o cliente cancela pela resposta, o horário volta para a agenda a tempo de ser ocupado, o que também conta como falta evitada.

Preciso de template para lembrete na API oficial?

Sim. Na API oficial o lembrete inicia a conversa, então precisa de template aprovado, normalmente na categoria utilidade. Na API não oficial o lembrete vai como mensagem comum ou lista, sem aprovação prévia.

Teste a API de WhatsApp da D-API

Trial de 3 dias com acesso completo. Sem cartão, sem fidelidade.