Como integrar o WhatsApp com o n8n
O caminho seguro para integrar o WhatsApp com o n8n é a API oficial (WhatsApp Business Cloud, da Meta): você cria um app no painel de desenvolvedores da Meta e usa no n8n o nó WhatsApp Trigger para receber mensagens e o nó WhatsApp Business Cloud para responder. Soluções não oficiais, que conectam um número comum pelo QR code, são mais rápidas de montar, mas os termos do WhatsApp proíbem envio automatizado sem autorização e o número pode ser suspenso.
Atualizado em · Por Luis Henrique Cuba
Oficial ou não oficial: a decisão que vem antes do fluxo
Quase todo pedido de "integrar o WhatsApp" chega com a mesma pergunta: dá para usar o número que a empresa já tem no celular? Dá, com ferramentas não oficiais. A questão é o que acontece quando o volume cresce ou alguém denuncia as mensagens.
Os Termos de Serviço do WhatsApp proíbem, entre outras coisas, mensagens em massa, mensagens automáticas e acesso por meios automatizados sem autorização, e preveem a suspensão ou desativação da conta. Para uma clínica que confirma consultas ou uma loja que avisa sobre entregas, perder o número principal custa muito mais do que a mensalidade da API oficial.
API oficial (WhatsApp Business Cloud)
Hospedada pela Meta, com nós prontos no n8n. Exige conta de desenvolvedor, portfólio empresarial na Meta, modelos de mensagem aprovados para iniciar conversas e pagamento por mensagem conforme a tabela da Meta. É a opção para operação comercial.
Soluções não oficiais (Evolution API, Z-API, WAHA e similares)
Conectam um número comum lendo o QR code, como o WhatsApp Web, e conversam com o n8n por webhook e pelo nó HTTP Request. Servem para testes e uso pessoal. Não têm garantia da Meta, e o risco de bloqueio recai sobre o seu número.
O que preparar na Meta
- Conta de desenvolvedor da Meta (developers.facebook.com).
- Portfólio empresarial da Meta, o antigo Business Manager. A Meta exige um para os serviços de mensagens.
- Um app do tipo empresa com o produto WhatsApp adicionado (botão Set up no bloco do WhatsApp).
- Na tela WhatsApp > API Setup: o token de acesso e o WhatsApp Business Account ID.
- Em App settings > Basic: o App ID e o App Secret, usados pela credencial OAuth2 do gatilho.
- Um número de telefone para produção que não esteja preso a outra integração.
- O app em modo Live para receber eventos reais. A verificação completa do app passa pela revisão da Meta.
Passo a passo no n8n
- 01
Crie as duas credenciais
A credencial de API (token de acesso e Business Account ID) é usada pelo nó WhatsApp Business Cloud. A credencial OAuth2 (App ID como Client ID e App Secret como Client Secret) é usada pelo WhatsApp Trigger.
- 02
Adicione o WhatsApp Trigger
Escolha o evento Messages. O n8n registra o webhook no app da Meta. Para isso o seu n8n precisa estar acessível na internet por HTTPS, com certificado válido.
- 03
Filtre o que não é mensagem
O mesmo evento traz avisos de status (enviada, entregue, lida). Use um nó IF para seguir só quando houver o campo messages no corpo recebido.
- 04
Trate repetições
Um webhook pode chegar mais de uma vez. Guarde o id da mensagem (o wamid) em uma tabela ou planilha e ignore o que já foi processado. Sem isso, o cliente recebe a resposta em dobro.
- 05
Decida a resposta
Um Switch por palavra-chave resolve menus simples. Para perguntas abertas, um nó de agente de IA consultando uma base de dados da empresa. Deixe sempre um caminho para atendimento humano.
- 06
Responda com o WhatsApp Business Cloud
Operação Send dentro da janela de atendimento; Send Template fora dela. O nó também tem Send and Wait for Response, útil para pedir aprovação de alguém da equipe antes de seguir.
- 07
Teste e publique
Envie mensagens de um celular de teste, confira cada execução no histórico do n8n e só então ative o fluxo em produção.
Regras da Meta que mudam o desenho do fluxo
Janela de atendimento de 24 horas
Quando o cliente escreve, abre-se uma janela de 24 horas contadas a partir da última mensagem dele. Dentro dela você responde com texto livre. Fora dela, só com modelo de mensagem (template).
Modelos precisam de aprovação
Os templates são classificados como marketing, utilidade ou autenticação e passam pela revisão da Meta antes do uso. Um aviso de "seu pedido saiu para entrega" é utilidade; uma promoção é marketing.
Cobrança por mensagem
Desde 1º de julho de 2025, a Meta cobra por mensagem, e não mais por conversa. Mensagens que não são template são gratuitas, e templates de utilidade enviados dentro da janela de atendimento também. Confira os valores para o Brasil na página de preços da Meta, porque eles mudam.
Um webhook por app
A Meta registra um único webhook por app. Se você alterna entre a URL de teste e a de produção do n8n, uma sobrescreve a outra, e o fluxo publicado para de receber eventos. A documentação do n8n sugere despublicar o fluxo de produção enquanto testa. Outra saída é manter na Meta um app separado só para testes.
Erros comuns na integração
Fluxo funciona no teste e para em produção
Quase sempre é o webhook único da Meta apontando para a URL de teste. Reative o fluxo de produção para registrar a URL certa.
Token que expira em poucas horas
É o token temporário da tela API Setup, que a Meta descreve como de curta duração. Troque pelo token de usuário do sistema.
Resposta que não chega
A janela de 24 horas fechou e o fluxo tentou mandar texto livre. Use Send Template.
Áudio e imagem ignorados
Mensagens de mídia chegam com um id, não com o arquivo. Use a operação de download de mídia do nó antes de transcrever ou salvar.
Como integrar o WhatsApp com o n8n: dúvidas comuns
Dá para usar o mesmo número que está no celular?
Com a API oficial, o número precisa ser registrado na plataforma da Meta, e existem regras para migrar um número que já está no aplicativo. Confira as condições na documentação da Meta antes de mexer no número principal da empresa.
A Evolution API é proibida?
A ferramenta em si é um software de código aberto. O problema é o uso: automatizar um número comum fora da plataforma oficial vai contra os termos do WhatsApp, e a conta pode ser suspensa. Para teste, tudo bem; para atender clientes, prefira a API oficial.
Preciso de um n8n na internet para receber mensagens?
Sim. A Meta envia os eventos para um endereço HTTPS público. Um n8n rodando só no seu computador não recebe nada sem um túnel ou uma hospedagem.
Posso mandar mensagem para uma lista de contatos?
Pela API oficial, só com templates aprovados e para quem aceitou receber mensagens da empresa. Disparo em massa por número comum é exatamente o que os termos do WhatsApp proíbem.
Dá para colocar um agente de IA no atendimento?
Dá. O agente fica entre o gatilho e o envio da resposta. Limite o que ele pode fazer, registre as conversas e mantenha uma saída para atendimento humano quando ele não souber responder.
Perguntas parecidas
Precisa de ajuda para resolver isso na sua empresa?
Respondemos em até 24 horas com as próximas perguntas e uma proposta objetiva.