No n8n, o zapon vira só mais um passo do seu fluxo: um nó HTTP Request envia mensagens de WhatsApp e um nó Webhook recebe os eventos em tempo real. Tudo no-code, usando os nós nativos do n8n e a API REST do zapon.
O n8n é uma plataforma de automação de fluxos (workflow automation) que conecta aplicativos, bancos de dados e APIs sem que você precise escrever um backend inteiro. Como o zapon expõe uma API REST simples para o WhatsApp, você não precisa de nenhum nó proprietário nem de plugin externo: o nó HTTP Request cuida do envio e o nó Webhook cuida do recebimento. Este guia mostra o caminho completo — da conexão do número até um fluxo de duas vias funcionando em produção — com os endpoints, headers e payloads reais da plataforma.
Ao longo do texto você vai ver os termos API WhatsApp n8n, enviar mensagem WhatsApp n8n e webhook WhatsApp n8n aparecerem com frequência, porque são exatamente as três peças que compõem qualquer automação WhatsApp nessa plataforma: autenticar, mandar e ouvir.
Você monta uma integração de WhatsApp de duas vias dentro do n8n: o nó HTTP Request envia mensagens pela API do zapon e o nó Webhook recebe cada mensagem ou evento do número conectado. Com isso você cria chatbots, confirmações de pedido, lembretes e notificações sem programar um servidor.
Ao final deste guia você terá dois fluxos básicos no n8n, que juntos formam a base de praticamente qualquer automação de WhatsApp:
Tudo isso roda sobre um número de WhatsApp comum — não há fila de aprovação da Meta, não há templates obrigatórios, não há custo por mensagem. O número se conecta por QR Code, exatamente como o WhatsApp Web, e passa a ser pilotado pela API.
Três coisas: uma conta no zapon (14 dias grátis, sem cartão) com pelo menos uma conexão de WhatsApp ativa, uma instância do n8n (cloud ou self-hosted) e um número de WhatsApp dedicado para conectar. Nenhuma conta de API oficial da Meta é necessária.
Antes de abrir o n8n, garanta que você tem:
Você não precisa de conta na Meta, não precisa do WhatsApp Business API oficial e não precisa cadastrar templates. O zapon conversa diretamente com o WhatsApp do número que você conectar.
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 o n8n fará.
Antes de qualquer coisa no n8n, o número precisa estar conectado e a conexão precisa ter um token. Esse token é a chave que o n8n vai usar para falar com a API.
Dentro do painel do zapon, 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: no n8n ele entra como um header chamado token (não é Authorization, não é Bearer). Trate-o como uma senha, porque quem tem o token consegue enviar mensagens em nome do seu número.
Dica: se você vai automatizar vários números, crie uma conexão para cada um. Cada token corresponde a um número específico, então o n8n 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 o n8n pode entrar em cena.
Adicione um nó HTTP Request do tipo POST apontando 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). Ao executar, a API entrega a mensagem e devolve o ID dela.
Este é o coração de qualquer fluxo de saída. Não existe nó "zapon" no n8n — e você não precisa de um. O nó HTTP Request, nativo do n8n, faz a chamada à API de envio de texto e pronto.
No editor do n8n, adicione um nó HTTP Request e preencha:
POST.https://api.zapon.dev/chat/send/text.JSON (em "Send Body" → JSON).Phone (o número de destino no formato internacional, só dígitos, ex.: 5511999999999) e Body (o texto da mensagem).O grande poder do n8n aparece aqui: em vez de fixar o número e o texto, você os puxa dos dados que chegam ao fluxo usando expressões. Por exemplo, ={{ $json.telefone }} pega o campo telefone do item que entrou no nó, e ={{ $json.mensagem }} pega o texto. Assim, o mesmo nó dispara mensagens diferentes para destinatários diferentes a cada execução.
A API do zapon não usa Bearer nem OAuth. A autenticação é um único header chamado token, cujo valor é o token da conexão que você copiou no Passo 1. No nó HTTP Request, ative "Send Headers" e adicione um header com nome token e valor igual ao seu token. (Para não deixá-lo exposto no fluxo, o ideal é guardá-lo como uma credencial ou variável de ambiente do n8n e referenciá-lo.)
Veja a chamada completa, já com as expressões do n8n mapeando os campos de entrada:
POST https://api.zapon.dev/chat/send/text token: SEU_TOKEN Content-Type: application/json { "Phone": "={{ $json.telefone }}", "Body": "={{ $json.mensagem }}" }
Ao executar o nó, a API responde com um JSON confirmando o envio e trazendo o identificador da mensagem:
{
"success": true,
"data": {
"id": "3EB0…"
}
}Esse id é útil: você pode salvá-lo num passo seguinte do fluxo (numa planilha, num banco) para rastrear cada envio de mensagem WhatsApp pelo n8n. Pronto — o fluxo de saída está completo.
Crie um fluxo que comece com um nó Webhook, copie a URL que o n8n gera e cadastre-a no painel do zapon, na seção Webhook da sua conexão, marcando os eventos desejados. A partir daí, cada mensagem recebida pelo número chega como um POST que dispara o fluxo no n8n.
Para o fluxo de entrada, a lógica se inverte: agora é o WhatsApp que avisa o n8n. Isso é feito com um webhook WhatsApp n8n — o zapon entrega cada evento (mensagem recebida, status de entrega, etc.) via POST na URL que você indicar, e essa URL é a do nó Webhook do n8n.
No n8n, crie um novo fluxo e adicione um nó Webhook como gatilho. Configure o método como POST e copie a URL de produção que o n8n gera (o n8n oferece uma URL de teste e uma de produção; use a de produção para o cadastro definitivo). Essa é a URL que o zapon vai chamar a cada evento.
Logo após o Webhook, é comum adicionar um nó de condição (IF/Switch) para filtrar apenas os eventos que interessam — por exemplo, processar somente mensagens recebidas de outras pessoas e ignorar as que o próprio número enviou. O payload do evento traz os dados da mensagem (remetente, texto, tipo) para você roteirizar o fluxo.
De volta ao painel do zapon, abra a sua conexão e localize a seção Webhook. Lá você:
Feito isso, mande uma mensagem de teste para o número conectado: o nó Webhook do n8n é acionado na hora e o fluxo começa a rodar com os dados da mensagem. É assim que se monta um recebimento de mensagem WhatsApp no n8n sem polling e sem gambiarra.
Para o envio, execute o nó HTTP Request com um número de teste e confirme que a mensagem chegou no WhatsApp e que a resposta trouxe success: true. Para o recebimento, ative o fluxo do Webhook e envie uma mensagem ao número conectado, verificando se o fluxo foi acionado com os dados corretos.
Validar nas duas direções leva poucos minutos:
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 um 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 algo não dispara no recebimento, o suspeito número um é a URL: confirme que ela é a de produção e que está acessível pela internet (no self-hosted, esse é o erro mais comum).
Praticamente qualquer fluxo disparado por evento: confirmação de pedido logo após o pagamento, um chatbot simples de respostas, lembretes de compromisso enviados por cron e notificações automáticas a partir do seu CRM. Em todos eles, o nó HTTP Request envia e, quando há diálogo, o nó Webhook recebe.
Com os dois fluxos da seção anterior como base, dá para combinar gatilhos do n8n com a API do zapon de inúmeras formas. Quatro cenários comuns:
Um gatilho (webhook da sua loja, nó do e-commerce ou linha nova numa planilha) inicia o fluxo assim que um pedido é pago. O n8n monta o texto com os dados do pedido e o nó HTTP Request dispara a confirmação para o cliente. Exemplo de payload do envio:
POST https://api.zapon.dev/chat/send/text token: SEU_TOKEN { "Phone": "={{ $json.cliente.telefone }}", "Body": "Pedido #={{ $json.pedido.id }} confirmado! Obrigado pela compra." }
O fluxo começa no nó Webhook (mensagem recebida), passa por um nó Switch que olha o texto e decide a resposta — um menu, uma FAQ, um "fale com atendente" — e termina num HTTP Request que devolve a mensagem ao cliente. É a forma mais leve de automação WhatsApp conversacional: ouvir, decidir, responder.
Um nó Schedule (cron) roda todo dia em um horário fixo, busca os compromissos do dia numa planilha ou banco e, para cada um, dispara um HTTP Request com o lembrete. Ótimo para consultas, agendamentos e renovações.
Quando um negócio muda de etapa no seu CRM (via webhook do CRM para o n8n), o fluxo envia uma mensagem ao lead — um follow-up, uma proposta, um aviso. Como cada conexão tem o seu token, você pode até direcionar a mensagem para sair do número do vendedor responsável trocando o header.
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ê. Evite disparos em massa para contatos que não esperam mensagem, mantenha o conteúdo relevante e use números dedicados. O preço é R$ 27 por número, com mensagens ilimitadas.
Alguns pontos para a integração durar:
id retornado e evite mandar a mesma mensagem duas vezes caso o fluxo execute de novo.token como senha. No n8n, prefira credenciais ou variáveis de ambiente a deixá-lo escrito no nó.Não. Os nós nativos HTTP Request e Webhook do n8n já fazem tudo, porque o zapon é uma API REST padrão. O HTTP Request envia as mensagens e o Webhook recebe os eventos.
Por um único header chamado token, cujo valor é o token da sua conexão (você o copia no painel do zapon). Não é Bearer nem OAuth: basta adicionar esse header no nó HTTP Request.
A URL é https://api.zapon.dev/chat/send/text, método POST, com 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.
Crie um fluxo com um nó Webhook, copie a URL de produção dele e cadastre-a na seção Webhook da sua conexão no painel do zapon, marcando os eventos desejados. Cada mensagem recebida vira um POST que dispara o fluxo.
Sim. Receba a mensagem pelo nó Webhook, decida a resposta com nós de lógica (IF, Switch, Code) e responda com um nó HTTP Request de envio. Ouvir, decidir e responder é todo o ciclo de um chatbot.
Sim, nos dois. A única exigência é que a URL do nó Webhook seja acessível pela internet para o zapon conseguir entregar os eventos. No n8n cloud isso já é garantido; no self-hosted, exponha a instância por um domínio público.
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.
São R$ 27 por número por mês, com mensagens ilimitadas. Você ainda tem 14 dias grátis, sem cartão, para testar a integração com o n8n antes de assinar.
14 dias grátis, sem cartão. Crie a conta, leia o QR Code e use a API no seu primeiro fluxo.