--- title: "Confirmação de agendamento por API de WhatsApp | D-API" description: "Confirmação de agendamento com API de WhatsApp: lembrete na véspera e horas antes, resposta para confirmar, cancelar ou remarcar, e menos faltas na agenda." url: https://d-api.cloud/api-whatsapp-confirmacao-de-agendamento --- Por caso de uso # 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 Time de engenharia D-APIAtualizado em 24 de set de 20265 min de leitura ## 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](https://d-api.cloud/) 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: | Momento | Objetivo | Conteúdo | | --- | --- | --- | | Na marcação | Registrar o compromisso | Data, hora, endereço e profissional | | D-1, fim da manhã | Pedir confirmação | Lista com confirmar, remarcar e cancelar | | H-2 | Lembrar quem confirmou | Aviso curto, com link de localização se ajudar | | D-1, fim da tarde | Resgatar quem não respondeu | Segunda 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](https://d-api.cloud/api-whatsapp-botoes-e-listas). ## 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](https://d-api.cloud/webhook-api-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](https://d-api.cloud/api-whatsapp-pesquisa-nps). Se você não programa e prefere montar essa régua em ferramenta visual, veja os [fluxos de automação](https://d-api.cloud/fluxos-de-automacao). 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-API3 dias grátis, sem cartão.[Começar trial grátis](https://app.d-api.cloud/register) ## Continue lendo - [Por caso de usoCobrança pelo WhatsApp](https://d-api.cloud/api-whatsapp-cobranca) - [Por caso de usoRastreio de pedidos](https://d-api.cloud/api-whatsapp-rastreio-de-pedidos) - [Por caso de usoPesquisa NPS pelo WhatsApp](https://d-api.cloud/api-whatsapp-pesquisa-nps) - [Por caso de usoNotificações transacionais](https://d-api.cloud/api-whatsapp-notificacoes-transacionais) ## Teste a API de WhatsApp da D-API Trial de 3 dias com acesso completo. Sem cartão, sem fidelidade. [Começar trial grátis](https://app.d-api.cloud/register)[Ver documentação](https://docs.d-api.cloud/)