Como agendar mensagens de compromisso para clientes no WhatsApp sem esquecer
"Te chamo na terça" é a promessa que mais se perde em agência e em atendimento: ninguém anota, o dia passa e o lead esfria. Agendar a mensagem na hora em que o compromisso nasce resolve o esquecimento sem depender da memória de ninguém. A ZapZap tem agendamento dentro do chat e por API. Este guia mostra os dois caminhos, o que vale agendar e o cuidado para não transformar agendamento em disparo em massa. A ZapZap é uma API não oficial: o WhatsApp pode limitar números que enviam mensagens indesejadas.
Publicado em · 3 min de leitura
Agendar dentro do chat: o caminho do atendente
No painel da conversa há a ação Agendar. O atendente escolhe a data e a hora e escreve a mensagem (ou anexa a mídia), e ela fica numa lista de mensagens agendadas daquela conversa, que pode ser consultada, editada ou cancelada. Serve para o que nasce no meio da conversa: "retorno amanhã às 10h", "envio a proposta na sexta", "lembro você da consulta".
O ganho para a agência é de processo: o compromisso deixa de morar na memória de quem atendeu e passa a existir no sistema, visível para quem assumir a conversa depois.
Agendar por API: o caminho da automação
Para lembretes que saem de outro sistema (agenda, CRM, cobrança), o envio simples aceita o campo scheduled_for, um timestamp em milissegundos. O exemplo abaixo agenda uma mensagem para um número e devolve um folder_id, que serve para acompanhar a campanha. Atenção ao fuso: calcule o timestamp a partir da data local do cliente.
O campo numbers é uma lista (em texto JSON) e os atrasos delayMin e delayMax, em segundos, espaçam os envios. Mesmo para um único lembrete, mantenha esses campos, porque a mesma chamada atende listas maiores.
Schedule a message and check its status
# Schedule for 2026-11-12 10:00 (UTC-3): compute the timestamp in milliseconds
SCHEDULED_FOR=$(date -d "2026-11-12 10:00:00 -0300" +%s)000
curl -X POST "https://api.zapzapapi.com/api/v1/$ZAPZAP_INSTANCE/sender/simple" \
-H "Content-Type: application/json" \
-H "x-api-key: $ZAPZAP_API_KEY" \
-H "x-api-secret: $ZAPZAP_API_SECRET" \
-d "{\"numbers\":\"[\\\"5511999999999\\\"]\",\"type\":\"text\",\"text\":\"Oi! Lembrando do nosso retorno hoje as 10h.\",\"folder\":\"retornos\",\"delayMin\":5,\"delayMax\":12,\"scheduled_for\":$SCHEDULED_FOR}"
# Example answer: {"count":1,"folder_id":"r37d5cc380a7f31","status":"queued"}
# Later, list campaigns to see status and counters (log_total, log_delivered, log_read, log_failed)
curl "https://api.zapzapapi.com/api/v1/$ZAPZAP_INSTANCE/sender/listfolders" \
-H "x-api-key: $ZAPZAP_API_KEY" -H "x-api-secret: $ZAPZAP_API_SECRET"O que vale agendar
Vale agendar o que o contato já esperava: retorno combinado, lembrete de consulta ou de reunião, envio de proposta prometida, aviso de vencimento a quem é cliente, follow-up de um orçamento pedido. Em todos, existe uma conversa anterior e uma razão clara para a mensagem.
Não vale agendar um disparo para quem nunca falou com você. Agendamento não torna a mensagem esperada, só muda a hora em que ela sai. O uso aceitável da ZapZap exige consentimento de quem recebe: veja o uso aceitável e o guia de disparo em massa legal e LGPD.
Cuidados de ritmo e de horário
Agendar muita coisa para o mesmo minuto cria um pico que um atendente humano não faria. Espalhe os horários, mantenha atrasos entre mensagens e respeite o horário comercial do contato. Número novo ainda em aquecimento não deve receber agenda de envios a desconhecidos: veja aquecimento de chip.
Confirme o fuso de quem recebe. Lembrar a consulta às 10h do fuso errado vira uma mensagem inútil e um motivo a mais para silenciar o número.
Montando a rotina da agência
Uma rotina simples: o atendente agenda no chat todo compromisso combinado, o CRM agenda por API os lembretes de eventos conhecidos, e uma checagem semanal olha a lista de campanhas agendadas por cliente. Para o fluxo mais amplo de lembretes automáticos, veja agendar mensagens de WhatsApp automaticamente e a página de agências.
Resumo rápido
- Agende o compromisso quando ele nasce: dentro do chat (Agendar) ou por API.
- Por API, o envio simples aceita scheduled_for em milissegundos e devolve um folder_id para acompanhar.
- Agende o que o contato já esperava; agendamento não substitui consentimento.
- Espalhe horários, mantenha atrasos e confirme o fuso de quem recebe.
- A lista de mensagens agendadas por cliente deve entrar na revisão semanal.
Continue lendo
Perguntas frequentes
Dá para agendar mensagens dentro do chat?
Sim. Na conversa há a ação Agendar, com data e hora. As mensagens agendadas da conversa ficam numa lista, onde podem ser editadas ou canceladas.
Como agendar por API?
Use POST /{instanceId}/sender/simple com numbers, type, delayMin, delayMax e scheduled_for (timestamp em milissegundos). A resposta traz um folder_id, e GET /{instanceId}/sender/listfolders mostra o status e os contadores.
Posso agendar disparos para uma lista fria?
Não é recomendável e o uso aceitável exige consentimento. Agendar não torna a mensagem esperada.
Qual fuso a API usa?
O scheduled_for é um timestamp absoluto em milissegundos, então o fuso está na conta que você faz ao gerá-lo. Calcule a partir da data local do cliente.
O agendamento evita o bloqueio?
Não. Ele evita esquecimento. O risco do canal não oficial continua, e ritmo, consentimento e aquecimento é que o reduzem.
Pare de perder compromissos combinados
Crie a conta, conecte um número e agende a primeira mensagem no chat. R$15 por número ativo ao mês, sem cobrança por mensagem. Ao verificar o telefone, há crédito de boas-vindas, sujeito à campanha vigente.