Automação low-code
Integrar WhatsApp no n8n
O n8n é uma plataforma de automação de fluxos de trabalho low-code, muitas vezes usada em versão self-hosted, que conecta aplicativos e APIs sem exigir um backend próprio. Você monta automações arrastando nós num canvas visual: o nó HTTP Request dispara chamadas para qualquer API REST e o nó Webhook fica escutando eventos externos. Como ele fala HTTP puro, o n8n conversa com praticamente qualquer serviço, inclusive a ZapZap API, sem precisar de um conector oficial dedicado.
Por que conectar
Conectar a ZapZap API ao n8n transforma o WhatsApp num gatilho e num canal de saída dentro dos seus fluxos. Imagine uma clínica: um novo agendamento cai numa planilha, o n8n detecta a linha, chama a ZapZap API pelo nó HTTP Request e dispara a confirmação no WhatsApp do paciente na hora. No sentido inverso, cada mensagem recebida chega via webhook num nó Webhook do n8n, que pode consultar um CRM, acionar a IA da instância ou encaminhar o lead para um vendedor. Como a ZapZap API usa números não oficiais gerenciados, com aquecimento em comunidade e recursos de anti-bloqueio, você automatiza o atendimento reduzindo o risco de restrição por volume, algo que a API oficial engessa. São R$15 por número ativo/mês, pré-pago, e você começa com crédito grátis para testar o fluxo inteiro antes de escalar.
Passo a passo
- 1
Crie a instância e pegue as chaves
No painel da ZapZap API, provisione um número e copie o x-api-key e o x-api-secret da instância. Guarde também a base https://api.zapzapapi.com. Esses três dados são o que o n8n vai usar para autenticar.
- 2
Monte o workflow de envio no n8n
Em Workflows, clique em Add workflow, depois no botão + do canvas. Adicione um gatilho (por exemplo Manual Trigger para testar, ou Schedule Trigger para rotinas) e ligue nele um nó HTTP Request.
- 3
Configure o nó HTTP Request para enviar mensagem
No HTTP Request, defina Method como POST e a URL para o endpoint de envio da ZapZap API (confira o caminho exato em https://api.zapzapapi.com/llms.txt). Em Send Headers ative e adicione x-api-key e x-api-secret com os valores da instância. Em Send Body use JSON com o número do destinatário e o texto. Clique em Execute step para disparar o teste.
- 4
Crie o nó Webhook para receber mensagens
Em um novo fluxo, adicione o nó Webhook como gatilho. Copie a Production URL que ele gera e cadastre esse endereço como URL de webhook da sua instância na ZapZap API. Assim, cada evento (mensagem recebida, status de entrega) cai direto no n8n.
- 5
Ative e trate os eventos
Ligue o toggle Active do workflow para o Webhook ficar em produção. Depois do nó Webhook, adicione nós como IF, Set ou outro HTTP Request para reagir: responder automaticamente, gravar num banco ou notificar a equipe. Feche o fluxo com um nó Respond to Webhook se precisar devolver 200 rápido.
Exemplo
// Exemplo ILUSTRATIVO do nó HTTP Request no n8n (POST)
// Campos e caminho exatos: https://api.zapzapapi.com/llms.txt
POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text
Headers:
x-api-key: SUA_API_KEY
x-api-secret: SEU_API_SECRET
Content-Type: application/json
Body:
{
"number": "5511999999999",
"text": "Olá! Seu agendamento foi confirmado."
}Ilustrativo. Os campos e endpoints exatos estão na documentação.
Perguntas frequentes
Preciso da versão self-hosted do n8n para integrar?
Não. A integração funciona tanto no n8n Cloud quanto no self-hosted, porque tudo acontece via nós HTTP Request e Webhook padrão. No self-hosted, só garanta que a URL do Webhook seja acessível pela internet para a ZapZap API conseguir entregar os eventos.
Como o n8n autentica na ZapZap API?
Pelos cabeçalhos x-api-key e x-api-secret da sua instância. No nó HTTP Request, ative Send Headers e adicione os dois. Você pode salvar como Header Auth em Credentials para reaproveitar entre vários nós sem repetir os valores.
Dá para receber as mensagens do WhatsApp dentro do n8n?
Sim. Use o nó Webhook como gatilho, copie a Production URL e cadastre ela como webhook da instância na ZapZap API. Cada mensagem recebida ou mudança de status chega como um evento que aciona seu fluxo automaticamente.
Usar automação no WhatsApp pode bloquear meu número?
Qualquer envio em volume tem risco. A ZapZap API trabalha com aquecimento em comunidade e recursos de anti-bloqueio para reduzir o risco, mas o comportamento do fluxo também conta: evite disparos massivos e mensagens idênticas em sequência dentro do n8n.
Quanto custa manter essa integração rodando?
A ZapZap API cobra R$15 por número ativo por mês, no modelo pré-pago, e oferece crédito grátis para testar. O n8n tem plano próprio (cloud ou self-hosted gratuito), então o custo da automação em si depende só da sua escolha de hospedagem dele.
Comece com crédito grátis
Crie sua conta, conecte um número em minutos e teste a API com aquecimento e anti-bloqueio. R$15 por número ativo/mês, pré-pago, sem fidelidade.