Wafly › Tutoriais › WhatsApp no n8n

Como integrar WhatsApp no n8n em 5 passos

Por Iago Velasco, fundador da Wafly · Atualizado em 5 de outubro de 2026 · self-hosted e caminho HTTP Request para Cloud

Escolha seu caminho: no n8n self-hosted, siga os cinco passos com o community node Wafly. No n8n Cloud, vá direto à configuração HTTP Request, sem instalar community node. A disponibilidade do node Wafly no Cloud não está confirmada; a aprovação de um template no catálogo não equivale à verificação do node. A Wafly gerencia a sessão WhatsApp, não a hospedagem do n8n.

Escopo do produto: este guia usa a API não oficial da Wafly, com risco de restrição do número. Se você precisa da plataforma oficial, o n8n tem o node WhatsApp Business Cloud da Meta, com requisitos e cobrança próprios. Não use este fluxo para disparos sem consentimento.

Passo 1: Criar a instância WhatsApp

1. Crie uma conta na Wafly (3 dias grátis, sem cartão; depois R$ 59,90 por número/mês).
2. No painel, crie uma instância e conecte um número próprio de teste. No celular, use o código de pareamento; no computador, escaneie o QR code em 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. Busque por “Wafly” ao adicionar um node. Se não aparecer, consulte as instruções de instalação da sua versão antes de reiniciar um serviço em uso.

A instalação via npm é para n8n self-hosted e exige perfil Owner/Admin. Confira a documentação de instalação do n8n. No Cloud, use o caminho HTTP Request abaixo.

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 e message. Use apenas um destinatário seu ou que autorizou o teste. Execute, inspecione a resposta e confirme o recebimento no WhatsApp: resposta HTTP de sucesso não comprova entrega ao destinatário.

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": "NUMERO_AUTORIZADO_COM_DDI", "message": "Teste autorizado do n8n" }

Os valores acima são placeholders, não credenciais nem número para envio. Guarde o identificador retornado pela API quando houver e correlacione-o com o status de entrega; não suponha um formato de resposta sem consultar a documentação do endpoint.

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

Como integrar no n8n Cloud com HTTP Request?

Resposta direta: use Manual Trigger → HTTP Request para enviar e Webhook → regra do fluxo → HTTP Request para responder. Esse caminho usa nodes nativos e não depende da instalação do pacote Wafly.

1. Adicione HTTP Request. Em Method, escolha POST; em URL, use o endpoint send-text mostrado acima, substituindo instância e token pelos seus valores privados.
2. Em Authentication, selecione Generic Credential Type → Header Auth. Crie uma credencial com Name = Client-Token e Value = seu Client-Token. Não duplique esse header nos parâmetros nem publique a credencial.
3. Ative Send Body, escolha Body Content Type → JSON e Specify Body → Using Fields Below. Crie os campos phone e message. Para o primeiro teste, preencha um número autorizado com DDI e um texto de teste.
4. Execute o node. Em caso de erro, verifique status HTTP, credenciais e estado da instância; não habilite Never Error para esconder a falha. Confirme o recebimento no aparelho de teste.
5. Para receber uma resposta, configure o Webhook do passo 5, publique/ative o workflow e envie uma mensagem do número de teste para a instância. Veja o payload em Executions antes de mapear os campos.

Proteja os tokens: este contrato inclui o token da instância na URL. Não compartilhe capturas, exports ou históricos de execução com a URL completa; substitua instância/token por placeholders. Mantenha o Client-Token em Credentials e restrinja o acesso ao workflow.

Fontes de configuração: HTTP Request e credenciais HTTP do n8n. Hospedagem n8n Cloud e uso de modelos de IA, quando incluídos, têm custos próprios.

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

1. No n8n, crie um workflow com um Webhook node (método POST). Publique/ative o workflow e copie a Production URL. A Test URL só fica disponível enquanto o editor escuta o teste; não a deixe cadastrada para operação contínua.
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" }'

Envie uma mensagem de teste para a instância e confira a execução em Executions. No Webhook nativo, o payload recebido normalmente fica em $json.body: examine o evento real antes de mapear telefone, texto e tipo. Filtre mensagens próprias (fromMe) e deduplique pelo ID para evitar loops e respostas duplicadas. Configuração aceita pela API não comprova que o callback foi entregue.

Guia de receiver, autenticação e validação: Webhook de WhatsApp. A diferença entre Test URL e Production URL está na documentação Webhook do n8n.

Como saber se a integração realmente funcionou?

• Conexão: a instância está conectada no painel.
• Envio: a chamada não falha, há ID quando retornado e o destinatário confirma o recebimento; sucesso HTTP isolado não é entrega.
• Recebimento: a resposta do número de teste aparece na execução correta do Webhook.
• Operação: o workflow ignora eventos próprios, deduplica IDs e registra falhas antes de usar contatos reais.

Quer qualificar leads com IA? O template Wafly publicado no catálogo n8n é um ponto de partida para self-hosted com community node e credenciais próprias. A chamada OpenAI é cobrada separadamente. Esse template não é um export HTTP Request pronto para Cloud nem prova de resultado comercial.

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.