Wafly › Tutoriais › WhatsApp no n8n
Como integrar WhatsApp no n8n em 5 passos
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. Sem VPS, sem manter sessão, sem HTTP Request montado na mão.
Passo 1: Criar a instância WhatsApp
- Crie uma conta na Wafly (3 dias grátis, sem cartão).
- No painel, crie uma instância e escaneie o QR code com o WhatsApp do número que vai automatizar (WhatsApp › Dispositivos conectados).
- Anote as três credenciais da instância:
Client-Token,instanceetoken. Você vai usá-las no passo 3.
Passo 2: Instalar o node no n8n
- No n8n, abra Settings → Community Nodes → Install a community node.
- Digite
n8n-nodes-waflye confirme. - 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:
| Campo | O que é | Onde fica |
|---|---|---|
| Client-Token | Token da sua conta (header HTTP) | Painel Wafly |
| Instance | Identificador da instância | Detalhe da instância |
| Token | Token da instância | Detalhe da instância |
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)
- No n8n, crie um workflow com um Webhook node (método POST) e copie a URL de produção dele.
- 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-groupno campo phone).
Monte esse fluxo hoje
Instância conectada por QR em ~2 minutos. 3 dias grátis, sem cartão: dá pra testar o tutorial inteiro no trial.
Criar instância grátisPerguntas frequentes
O n8n tem node de WhatsApp?
Nativo, só o do WhatsApp Business Cloud (API oficial da Meta, por mensagem). Para API por instância com QR, use um community node como o n8n-nodes-wafly.
Preciso de VPS?
Não, porque a sessão roda na Wafly. VPS só se você self-hostear a API também (fizemos essa conta aqui).
Funciona no n8n cloud?
Em qualquer n8n que aceite community nodes. Sem community nodes, o node HTTP Request resolve com os mesmos endpoints.
Quanto custa?
O node é gratuito. A Wafly custa R$ 59,90 até 10 instâncias; acima de 10 em conta parceira, todas passam a R$ 39,90. Mensagens ilimitadas e trial de 3 dias.
Continue
n8n é marca de seus respectivos mantenedores, sem relação com a Wafly. Encontrou algo impreciso? Fale com a gente que corrigimos.