WPPAPI
Guia · Automação

WhatsApp no n8n, sem API oficial

Dois nodes bastam: HTTP Request para enviar, Webhook para receber. Nenhum node de comunidade, nenhuma aprovação da Meta, nenhum template obrigatório.

1

Crie a conta e conecte um número

Crie a conta na WPPAPI (trial de 3 dias, sem cartão), crie uma instância no painel e escaneie o QR Code com o WhatsApp do número que vai automatizar. Anote o instanceId e o token da instância.

2

Envie mensagens com o HTTP Request node

No n8n, adicione um node HTTP Request: método POST, URL https://api.wpp-api.com/instances/SEU_ID/token/SEU_TOKEN/send-text, body JSON com phone e message. Pronto — qualquer fluxo do n8n agora envia WhatsApp.

3

Receba mensagens com o Webhook node

Adicione um node Webhook no n8n (método POST) e copie a URL de produção. No painel da WPPAPI, cadastre essa URL como webhook da instância para o evento message. Cada mensagem recebida no número dispara seu fluxo.

4

Feche o ciclo

Combine os dois: o Webhook node recebe a mensagem, um IF decide a resposta (ou chama um modelo de IA), e o HTTP Request responde via send-text. Você tem um atendente automático em um fluxo de 3 nodes.

O body do envio

O n8n interpola variáveis do fluxo direto no JSON — ideal para confirmações de pedido, alertas e notificações:

{
  "phone": "5511999999999",
  "message": "Pedido {{ $json.orderId }} confirmado! 🎉"
}

O evento que chega no Webhook node

Use data.from edata.body nas condições do seu fluxo. Ignore eventos com data.fromMe: true para não responder a si mesmo:

// Estrutura do evento recebido no Webhook node (mensagem recebida)
{
  "event": "received",
  "wahaEvent": "message",
  "instanceId": "sua-instancia",
  "timestamp": "2026-07-23T15:00:00.000Z",
  "data": {
    "from": "5511999999999",
    "body": "quero falar com atendente",
    "type": "chat",
    "fromMe": false,
    "chatId": "5511999999999"
  }
}

Boas práticas para não ser bloqueado

  • Só envie para quem deu opt-in — automação não oficial exige mais cuidado, não menos.
  • Adicione um delay aleatório (2–8s) entre envios em massa no n8n.
  • Aqueça números novos: comece com poucas dezenas de mensagens por dia.
  • Valide o número antes com check-number para não enviar a números inexistentes.

Próximos passos: veja o guia dewebhooks com HMAC em Node.jspara validar assinaturas fora do n8n, ou areferência completa da API.

Monte esse fluxo agora

3 dias grátis, sem cartão — tempo de sobra para o fluxo rodar em produção.

Criar conta grátis