Lembretes de agendamento para clínicas, salões e barbearias
Lembrete de consulta automático pelo WhatsApp: o seu sistema envia, o cliente responde para confirmar e a resposta chega por webhook para atualizar a agenda.
Atualizado em
Todo negócio que vive de horário marcado conhece o problema: o cliente esquece, não avisa, e a cadeira ou a sala fica vazia. Muitas clínicas, consultórios, salões e barbearias resolvem isso com alguém da recepção mandando mensagem um por um no fim da tarde, lendo as respostas no celular e riscando a agenda à mão.
Com a apiwpp, o sistema de agenda faz esse trabalho. Ele envia o lembrete pelo número de WhatsApp do negócio, o cliente responde como responderia a uma pessoa e a resposta chega ao seu servidor por webhook, pronta para confirmar ou liberar o horário. Serve tanto para quem tem o próprio sistema quanto para quem desenvolve um software de agendamento usado por vários negócios.
O fluxo: lembrete, resposta e agenda atualizada
O desenho mais comum usa dois avisos por horário marcado: um na véspera, em horário comercial, pedindo confirmação; outro no dia, algumas horas antes, só lembrando o horário e o endereço. Se o cliente já confirmou na véspera, muitos negócios nem enviam o segundo, e isso é uma boa escolha.
O caminho completo:
- O seu sistema decide a hora. Um job agendado procura os horários que precisam de lembrete e ainda não receberam.
- O lembrete entra na fila do número com
POST /connections/{id}/send, que responde202na hora comjobId,scheduledAteposition. - A fila envia no ritmo que protege o número, com o indicador "digitando…" antes do texto.
- O cliente responde, e a resposta chega ao seu webhook como
message.incoming. - O seu sistema atualiza a agenda: confirma, libera o horário ou avisa a recepção.
A API não tem um campo "enviar amanhã às 17h". Quem escolhe o momento é o seu sistema, que chama o envio quando o lembrete deve sair. A regra de negócio (quantas horas antes, pular quem já confirmou) fica no seu código, onde é fácil de mudar.
Um template e um clientRef por lembrete
Salve o texto uma vez como template, com variáveis, e envie com os dados de cada horário:
{
"to": "5511988887777",
"template": "lembrete_vespera",
"variables": { "nome": "Carla", "hora": "10h", "profissional": "Dr. Paulo" },
"clientRef": "agenda-8812-vespera"
}
O template lembrete_vespera pode ser algo como: "Olá, ! Lembrete do seu horário amanhã às com . Responda 1 para confirmar ou 2 para remarcar." Cada mensagem sai com o nome e o horário daquela pessoa, e não como um texto idêntico repetido dezenas de vezes. Veja templates de mensagem.
O clientRef é a sua chave de idempotência. Se o job rodar de novo ou a requisição esgotar o tempo, repetir o envio com o mesmo clientRef devolve o job original com "duplicate": true, em vez de mandar o lembrete em dobro. O mesmo valor volta nos eventos message.delivery e message.send_failed, então o seu sistema sabe a qual horário cada evento pertence.
A resposta do cliente atualiza a agenda
Quando o cliente responde, a apiwpp envia um POST ao webhook do projeto com o evento message.incoming. O texto vem em data.body e o remetente em data.phone (formato E.164) e em data.jid:
{
"type": "message.incoming",
"connectionId": "8b1d4e7f-2c3a-4f5b-9e6d-7a8b9c0d1e2f",
"tenantId": "3f6c2a8e-9d41-4b7a-8c15-2e7d9a0b4c61",
"externalId": "clinica-centro",
"timestamp": "2026-09-28T20:14:09.000Z",
"data": {
"from": "[email protected]",
"jid": "[email protected]",
"phone": "+5511988887777",
"body": "1",
"timestamp": 1790626449
}
}
A resposta não diz a qual horário se refere: procure o agendamento com lembrete enviado e ainda sem resposta para aquele remetente. Guarde o jid e o phone que vieram no message.delivery do lembrete, porque contas antigas sem o nono dígito respondem com um phone diferente do cadastro. E aceite variações: "1", "sim", "confirmo" e um 👍 querem dizer a mesma coisa. Reações chegam como message.reaction. O que o sistema não entender vai para a recepção, em vez de ser ignorado.
Verifique a assinatura HMAC de cada entrega e responda 2xx rápido. Como a entrega é pelo menos uma vez, faça a confirmação de forma idempotente: confirmar um horário já confirmado não faz nada. O guia está em webhooks do WhatsApp.
Botões, enquetes e o que funciona hoje
A primeira ideia de quase todo mundo é pôr botões de "Confirmar" e "Remarcar" no lembrete. Hoje a apiwpp não envia botões nem listas interativas, e as enquetes estão no roadmap do plano PRO, marcadas como "em breve" nos recursos. O que funciona hoje, em qualquer plano, é a resposta em texto ("Responda 1 para confirmar ou 2 para remarcar"), que o cliente entende sem instrução.
O plano PRO já acrescenta recursos úteis para agenda:
- Editar uma mensagem em até 15 minutos depois do envio, quando um lembrete saiu com o horário errado.
- Apagar para todos um lembrete enviado por engano.
- Marcar como lida a resposta do cliente, para ele ver que foi recebida.
Os valores de cada plano estão em preços.
Ritmo da fila e horário comercial
A fila existe para proteger o número. Os limites padrão por número são 3 mensagens por minuto, 60 por hora e 200 por dia, com intervalo aleatório de 3 a 8 segundos e pelo menos 30 segundos entre duas mensagens para o mesmo destinatário. Por isso o lembrete não sai no mesmo segundo da chamada.
Na prática: se a agenda de amanhã tem 90 horários e o job dispara todos às 17h, a fila espalha os envios por cerca de uma hora e meia. Para uma barbearia com 20 horários, a diferença é de minutos; para uma clínica grande, vale começar mais cedo. Com dois lembretes por horário, o limite diário cobre por volta de 100 atendimentos; acima disso, divida entre números diferentes (por unidade ou por profissional), cada um com a própria fila.
A fila não sabe qual é o seu horário comercial. Confira o scheduledAt da resposta e, se o horário previsto ficou tarde demais, cancele com DELETE /connections/{id}/queue/{jobId} enquanto o envio não saiu. Nos primeiros 14 dias depois do pareamento, o número passa por um aquecimento com limites menores; comece com uma parte da agenda. Veja a fila anti-bloqueio.
O passo a passo com o código do job e do webhook está no post lembretes de agendamento pelo WhatsApp. Se você desenvolve um sistema de agenda para vários negócios, veja também WhatsApp para SaaS e CRMs.
Perguntas frequentes
Posso agendar um lembrete para sair num horário específico?
A API coloca a mensagem na fila na hora em que você chama. Quem escolhe o momento é o seu sistema, com um job que chama o envio quando o lembrete deve sair. A resposta traz o scheduledAt, o horário previsto pela fila, para você conferir se ainda está dentro do horário comercial.
Dá para confirmar o horário com botões ou enquete?
Hoje não. A apiwpp não envia botões nem listas, e as enquetes estão marcadas como "em breve" no plano PRO. A confirmação por resposta em texto, como "1" ou "sim", funciona em qualquer plano e chega ao seu sistema pelo evento message.incoming.
Como a resposta do cliente chega ao meu sistema?
Cada mensagem recebida vira um evento message.incoming no webhook do projeto, assinado com HMAC-SHA256, com o texto e o telefone do remetente. O seu sistema procura o agendamento pendente daquele telefone e atualiza a agenda.
Quantos lembretes um número consegue enviar por dia?
Os limites padrão são 60 mensagens por hora e 200 por dia por número, menores nos primeiros 14 dias do aquecimento. Para agendas maiores, use mais de um número, cada um com a própria fila.
Outros casos de uso
Todos: Casos de uso →Coloque o WhatsApp dentro do seu produto: cada cliente pareia o próprio número pela sua tela, as conversas chegam por webhook com o id do cliente e você paga por número conectado.
Mande pelo WhatsApp os avisos que o seu sistema já gera para quem é cliente (conta, serviço, pedido, alerta), com templates, envios sem duplicidade e a confirmação de entrega e leitura no seu webhook.
Cada mensagem que chega no número da empresa vira um evento no seu sistema: abra o ticket, distribua para a equipe e responda pela API, com texto, mídia, reações e o indicador de digitando.