Transforme rotinas em mensagens automáticas: lembretes, confirmações e alertas saem sozinhos, disparados por um evento do seu sistema ou por agenda. O cliente recebe na hora certa, sem ninguém precisar lembrar de avisar.
Automação é fazer o sistema agir sem ninguém apertar botão. Com a API do zapon, qualquer gatilho — um horário, um evento, uma condição que mudou no banco de dados — pode virar uma mensagem no WhatsApp, e qualquer resposta do cliente pode realimentar o seu fluxo. Não há atendente digitando, não há planilha de controle manual, não há aquele "esqueci de avisar": a rotina vira código, e o código fala pelo WhatsApp.
Ao longo deste guia os termos automação WhatsApp, disparo automático WhatsApp e API WhatsApp automação aparecem com frequência, porque são as três engrenagens de qualquer fluxo automatizado: um gatilho que dispara, uma chamada de API que envia e, quando faz sentido, um webhook que ouve a resposta. A boa notícia é que tudo isso roda sobre um número de WhatsApp comum, sem a API oficial da Meta, sem fila de aprovação e sem custo por mensagem.
Você transforma rotinas em mensagens que saem sozinhas: lembretes de agendamento, confirmações de pedido, alertas operacionais para a equipe e réguas de reengajamento. O gatilho parte de uma agenda (cron) ou de um evento do seu sistema, a API do zapon envia o texto e, opcionalmente, um webhook captura a resposta do cliente para acionar o próximo passo.
Ao final deste material você terá em mente — e em código — três blocos que, combinados, cobrem quase toda automação de WhatsApp:
Nenhum desses blocos exige infraestrutura pesada. Você pode partir de um cron job num servidor, de uma trigger de banco de dados, ou de uma plataforma no-code como n8n ou Make. O zapon é sempre o passo final: a chamada REST que entrega a mensagem ao WhatsApp do destinatário.
Os quatro mais usados são: lembretes (agendamento, consulta, vencimento), confirmações (pedido, reserva, inscrição), alertas operacionais para a equipe e réguas de reengajamento de clientes inativos. Todos seguem o mesmo padrão: um gatilho dispara, a API do zapon envia o texto e o resultado fica registrado.
Antes de escrever a primeira linha de código, vale mapear que tipo de mensagem automática você quer. Cada categoria tem um gatilho típico e um ritmo diferente:
São mensagens que antecipam um compromisso para reduzir falta e atraso. Um lembrete de agendamento sai na véspera ou algumas horas antes; um de consulta chega no dia, com horário e endereço; um de vencimento avisa o cliente antes da fatura fechar. O gatilho costuma ser uma agenda: todo dia, em um horário fixo, o sistema busca os compromissos próximos e dispara um lembrete para cada um. É a automação que mais devolve dinheiro, porque cada cliente que não falta é uma cadeira que não ficou vazia.
São respostas automáticas a uma ação que o cliente acabou de tomar. Uma confirmação de pedido sai assim que o pagamento é aprovado; uma de reserva chega logo após o cliente marcar a mesa ou o quarto; uma de inscrição dispara quando ele preenche o formulário do evento. Aqui o gatilho é um evento — não um horário —, então a mensagem precisa sair em segundos, dando ao cliente a sensação de que o sistema é vivo e responde na hora.
São avisos internos, voltados para a sua equipe e não para o cliente. Um estoque que cruzou o mínimo, um servidor que caiu, um pagamento que falhou, um SLA prestes a estourar: o sistema detecta a condição e manda a mensagem para o grupo ou para o responsável. O WhatsApp aqui vira um canal de notificação operacional, mais rápido de ler do que e-mail e mais barato do que SMS.
É uma sequência planejada de mensagens espaçadas no tempo, pensada para trazer de volta quem ficou inativo. A "régua" define os intervalos — por exemplo, 7, 15 e 30 dias após a última compra — e o conteúdo de cada toque. A automação roda por agenda, verifica quem entrou em cada faixa e dispara a mensagem correspondente, parando assim que o cliente reage. É o tipo que mais se beneficia do laço de resposta: quem responde sai da régua automaticamente.
No painel do zapon, crie uma conexão e leia o QR Code com o WhatsApp do número (ou use o código de pareamento). Assim que a conexão ficar online, copie o token dela — é esse token que autentica todas as chamadas de API que as suas automações farão.
Antes de qualquer disparo, o número precisa estar conectado e a conexão precisa ter um token. Esse token é a chave que o seu código — ou a sua plataforma no-code — vai usar para falar com a API do zapon.
Crie a sua conta em zapon.dev — são 14 dias grátis, sem cartão de crédito. Dentro do painel, crie uma nova conexão. Cada conexão representa um número de WhatsApp e tem o seu próprio token: uma string única que autentica as requisições daquele número. Copie esse token e guarde-o como uma senha, porque quem o tem consegue enviar mensagens em nome do seu número. Nas chamadas de API ele entra como um header chamado token — não é Authorization, não é Bearer.
Dica: se você vai automatizar com mais de um número (um para lembretes, outro para alertas internos, por exemplo), crie uma conexão para cada um. Como cada token corresponde a um número específico, a sua automação escolhe de qual número a mensagem sai simplesmente trocando o header.
Com a conexão criada, falta colocá-la online. Há dois caminhos:
Assim que o WhatsApp confirma, a conexão muda para o status online no painel. A partir daí o número está pronto para enviar e receber pela API — e as suas automações podem entrar em cena.
Faça uma requisição POST para https://api.zapon.dev/chat/send/text com o header token da sua conexão e um body JSON contendo Phone (o número de destino) e Body (o texto). O disparo pode partir de um cron (agenda), de uma trigger do banco (evento) ou de um nó de uma plataforma no-code — o endpoint é sempre o mesmo.
Este é o coração de toda automação de saída. Tanto faz se a mensagem nasce de um cron job, de um evento do seu banco de dados ou de uma plataforma como n8n ou Make: o passo final é sempre a mesma chamada REST simples. Veja o envio básico de um lembrete:
POST https://api.zapon.dev/chat/send/text token: SEU_TOKEN Content-Type: application/json { "Phone": "5511955554444", "Body": "Lembrete: sua consulta é amanhã às 14h." }
O campo Phone é o número de destino no formato internacional, só dígitos (DDI + DDD + número, ex.: 5511955554444); o Body é o texto. Ao executar, a API entrega a mensagem e devolve um JSON confirmando o envio:
{
"success": true,
"data": {
"id": "3EB0…"
}
}Esse id é o identificador da mensagem. Salve-o num passo seguinte da automação (numa coluna do banco, num log) para rastrear cada disparo e evitar reenvios. Agora, sobre o que aciona esse POST:
No modelo de agenda, um cron roda em horários fixos, busca quem deve receber e dispara um POST por destinatário. É o padrão para lembretes e réguas. Em um servidor, isso pode ser tão simples quanto um script chamado por uma linha no crontab:
// roda todo dia às 9h via crontab: 0 9 * * * const consultas = await db.consultasDeAmanha(); for (const c of consultas) { await fetch("https://api.zapon.dev/chat/send/text", { method: "POST", headers: { "token": process.env.ZAPON_TOKEN, "Content-Type": "application/json" }, body: JSON.stringify({ Phone: c.telefone, Body: `Lembrete: sua consulta é amanhã às ${c.hora}.` }) }); }
No modelo de evento, a mensagem nasce no instante em que algo muda. Pode ser um webhook do seu sistema (a loja avisa que o pedido foi pago), uma trigger de banco de dados (uma linha mudou de status) ou um handler na sua aplicação (o usuário concluiu a inscrição). O código é o mesmo POST de antes, só que chamado dentro do tratador do evento:
// chamado quando o pagamento é aprovado async function aoPagarPedido(pedido) { await fetch("https://api.zapon.dev/chat/send/text", { method: "POST", headers: { "token": process.env.ZAPON_TOKEN, "Content-Type": "application/json" }, body: JSON.stringify({ Phone: pedido.cliente.telefone, Body: `Pedido #${pedido.id} confirmado! Obrigado pela compra.` }) }); }
Se você prefere não escrever código, plataformas como n8n e Make cobrem os dois modelos. No n8n, um nó Schedule faz o papel do cron e um nó HTTP Request faz o POST; um nó Webhook recebe os eventos de outros sistemas. No Make, o equivalente é um módulo de agendamento e um módulo HTTP. Em ambos, você só aponta para https://api.zapon.dev/chat/send/text, adiciona o header token e mapeia Phone e Body a partir dos dados do fluxo.
Cadastre uma URL de webhook no painel do zapon, na sua conexão, marcando os eventos desejados. A partir daí, cada mensagem que o número receber chega como um POST nessa URL, com remetente e texto. O seu sistema lê o evento e dispara a próxima ação — confirmar, reagendar ou escalar para um humano.
Muitas automações são só de mão única: enviam e pronto. Mas as melhores fecham o laço — reagem à resposta. Para isso o zapon entrega cada evento (mensagem recebida, status de entrega) via POST na URL que você indicar. Essa URL é um endpoint do seu sistema ou um nó Webhook de uma plataforma no-code.
No painel do zapon, abra a sua conexão e localize a seção Webhook. Lá você:
A URL precisa ser acessível pela internet para o zapon conseguir entregar. Em produção, isso é o normal; em ambiente local de desenvolvimento, use um túnel para expor a porta.
Recebido o evento, o seu código decide o que fazer. Um caso clássico é o lembrete que pede confirmação: você manda "Confirma sua consulta de amanhã? Responda SIM ou NÃO" e, quando a resposta chega no webhook, atualiza a agenda conforme o texto. Esse laço — enviar, ouvir, reagir — é o que separa um disparo cego de uma automação que conversa de verdade.
// endpoint que recebe os eventos do zapon app.post("/webhook/zapon", async (req, res) => { const { phone, text } = extrair(req.body); const resposta = text.trim().toUpperCase(); if (resposta === "SIM") await db.confirmarConsulta(phone); if (resposta === "NÃO") await db.liberarHorario(phone); res.sendStatus(200); });
As mais comuns são: lembrete de consulta na véspera (por cron), confirmação de pedido logo após o pagamento (por evento), alerta de estoque baixo para a equipe (por condição no sistema) e régua de reengajamento de inativos (por agenda). Todas usam o mesmo POST de envio; as que pedem resposta acrescentam o webhook.
Com os três blocos anteriores como base, dá para montar praticamente qualquer fluxo. Quatro receitas prontas:
Um cron roda todo dia de manhã, busca as consultas do dia seguinte e dispara um lembrete para cada paciente. Se você quiser confirmação, adicione o webhook e peça "responda SIM para confirmar". Resultado: menos faltas, agenda mais cheia, zero trabalho manual.
Assim que o pagamento é aprovado, o tratador do evento dispara a confirmação com o número do pedido. O cliente recebe o aviso em segundos, o que reduz a ansiedade do "será que deu certo?" e diminui contatos no suporte:
POST https://api.zapon.dev/chat/send/text token: SEU_TOKEN { "Phone": "5511955554444", "Body": "Pedido #4821 confirmado! Obrigado pela compra. 📦" }
O seu sistema monitora uma métrica — estoque, fila, uptime — e, quando ela cruza um limite, dispara um alerta para o número do responsável ou para um grupo da equipe. Como o preço é por número e não por mensagem, deixar um número dedicado só para alertas internos custa o mesmo independentemente do volume.
Um cron diário verifica quem completou 7, 15 ou 30 dias sem comprar e dispara a mensagem correspondente a cada faixa. Quem responde sai da régua automaticamente (graças ao webhook), evitando aquele incômodo de continuar recebendo a sequência depois de já ter voltado.
Primeiro teste o envio isolado: faça um POST manual com um número seu e confirme que a mensagem chegou e que a resposta trouxe success: true. Depois teste o gatilho em modo seco (sem enviar de verdade) para checar quem entraria na lista. Por fim, ligue tudo com um destinatário de teste e observe o laço completo, incluindo o webhook.
Validar uma automação antes de soltá-la para a base inteira evita o pesadelo de mandar a mensagem errada para mil pessoas. Um roteiro em três etapas:
Phone seu. Confira três coisas — a mensagem chegou no aparelho, a resposta veio com "success": true e existe um id em data. Se vier erro de autenticação, revise o header token; se vier erro de número, revise o formato (só dígitos, com DDI e DDD).Se o webhook não dispara, o suspeito número um é a URL: confirme que ela é a de produção e que está acessível pela internet. Em desenvolvimento local, esse é o erro mais comum.
O zapon não usa a API oficial da Meta: o número conectado é um WhatsApp comum, então a saúde dele depende de você. Envie só para quem espera (opt-in), evite disparos em massa para contatos frios, espace os envios e use números dedicados. O preço é R$ 27 por número, com mensagens ilimitadas e 14 dias grátis sem cartão.
Alguns pontos para a sua automação durar e não derrubar o número:
id retornado e marque o registro como "avisado", para que uma reexecução do fluxo não mande a mesma mensagem duas vezes.token como senha. Guarde-o numa variável de ambiente ou num cofre de segredos, nunca escrito direto no código versionado.O agendamento fica no seu lado: um cron, uma fila ou um nó Schedule de uma plataforma de automação. No horário definido, o seu fluxo busca os destinatários e chama a API do zapon, que executa o envio. O zapon não tem um agendador próprio — ele entrega a mensagem quando você pede.
A URL é https://api.zapon.dev/chat/send/text, método POST, com o header token (o token da sua conexão) e um body JSON contendo Phone (número de destino, só dígitos, com DDI e DDD) e Body (o texto). A resposta traz success true e o id da mensagem.
Sim. Basta que o tratador do evento (uma trigger, um handler de aplicação ou um webhook do seu sistema) faça a chamada POST para a API do zapon. O endpoint é o mesmo usado em disparos por agenda; muda apenas o que aciona a chamada.
Sim. Cadastre uma URL de webhook na sua conexão, no painel do zapon, marcando os eventos desejados. Cada mensagem recebida vira um POST nessa URL, com remetente e texto, e o seu sistema decide a próxima ação — confirmar, reagendar ou escalar para um atendente.
Os dois caminhos funcionam. Com código, você chama a API direto de um cron ou de um handler de evento. Sem código, use n8n ou Make: um módulo de agendamento ou webhook como gatilho e um módulo HTTP apontando para a API do zapon.
Não. O preço é por número — R$ 27 por mês — com mensagens ilimitadas. Isso torna réguas, lembretes diários e alertas de alto volume previsíveis no custo. O que pede atenção não é o limite de cobrança, e sim a saúde do número: use boas práticas de envio.
Não. O zapon conecta um número de WhatsApp comum por QR Code ou código de pareamento. Não há fila de aprovação da Meta, templates obrigatórios nem custo por mensagem.
Use idempotência: salve o id retornado pela API e marque o registro como avisado. Antes de cada disparo, verifique essa marca. Assim, se o fluxo reexecutar (por uma falha ou um reprocessamento), ele não reenvia a mensagem ao mesmo destinatário.
14 dias grátis, sem cartão. Crie a conta, leia o QR Code e dispare sua primeira mensagem automática.