Como integrar com n8n

O n8n é uma ferramenta de automação que você pode hospedar na sua infraestrutura. A WhatsWave se conecta ao n8n por webhooks.

Quando usar

• Orquestrar fluxos complexos entre WhatsWave e sistemas internos
• Processar dados antes de enviar mensagem no WhatsApp
• Integrar com bancos de dados, APIs ou scripts próprios

Passo a passo

1. Prepare o workflow na WhatsWave

1. Acesse Automações → Novo workflow
2. Adicione o nó Webhook como gatilho
3. Copie a URL e a chave (X-Webhook-Key)
4. Monte o restante do fluxo (mensagem, CRM, condições etc.)
5. Ative o workflow

Figura 1: Dados do webhook para configurar no n8n

2. Configure o fluxo no n8n

1. Abra o n8n e crie um novo workflow
2. Adicione o nó que dispara a ação (ex.: Schedule, HTTP Request, banco de dados)
3. Adicione um nó HTTP Request
4. Configure:
   • Method: POST
   • URL: a URL copiada da WhatsWave
   • Header: X-Webhook-Key = chave do workflow
   • Body: JSON com os campos desejados (telefone, nome, mensagem etc.)
5. Execute um teste e confira se o workflow da WhatsWave rodou

Figura 2: Nó HTTP Request apontando para a WhatsWave

Enviar dados do n8n para a WhatsWave

Exemplo de corpo JSON:

{
  "telefone": "5511999999999",
  "nome": "Maria",
  "mensagem": "Seu pedido foi confirmado!"
}

No workflow, use {{trigger.body.telefone}}, {{trigger.body.nome}} nos nós seguintes.

Dicas

• Mantenha a chave do webhook em credencial segura no n8n
• Use o histórico de execuções da WhatsWave para ver se os dados chegaram corretamente
• Para respostas imediatas, ative o modo síncrono (?wait=true) no nó Webhook

→ Veja também: Como usar webhooks recebidos