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 — 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 e open source. A instância Wafly custa R$ 59,90/mês com mensagens ilimitadas, trial de 3 dias sem cartão.
Continue
n8n é marca de seus respectivos mantenedores, sem relação com a Wafly. Encontrou algo impreciso? Fale com a gente que corrigimos.