Docs
Começar grátis

Plugue o WhatsApp no n8n

O Wazzap expõe as mensagens recebidas como webhooks e aceita envios via HTTP. Com isso, o n8n vira o cérebro entre o seu número de WhatsApp e o resto do seu stack: qualquer banco, qualquer IA, qualquer API, sem código de cola.

Resumo

O n8n é uma plataforma de automação open-source com centenas de nodes prontos. Combine com o Wazzap e você tem um roteador low-code entre o WhatsApp e tudo que fala HTTP. Mensagens entrantes disparam um webhook no n8n; as respostas saem como POSTs simples pra API do Wazzap.

O n8n é a escolha certa quando você precisa de automação além do que os Workflows do HighLevel oferecem: ramificações custom, APIs de terceiros, lógica multistep ou consultas no seu próprio banco.

Por que rotear pelo n8n?

  • Qualquer modelo de IA. Plugue Claude, Gemini, LLMs locais via Ollama, ou combine vários modelos num só fluxo.
  • Qualquer fonte de dados. Consulte um contato no PostgreSQL, Airtable, Notion ou numa API privada antes de responder.
  • Self-hosted com privacidade. Rode o n8n no seu próprio servidor se não puder mandar conversas por um SaaS de terceiros.
  • Fluxos versionados. Exporte as automações como JSON, commite, revise as mudanças.

Setup

1. Aponte os webhooks do Wazzap pro n8n

  1. No n8n crie um workflow novo e jogue um node trigger Webhook.
  2. Escolha POST como método. Copie a URL de produção que o n8n te dá.
  3. No Wazzap abra Settings, Webhooks da sub-conta.
  4. Cole a URL do n8n em Inbound message webhook e clique em Salvar.

A partir daí cada mensagem entrante de WhatsApp chega ao seu fluxo n8n como JSON.

2. Monte o fluxo no n8n

Dentro do workflow dá pra fazer qualquer coisa: classificar a mensagem com um node de IA, buscar o contato num CRM, ramificar por intenção, gerar a resposta, anexar um arquivo. O catálogo de nodes do n8n cobre todos os SaaS importantes.

{
  "from": "+5511912345678",
  "name": "Diego",
  "type": "text",
  "body": "Oi, tem horário na sexta?",
  "wazzap_sub_account": "acme-co",
  "received_at": "2026-05-14T10:21:33Z"
}

3. Mande a resposta via HTTP

Com a resposta pronta, adicione um node HTTP Request apontando pro endpoint de envio do Wazzap. Autentique com a sua API key e faça POST da mensagem.

POST https://api.wazzap.mx/v4/messages
Authorization: Bearer ${WAZZAP_KEY}
Content-Type: application/json

{
  "to": "+5511912345678",
  "body": "Tenho 15h e 17h livre na sexta."
}

Padrões comuns

  • Auto-resposta de IA com memória. Guarde as últimas 10 mensagens em Postgres ou Supabase chaveadas por número; reidrate como contexto pra cada chamada do LLM.
  • Fluxo de agendamento. Detecte "agendar" ou "marcar" com regex, consulte sua API de calendário pra slots livres, responda com opções, confirme com um webhook posterior.
  • Enriquecimento de leads. Quando um número novo escreve, busque o telefone no Clearbit ou no seu CRM, taggue a conversa e atribua ao rep certo.
  • Roteador multi-idioma. Detecte o idioma com um node de IA, roteie pra um template de prompt diferente por locale.

Seu fluxo no n8n também pode disparar em eventos saindo: mensagem entregue, mensagem lida, número desconectado, escutando a referência de webhooks do Wazzap.

Solução de problemas

O n8n recebe o webhook mas a minha resposta nunca chega

Veja a resposta do node HTTP Request. Um 401 significa que a API key do Wazzap está errada ou expirada; um 422 significa que o payload está sem to ou body. O body da resposta tem o erro exato de validação.

Os webhooks entrantes param de disparar depois de um tempo

O plano cloud free do n8n dorme workflows inativos. Ou rode o n8n self-hosted, ou garanta que o seu workflow está Active e que a URL do webhook aponta pro endpoint de produção, não o de teste.

Respostas duplicadas

Seu fluxo provavelmente tem dois caminhos gerando envio. Adicione um node If no começo pra filtrar mensagens não-texto ou eventos de sistema, e use a visão execution data do n8n pra rastrear onde o duplicado entra.

Esta página foi útil?