Como integrar n8n com a
API Oficial do WhatsApp

n8n é uma ferramenta open-source de automação visual (similar a Zapier/Make, mas self-hosted e gratuita). Para WhatsApp Business API ela funciona melhor que SaaS porque você é dono dos workflows: pode conectar a qualquer API, banco de dados, CRM ou serviço de IA sem limites por plataforma e sem markup por mensagem.

Caso típico: um workflow recebe webhook do Shopify (pedido criado), enriquece com dados do cliente, dispara template de utilidade pelo WhatsApp e atualiza CRM — tudo em uma única automação. Isso seria 3 ferramentas diferentes em SaaS fechado.

• Número de WhatsApp dedicado: não pode estar logado no WhatsApp pessoal/Business app simultaneamente.
• Conta no Meta for Developers (gratuita).
• Business Manager: ideal verificada para começar em 2.000 disparos/dia.
• Infraestrutura para n8n: Cloudfy, VPS própria com Docker, ou n8n.cloud. Precisa de URL HTTPS pública (Meta exige TLS válido).
• 1 template aprovado de utilidade ou marketing (aprovação em até 24h).

1) Criar app no Meta for Developers. Em developers.facebook.com → Meus Apps → Criar App → tipo Business. Adicione o produto WhatsApp ao app e selecione o número dedicado. Gere o Token Permanente via Configurações de Sistema (não use Access Token temporário — expira em 24h).

2) Subir n8n. Na Cloudfy (recomendado), basta 1 clique e n8n + Chatwoot + Redis sobem juntos. Em VPS, use o Docker Compose oficial do n8n. Em n8n.cloud, a URL HTTPS já vem pronta. Anote a URL pública do seu n8n.

3) Credencial HTTP Header Auth. No n8n: Credentials → New → HTTP Header Auth. Name: Authorization. Value: Bearer <Token Permanente>. Salve. Essa credencial será usada por todos os nodes que falam com graph.facebook.com.

4) Webhook de recebimento. No n8n, crie workflow novo → Webhook node como trigger → método POST → autenticação None → ative o workflow para gerar URL de produção. Copie a URL.

No painel Meta: WhatsApp → Configuração → Webhooks → Editar URL de Callback. Cole a URL do n8n. Verify Token: defina qualquer string (ex: meu-token-secreto) e adicione validação no n8n via IF node comparando $json.query.hub_verify_token. Inscreva-se no campo messages.

5) Criar template. WhatsApp Manager → Templates de Mensagem → Criar Template. Categoria: utilidade (R$0,04) ou marketing (R$0,34). Idioma: Portuguese (BR). Preencha header, body com placeholders {{1}}, {{2}}. Aprovação leva até 24h.

6) Disparar via n8n. Em workflow novo: HTTP Request node → método POST → URL https://graph.facebook.com/v20.0/<PHONE_NUMBER_ID>/messages → Authentication: HTTP Header Auth (sua credencial) → Body Content Type: JSON → corpo:

{
  "messaging_product": "whatsapp",
  "to": "{{ $json.numero }}",
  "type": "template",
  "template": {
    "name": "boas_vindas",
    "language": { "code": "pt_BR" },
    "components": [{
      "type": "body",
      "parameters": [
        { "type": "text", "text": "{{ $json.nome }}" }
      ]
    }]
  }
}

7) Teste. Execute o workflow com seu próprio número. Confirme recebimento no WhatsApp e que aparece como conversa utility ou marketing no painel Meta.

• Carrinho abandonado: Shopify/WooCommerce webhook → n8n → IF (carrinho parado > 30 min) → WhatsApp template marketing.
• Confirmação de pedido: gateway de pagamento → n8n → WhatsApp template utilidade com nome do produto e prazo.
• Agente de IA 24h: webhook recebimento → OpenAI/Claude → IF (intenção = vender, suporte, ou cancelar) → WhatsApp template apropriado.
• Lead magnet: formulário de captura (Typeform/Tally) → n8n → CRM + WhatsApp template utilidade com link do material.
• Follow-up de cliente: CRM (HubSpot/Pipedrive) → n8n agendado (Cron) → WhatsApp template marketing para reativação.