Wafly › Tutoriais › WhatsApp no n8n

Como integrar WhatsApp no n8n em 5 passos

Por Iago Velasco, fundador da Wafly · Atualizado em julho de 2026 · node Wafly para n8n self-hosted

O n8n não tem node nativo para API de WhatsApp por instância (o node oficial embutido é só para a Cloud API da Meta, cobrada por mensagem). Este tutorial usa o node dedicado n8n-nodes-wafly (open source, publicado no npm) e mostra o caminho completo: instalar, autenticar, enviar e receber mensagens. O node e os templates Wafly atuais exigem n8n self-hosted com hospedagem própria. A Wafly gerencia a sessão WhatsApp. No n8n Cloud, use o caminho por HTTP Request mostrado abaixo.

Passo 1: Criar a instância WhatsApp

1. Crie uma conta na Wafly (3 dias grátis, sem cartão).
2. No painel, crie uma instância e escaneie o QR code com o WhatsApp do número que vai automatizar (WhatsApp › Dispositivos conectados).
3. Anote as três credenciais da instância: Client-Token, instance e token. Você vai usá-las no passo 3.

Passo 2: Instalar o node no n8n

1. No n8n self-hosted, abra Settings → Community Nodes → Install a community node.
2. Digite n8n-nodes-wafly e confirme.
3. Reinicie o n8n (no Docker: docker compose restart n8n).

Depois do restart, busque por "Wafly" ao adicionar um node no workflow. Se aparecer, a instalação funcionou.

Passo 3: Configurar as credenciais

Ao adicionar o node Wafly pela primeira vez, crie uma credencial nova com os três valores do passo 1:

Passo 4: Enviar a primeira mensagem

Num workflow novo: Manual Trigger → Wafly, operação de envio de texto, com phone (ex.: 5511999999999) e message. Execute e a mensagem chega no número informado.

Prefere ver o que acontece por baixo (ou usa um n8n sem community nodes)? O node HTTP Request equivalente é:

POST https://wafly.com.br/api-bridge-whats/instances/SUA_INSTANCIA/token/SEU_TOKEN/send-text
Header: Client-Token: SEU_CLIENT_TOKEN
Body: { "phone": "5511999999999", "message": "Olá do n8n!" }

Resposta: { "value": true, "messageId": "3EB0XXXX" }

O mesmo padrão vale para imagem, áudio, documento, enquete e os demais tipos. A lista completa está na documentação da API.

Passo 5: Receber mensagens (o que separa bot de disparador)

1. No n8n, crie um workflow com um Webhook node (método POST) e copie a URL de produção dele.
2. Cadastre essa URL como webhook de mensagens recebidas da instância:

curl -X PUT "https://wafly.com.br/api-bridge-whats/instances/SUA_INSTANCIA/token/SEU_TOKEN/update-webhook-received" \
  -H "Client-Token: SEU_CLIENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "value": "https://SEU_N8N/webhook/whatsapp-recebidas" }'

A partir daí, toda mensagem recebida pela instância dispara o seu workflow com o payload completo (remetente em phone, flag isGroup, conteúdo etc.). Guia detalhado de webhooks, incluindo boas práticas de receiver: Webhook de WhatsApp.

Ideias de fluxo pra começar

• Cobrança automática: Schedule Trigger diário → Google Sheets (contas vencidas) → Wafly envia o lembrete com o Pix.
• Confirmação de agendamento: véspera do horário → mensagem de confirmação → resposta do cliente cai no Webhook e atualiza a agenda.
• Notificação de venda: webhook da loja/Stripe → mensagem no grupo da equipe (use ID-group no campo phone).

Perguntas frequentes

Continue

n8n é marca de seus respectivos mantenedores, sem relação com a Wafly. Encontrou algo impreciso? Fale com a gente que corrigimos.