Início › Comparativos › API de WhatsApp para n8n
Qual API de WhatsApp usar no n8n?
Quem automatiza WhatsApp no n8n cai sempre no mesmo lugar: o node nativo é o da API oficial da Meta, que pede conta aprovada, templates e cobrança por mensagem. Quando o caso de uso é um número comum — atendimento, grupo, aviso interno, agente de IA respondendo cliente — a pergunta vira "qual API não oficial eu ponho no meio". Esta página coloca as cinco opções no mesmo eixo.
Qual API de WhatsApp usar no n8n? As cinco opções lado a lado
| Opção | Modelo | Custo | Quem mantém o servidor | Risco de ban |
|---|---|---|---|---|
| WhatsApp Cloud API (node nativo) | Oficial da Meta | por mensagem | Meta | Nenhum |
| Evolution API | Open source, self-host | licença R$ 0 + servidor | Você | Existe |
| WAHA | Open source, self-host | licença R$ 0 + servidor | Você | Existe |
| Z-API | Gerenciada | R$ 99,99 por número/mês | Fornecedor | Existe |
| Wafly | Gerenciada | R$ 59,90 até 10; R$ 39,90 acima de 10 para parceiros | Fornecedor | Existe |
Evolution API e WAHA são software livre de verdade: você baixa, sobe e não paga licença. WAHA mantém tudo gratuito e se sustenta por doação; Evolution API é aberta e tem comunidade grande em português. Nenhuma das duas cobra por mensagem, e as duas têm node ou integração para n8n. Se você tem servidor, gosta de manter infraestrutura e o WhatsApp não é crítico para o seu faturamento, elas resolvem e custam licença zero. É honesto dizer isso antes de qualquer outra coisa.
Evolution e WAHA são grátis no n8n? O que "grátis" custa de verdade
A conta que costuma faltar não é a da licença. É a de operação:
| Item | Self-host (Evolution / WAHA) | Gerenciada |
|---|---|---|
| Licença | R$ 0 | no preço |
| VPS | a partir de ~US$ 6/mês | no preço |
| Atualizar quando o WhatsApp muda o protocolo | você | fornecedor |
| Sessão cai de madrugada | você | fornecedor |
| Reconexão, QR, pareamento | você | fornecedor |
| Backup da sessão | você | fornecedor |
O protocolo do WhatsApp muda sem aviso, e quando muda, quem hospeda precisa atualizar. Enquanto não atualiza, o fluxo do n8n para de disparar e ninguém avisa — o webhook simplesmente silencia. Se o seu fluxo do n8n responde cliente, esse silêncio é venda perdida. É esse o item que a mensalidade de uma API gerenciada compra: não é o software, é o plantão.
A escolha, então, é sincera: self-host troca dinheiro por tempo seu. Se o seu tempo está sobrando e você quer controle total, self-host ganha. Se o seu tempo é o gargalo do negócio, gerenciada ganha.
Como montar um fluxo de WhatsApp no n8n que não quebra na troca de API?
O erro mais caro é deixar todo o workflow depender do payload bruto do fornecedor. Normalize o evento logo depois do webhook; assim, trocar API altera dois pontos — entrada e envio — sem obrigar você a refazer agente, CRM, banco ou regras de atendimento.
| Etapa | Node no n8n | Saída que deve ficar estável |
|---|---|---|
| 1. Entrada | Webhook Trigger | Evento bruto preservado para diagnóstico |
| 2. Normalização | Edit Fields ou Code | phone, text, messageId, instanceId |
| 3. Roteamento | Switch | Texto, áudio, imagem e status separados |
| 4. Regra de negócio | AI Agent, CRM ou banco | Resposta independente do fornecedor |
| 5. Envio | Node dedicado ou HTTP Request | ID retornado para rastrear a entrega |
Um objeto interno simples já desacopla o restante do fluxo:
{
"phone": "5511999999999",
"text": "Olá, preciso de ajuda",
"messageId": "id-do-fornecedor",
"instanceId": "atendimento-01",
"direction": "inbound"
}Guarde a URL base e o token nas credenciais do n8n, nunca dentro do node. Na migração, duplique o workflow, conecte um número de homologação e compare envio, recebimento e status de entrega antes de trocar a produção. O guia de migração da Z-API aplica esse processo ao caso mais comum.
Quando usar o node oficial da Meta no n8n?
Se o WhatsApp sustenta o seu faturamento, considere a API oficial: ela evita o risco contratual inerente ao método não oficial, embora ainda exija cumprimento das políticas da Meta. O node de WhatsApp Business Cloud já vem no n8n, sem instalar nada.
O modelo é diferente: a Meta cobra por mensagem entregue conforme país e categoria quando a mensagem é tarifada. Templates de marketing e autenticação podem gerar custo; mensagens de serviço dentro da janela de atendimento de 24 horas e mensagens de utilidade enviadas em resposta ao cliente não são cobradas pela Meta. Confira as tarifas vigentes e a eventual taxa do provedor antes de comparar com uma mensalidade fixa.
O que é gratuito na janela de atendimento
Quando o cliente procura a empresa, abre-se uma janela de atendimento de 24 horas; ela recomeça a cada nova mensagem do usuário. A regra pública da Meta diz que mensagens de serviço enviadas nessa janela não são cobradas. Mensagens de utilidade enviadas em resposta ao usuário também são gratuitas para a Meta.
Um fluxo de n8n com agente de IA pode trocar várias mensagens para resolver um chamado. Não multiplique todas as respostas pela tarifa de um template: se forem mensagens de serviço na janela, não há cobrança da Meta por elas. Para mensagens iniciadas pela empresa, separe categoria, país e volume entregue para calcular o custo real.
Z-API no n8n
A Z-API é gerenciada: você não hospeda nada e paga R$ 99,99 por número por mês. No n8n, a integração é feita pelo nó HTTP Request apontando para a API da Z-API, com o webhook de recebimento configurado no painel deles. Funciona bem, e o custo por número é o item a comparar. Se você já tem fluxos na Z-API e quer trocar de fornecedor sem refazer tudo, o caminho está em migrar Evolution ou Z-API no n8n.
Evolution API no n8n
A Evolution API tem community node para n8n e comunidade grande em português, o que explica por que tanta gente começa por ela. É software livre: licença zero, servidor seu, manutenção sua. O ponto de atenção não é a integração, é a operação: quando o protocolo do WhatsApp muda, a sessão cai até você atualizar, e o fluxo do n8n silencia. Se esse é o seu caso hoje, veja Evolution API instável no n8n: diagnóstico e alternativas antes de trocar.
WAHA no n8n
O WAHA também se integra ao n8n e também é gratuito, sustentado por doação. A escolha entre WAHA e Evolution é menos sobre n8n e mais sobre qual projeto você prefere manter: os dois exigem servidor, atualização e alguém de plantão quando a sessão cai. A conta completa do self-host está em WAHA em produção: a conta do self-host.
Baileys no n8n
Baileys não é uma API, é uma biblioteca. Para usar no n8n você precisa de um serviço seu que exponha HTTP e webhooks em cima dela, que é exatamente o que Evolution e WAHA fazem. Se a pergunta é "Baileys ou n8n", a resposta é: n8n com uma API pronta na frente, e a biblioteca só se você vai escrever e manter esse serviço. O que a biblioteca não resolve sozinha está em Baileys em produção.
Wafly no n8n
A sessão WhatsApp é gerenciada pela Wafly, que custa R$ 59,90 por número e tem community node próprio (n8n-nodes-wafly) para n8n self-hosted: credencial, envio, recebimento por webhook e monitoramento de conexão sem nó HTTP. O node e os templates Wafly atuais exigem hospedagem própria do n8n e configuração de credenciais. No n8n Cloud, use HTTP Request para integrar a API. O passo a passo está em como integrar WhatsApp no n8n, e há 8 templates prontos para importar.
| Seu ambiente | Caminho Wafly | O que validar antes de assinar |
|---|---|---|
| n8n self-hosted | Community node n8n-nodes-wafly | Instalação, credenciais, envio recebido pelo teste e callback no Webhook. |
| n8n Cloud | HTTP Request + Webhook, com nodes nativos | Header Auth, JSON, Production URL ativa e proteção dos tokens. Não depende do node Wafly no Cloud. |
| Agente com IA | Fluxo de qualificação e encaminhamento | Consentimento, parser, deduplicação, saída humana e custo do modelo separado. |
Como escolher em 3 perguntas
1. Se esse número for banido amanhã, o negócio para? Se sim, oficial da Meta. Não tem discussão nem desconto que compense.
2. Você quer manter servidor? Se sim, Evolution API ou WAHA, licença zero e controle total. Se não, gerenciada.
3. Quantos números? Preço fixo por número compensa conforme o volume de mensagens sobe, porque não acompanha o envio. Em poucos números com pouquíssimo tráfego, a oficial sai mais barata.
Testar no n8n antes de decidir
A Wafly tem node próprio publicado para n8n, 3 dias grátis e sem cartão. Dá para montar o fluxo de verdade e medir o seu volume real antes de assinar qualquer um dos caminhos acima.
Criar conta grátis Ver o passo a passo da integraçãoPerguntas frequentes
O n8n tem node de WhatsApp nativo?
Tem: o node de WhatsApp Business Cloud, da API oficial da Meta, e o WhatsApp Trigger. Funcionam sem instalar nada, mas exigem conta de empresa aprovada, templates e cobrança por mensagem. Para número comum sem aprovação, é preciso um node de comunidade ou chamadas HTTP para uma API não oficial.
Evolution API é realmente grátis?
O software é open source e a licença não custa nada. Você paga o servidor onde ela roda, a partir de cerca de US$ 6 por mês numa VPS, e paga com o seu tempo: atualização quando o protocolo do WhatsApp muda, reconexão de sessão, backup e plantão quando cai. É uma troca legítima de dinheiro por tempo, e faz sentido para quem já mantém infraestrutura.
WAHA é pago?
Não. O WAHA é gratuito e mantém tudo aberto, sustentado por doação voluntária. Assim como a Evolution API, o custo real está no servidor e na manutenção, que ficam com você.
Qual a diferença entre Z-API e Wafly?
As duas são gerenciadas e não cobram por mensagem. Z-API Ultimate: R$ 99,99. Wafly: R$ 59,90 até 10 instâncias e R$ 39,90 acima de 10 em conta parceira.
API não oficial pode ser banida?
Pode. Toda API não oficial viola os termos de serviço da Meta e a penalidade prevista é o banimento do número. O risco depende muito do uso: volume, opt-in dos contatos e qualidade da conversa. Não existe fornecedor que elimine esse risco, e desconfie de quem prometer isso.
Preciso de n8n self-hosted para usar node de comunidade?
O node Wafly e seus templates atuais exigem n8n self-hosted, com hospedagem própria. O n8n Cloud aceita community nodes verificados, mas a disponibilidade do node Wafly no Cloud não está confirmada. No Cloud, use HTTP Request para chamar a API.
Continue comparando
Preços de terceiros podem mudar sem aviso: confirme na fonte antes de decidir. Regra de cobrança da API oficial conferida na página da Meta em 27 de setembro de 2026. Evolution API, WAHA e Z-API são marcas de seus respectivos donos, sem relação com a Wafly.