WaflyTutoriais › WhatsApp no n8n

Como integrar WhatsApp no n8n — em 5 passos

Atualizado em julho de 2026 · ~10 minutos do zero à primeira mensagem

Resumo: para integrar WhatsApp no n8n, instale o community node n8n-nodes-wafly, configure a credencial com o Client-Token, adicione o node Wafly para enviar mensagens e um Webhook para receber. Cerca de 10 minutos do zero à primeira mensagem — sem VPS e sem montar HTTP Request na mão.

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

  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, 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:

CampoO que éOnde fica
Client-TokenToken da sua conta (header HTTP)Painel Wafly
InstanceIdentificador da instânciaDetalhe da instância
TokenToken da instânciaDetalhe 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)

  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

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átis

Perguntas 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

Webhook de WhatsAppOs 4 webhooks da instância e um receiver de exemplo. Enviar mensagem por APIcurl, Node.js e Python, com o payload real. Vem da Evolution API?O custo real do self-host vs gerenciada — e a migração do fluxo n8n.

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