n8n WhatsApp: como conectar à API oficial da Meta (passo a passo)

Você montou um fluxo no n8n e agora quer que ele fale no WhatsApp. O caminho certo existe e é curto, mas cada passo depende de uma peça da Meta que o n8n não cria por você.

Este guia mostra o caminho completo, do app na Meta até a primeira mensagem enviada e a primeira recebida.

O que você vai ver neste guia

• O que é o n8n e quando ele entra no seu atendimento
• As formas de conectar o n8n ao WhatsApp
• O que você precisa ter antes de começar
• Como enviar uma mensagem pelo node oficial, com o corpo da chamada da Graph API
• Como receber mensagens com o WhatsApp Trigger
• Exemplos de automação e os cuidados com templates, janela de 24 horas e custos
• Quando o n8n basta e quando você precisa de uma plataforma de atendimento

O que é o n8n?

O n8n é uma ferramenta de automação de fluxos de trabalho. Você liga blocos, chamados nodes, e cada bloco faz uma tarefa: receber um evento, consultar uma planilha, chamar uma API, enviar uma mensagem. A documentação do n8n o descreve como uma ferramenta de automação de fluxos de trabalho com licença fair-code.

Dá para rodar o n8n em um servidor seu (auto-hospedado) ou usar a versão hospedada pelo próprio n8n, o n8n Cloud. As duas existem, e o fluxo de WhatsApp deste guia funciona nas duas. Se você procura o panorama de automação no WhatsApp além do n8n, veja o guia de automação de WhatsApp para atendimento e follow-up.

Como conectar o n8n ao WhatsApp?

Há duas formas oficiais: usar os nodes prontos do n8n ou chamar a Graph API da Meta com o node HTTP Request. Os nodes prontos são mais rápidos. O HTTP Request serve para o que o node ainda não cobre.

A documentação do node WhatsApp Business Cloud lista as operações que ele suporta. A documentação do WhatsApp Trigger lista os eventos que ele recebe.

Existem também conectores não oficiais, baseados no WhatsApp Web. Eles não fazem parte da plataforma oficial da Meta, e este guia não os usa. Se quiser entender a diferença, leia o guia sobre a API de WhatsApp não oficial.

O que você precisa antes de começar?

Você precisa de quatro coisas: conta de desenvolvedor na Meta, portfólio empresarial, um app com o produto WhatsApp e um número. Sem elas, o n8n não tem com quem falar.

A página de credenciais do n8n lista os requisitos:

• Conta de desenvolvedor Meta: permite criar e gerenciar apps, incluindo os de WhatsApp.
• Portfólio empresarial Meta: o WhatsApp exige um. Antes se chamava Business Manager, e a interface ainda pode mostrar os dois nomes.
• App empresarial com WhatsApp: você o cria no painel Meta for Developers e adiciona o produto WhatsApp. O guia do n8n pede também a URL da política de privacidade e dos termos de serviço do app, e que o app esteja em modo Live.
• Número de telefone: o número que vai enviar e receber as mensagens, ligado à sua conta comercial do WhatsApp.

Dois pontos pedem atenção. O primeiro é o token. O token que o painel API Setup gera é um token de usuário, que a documentação de tokens da Meta associa ao primeiro envio de teste. Para produção, a Meta indica o token de usuário do sistema, que é de longa duração, como explica o guia de token da WhatsApp Business API. Guarde-o como segredo, nunca em texto dentro do fluxo.

O segundo é o número. Se ele hoje está no aplicativo WhatsApp Business, a documentação da Meta sobre onboarding de usuários do app descreve um fluxo do Embedded Signup, chamado de coexistência, para conectar esse número à Cloud API. Ele exige o app WhatsApp Business na versão 2.24.17 ou superior, então confira os requisitos. Leia também o passo a passo para ativar a API oficial do WhatsApp antes de mexer em qualquer coisa.

Como enviar uma mensagem do n8n pelo WhatsApp (passo a passo)?

Crie a credencial, adicione o node WhatsApp Business Cloud, escolha a operação Send e informe destinatário e texto. Em cinco passos o fluxo está pronto para teste.

1. Gere o Access Token. No painel Meta for Developers, abra seu app, vá em WhatsApp, depois API Setup, e selecione Generate access token. Copie o token e também o WhatsApp Business Account ID.
2. Crie a credencial no n8n. Em Credentials, escolha a credencial do WhatsApp Business Cloud e cole o Access Token e o Business Account ID. A documentação de credenciais chama esse método de API key.
3. Adicione o node. No fluxo, insira o node WhatsApp Business Cloud e selecione a credencial.
4. Escolha a operação. Em Message, use Send para texto livre ou Send Template para um template aprovado. Informe o número remetente, o telefone do destinatário e o conteúdo. Os nomes exatos dos campos podem mudar com a versão do n8n.
5. Execute e confira. Rode o node e veja a mensagem chegar no aparelho de teste.

O node também tem a operação Send and Wait for Response. Ela envia a mensagem e pausa o fluxo até uma pessoa aprovar ou responder. Serve para aprovações humanas no meio da automação.

E se a operação que você quer não existir no node?

Use o node HTTP Request e chame a Graph API direto. O n8n documenta esse caminho: no HTTP Request você escolhe autenticação por tipo de credencial predefinido e reaproveita a credencial já criada.

A documentação da Meta sobre envio de mensagens mostra a chamada. É um POST para o endpoint de mensagens do ID do número de telefone, com o token no cabeçalho Authorization:

POST https://graph.facebook.com/vXX.X/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

E o corpo, para uma mensagem de texto:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "text",
  "text": {
    "preview_url": false,
    "body": "Olá. Recebemos o seu pedido."
  }
}

Troque vXX.X pela versão da Graph API vigente na documentação da Meta. A resposta da API só confirma que a Meta aceitou o pedido. Ela não prova a entrega, que chega depois por webhook, no evento de mensagens.

Como receber mensagens do WhatsApp no n8n?

Use o node WhatsApp Trigger. Ele inicia o fluxo quando a Meta avisa o n8n de um evento, como uma mensagem nova do cliente.

A documentação do WhatsApp Trigger lista os eventos que ele aceita: Messages, Account Review Update, Account Update, Business Capability Update, Message Template Quality Update, Message Template Status Update, Phone Number Name Update, Phone Number Quality Update, Security e Template Category Update.

A credencial do Trigger é diferente da do envio. Segundo a documentação de credenciais do n8n, o Trigger usa OAuth2, com o App ID do seu app como Client ID e o App Secret como Client Secret, ambos em App settings, Basic.

Há um detalhe que pega muita gente. Segundo a documentação do n8n, o WhatsApp só permite registrar um webhook por app. Cada vez que você alterna entre a URL de teste e a de produção do n8n, a Meta troca a URL registrada. Então um fluxo publicado e outro em teste não recebem eventos ao mesmo tempo. A solução que o n8n documenta é despublicar o fluxo de produção enquanto você testa, sabendo que ele para de receber tráfego nesse período. Pela mesma regra, escolha um destino por app: ou o Trigger do n8n, ou um endpoint próprio como o do guia de webhook.

Como a Meta precisa alcançar a URL do Trigger, uma instância auto-hospedada precisa estar publicada em HTTPS com certificado válido. A página da Meta sobre o endpoint de webhook diz que certificados autoassinados não são aceitos.

Para entender o que a Meta envia e como o endpoint responde, veja o guia sobre webhook do WhatsApp.

Que automações dá para montar com n8n e WhatsApp?

Dá para montar avisos, confirmações, triagem e aprovações, desde que cada mensagem respeite as regras da Meta. Os exemplos abaixo usam só operações e eventos que a documentação lista.

• Confirmação de pedido ou agendamento: um evento do seu sistema dispara um template aprovado pela operação Send Template.
• Alerta interno de lead: o Trigger recebe a mensagem, o n8n grava os dados em planilha ou CRM e avisa um responsável.
• Triagem inicial: o fluxo lê a primeira mensagem, classifica o assunto e responde com texto livre dentro da janela.
• Aprovação humana: com Send and Wait for Response, o fluxo pede um sim ou não a um gestor antes de seguir.
• Vigia da conta: os eventos de status e qualidade de template avisam a equipe quando um template muda de situação.

Cada exemplo é um fluxo que você mantém. Conforme eles se multiplicam, vale olhar a última seção.

Quais cuidados com templates, janela de 24 horas e custos?

Texto livre só vale dentro da janela de 24 horas. Fora dela, só template aprovado. E, segundo a Meta, as mensagens de serviço passaram a ser cobradas.

A documentação da Meta explica a janela: quando o cliente envia uma mensagem, começa um cronômetro de 24 horas. Se ele escrever de novo antes de acabar, o cronômetro reinicia. Com a janela aberta, você envia mensagens de serviço, como texto, imagem e botões. Com ela fechada, só envia templates aprovados. A Meta lembra ainda que você só pode escrever para quem aceitou receber mensagens da sua empresa.

No n8n, isso vira regra de fluxo. Se a última mensagem do cliente tem mais de 24 horas, o fluxo precisa trocar a operação Send por Send Template. Um fluxo que ignora isso tenta mandar texto livre onde a Meta só admite template.

Sobre custos, a página de preços da Meta, lida em 8 de outubro de 2026, diz o seguinte:

• A Meta cobra por mensagem, por categoria e mercado, e apenas pelas mensagens da empresa para o usuário. Mensagens do usuário para a empresa não são cobradas.
• Desde 1º de outubro de 2026, as mensagens de serviço voltaram a ser cobradas. Cada número comercial tem 1.000 mensagens de serviço gratuitas por mês, e a cobrança começa na 1.001ª.
• Templates são cobrados por mensagem entregue, conforme a categoria.

Um ponto próprio do n8n: a ferramenta não cobra essas tarifas, a Meta cobra. O n8n tem seu custo à parte. A edição auto-hospedada é, segundo a licença documentada pelo n8n, de uso livre para fins internos de negócio, mas você paga servidor e tempo de manutenção. Para valores do n8n Cloud, consulte a página de preços do próprio n8n.

Quando o n8n basta e quando você precisa de uma plataforma de atendimento?

O n8n basta para avisos, integrações entre sistemas e fluxos automáticos. Ele não substitui um lugar onde uma equipe conversa com clientes, divide filas e acompanha prazos.

Pense em duas perguntas. Quem responde quando o fluxo termina? E como você sabe se alguém ficou sem resposta? O n8n move dados entre sistemas, mas uma conversa com vários atendentes pede fila, dono e histórico visíveis.

É aí que entra uma plataforma de atendimento. A Chatsac, por exemplo, roda sobre a API oficial do WhatsApp e organiza filas por setor no mesmo número, conversa com dono e prazo, transferência registrada, relatório de primeira resposta, chatbot, CRM e funil. Uma coisa não elimina a outra: a automação cuida do que é regra, e a plataforma cuida do que é conversa.

Se o seu caso é atendimento com equipe, veja o custo da plataforma abaixo:

Para ver o conjunto de peças da API oficial, volte ao guia de WhatsApp API para atendimento.

Perguntas frequentes

Por onde começar com n8n e WhatsApp?

Comece pelo teste mais curto: um app na Meta, um token de teste, a credencial no n8n e uma mensagem de texto para o seu próprio número. Quando essa primeira mensagem chegar, acrescente o Trigger e depois o template. Qual fluxo da sua operação hoje depende de alguém copiar e colar no WhatsApp? Ele é o primeiro candidato.