n8n | Conectar o WhatsApp ao n8n pela Cloud API oficial

Como uma mensagem do WhatsApp chega até um fluxo do n8n?

A Meta entrega toda mensagem enviada ao número para uma única URL que você indica, como um HTTP POST. Essa URL é a integração inteira. Coloque um nó Webhook do n8n numa URL de produção, defina essa URL como destino do webhook do número, e o fluxo roda a cada mensagem recebida.

O payload leva o remetente, o texto ou a referência da mídia, um timestamp e o id da mensagem. Daí em diante é um fluxo comum do n8n: ramifique pelo conteúdo, busque o cliente, chame o que mais você tiver rodando, e decida se vai responder.

Como isso é Coexistência, a mesma mensagem também está no app do WhatsApp Business no celular. Uma pessoa pode responder. O fluxo vê o que a pessoa enviou, e a pessoa vê o que o fluxo enviou, então nenhum dos dois responde por cima do outro.

{
  "from": "14155550188",
  "id": "wamid.HBgLMTQxNTU1NTAxODgVAgAS",
  "timestamp": "1758412800",
  "type": "text",
  "text": { "body": "do you have anything friday?" }
}

Como o fluxo envia uma resposta?

Com um nó HTTP Request contra a Cloud API, usando o phone number id e o token de acesso do número. Os dois são visíveis no painel, ou pelo conector MCP, se você preferir que um assistente busque.

O que enviar depende do tempo, e é justamente aqui que as pessoas escorregam. Dentro de 24 horas da última mensagem do cliente, texto livre funciona e a resposta é o que o fluxo montou. Fora dessa janela, só passa um template que a Meta já aprovou. Um fluxo que só envia texto livre parece perfeito nos testes, porque os testes sempre acontecem segundos depois de uma mensagem, e depois emudece no primeiro caso real que atravessa a noite.

O formato robusto é uma ramificação: verifique há quanto tempo chegou a última mensagem recebida e escolha texto livre ou template de acordo.

O n8n também pode usar o conector MCP?

Sim, e o n8n é incomum nisso. O nó MCP Client Tool dele conecta a um servidor MCP remoto e suporta OAuth2, que é do que o nosso precisa, então um nó AI Agent dentro de um fluxo pode chamar nossas ferramentas direto.

Vale saber disso porque a maioria das plataformas de automação não consegue. Make e Zapier rodam servidores MCP próprios e nenhum dos dois age como cliente, então nenhum dos dois alcança um servidor de terceiros. O n8n alcança.

Ele é bom para a metade de agir: um nó de agente que decide enviar uma mensagem, verificar a saúde de um número ou ler o status de aprovação de um template enquanto o fluxo está rodando. O que ele não faz é substituir o webhook, porque o MCP não tem como ser acordado por uma mensagem que chega.

Qual dos dois um fluxo deve usar?

Os dois, para metades diferentes, e a divisão não é questão de gosto.

O webhook é como qualquer coisa começa. Um cliente escreve, a Meta entrega no seu nó Webhook, o fluxo roda. Não existe equivalente em MCP para isso em ferramenta nenhuma, porque o protocolo é requisição e resposta, e não algo que possa ser chamado de fora para dentro.

O MCP Client Tool serve para um agente dentro desse fluxo agir sem que você escreva a chamada na mão. Se o fluxo já sabe exatamente o que enviar, um nó HTTP Request contra a Cloud API é mais simples e tem menos o que dar errado. Se um agente está decidindo, o conector entrega a ele as onze ferramentas e as regras que vêm nas descrições delas, incluindo a janela de 24 horas.

O que diferencia isso dos nós de WhatsApp do n8n que as pessoas já usam?

A maioria das montagens de WhatsApp no n8n que você encontra por aí é construída sobre um gateway não oficial que entra como aparelho vinculado. São fáceis de começar e colocam o número em risco, porque esse mecanismo viola os termos do WhatsApp e a Meta detecta o padrão de tráfego, não a biblioteca.

O outro caminho comum é a API oficial sem Coexistência, que funciona mas migra o número. O app do WhatsApp Business para de funcionar nele, e a equipe que atendia o dia inteiro tem que se mudar para uma ferramenta nova. Para a maioria das pequenas empresas isso é inviável, e é exatamente por isso que tantas delas foram parar num gateway não oficial.

Coexistência é a combinação que faltava. API oficial, e o celular continua funcionando.

Erros comuns

• Usar uma Test URL do n8n como destino do webhook. Ela para de escutar quando o editor fecha, então as mensagens são entregues para o nada.
• Não responder à requisição de verificação da Meta. A Meta manda um GET com um desafio antes de entregar qualquer coisa, e um nó que não devolve esse desafio nunca recebe mensagem.
• Responder com texto livre fora da janela de 24 horas. Falha em silêncio do ponto de vista do fluxo, e só um template aprovado passa.

Perguntas frequentes

Continue lendo