A WhatsApp Cloud API é o canal oficial da Meta para automatizar WhatsApp — hospedada pela própria Meta, sem risco de banimento quando usada dentro das regras, e com um node nativo no n8n que dispensa gambiarra de webhook manual.
Adicione ao Google NotíciasNeste artigo
Por que ela existe
Diferente da Evolution API, a Cloud API não simula um WhatsApp comum — é uma interface que a própria Meta disponibiliza para empresas se conectarem ao WhatsApp Business de forma legítima, com aprovação e regras claras de uso.
Passo a passo da configuração
Crie uma conta no Meta for Developers e um app do tipo Business.
Adicione o produto WhatsApp ao app — a Meta gera um número de teste automaticamente, útil para validar o fluxo antes de usar um número real.
Gere o token de acesso e o Phone Number ID, que o n8n vai usar para autenticar.
No n8n, adicione as credenciais do tipo WhatsApp Business Cloud, colando o token gerado.
Use o node WhatsApp Business Cloud, nativo do n8n, para enviar mensagens — texto, template, mídia — sem precisar montar requisição HTTP manual.
Para receber mensagens, configure o webhook de recebimento apontando para uma URL do n8n (node Webhook), seguindo a verificação exigida pela Meta na primeira configuração.
A regra das 24 horas
A Cloud API tem uma janela de 24 horas a partir da última mensagem do cliente: dentro dela, você responde livremente com texto normal. Fora dela, só é permitido enviar mensagens de template, pré-aprovadas pela Meta — pensadas para evitar spam não solicitado.
Prepare templates aprovados para os casos mais comuns de contato fora da janela de 24 horas — confirmação de pedido, lembrete de agendamento, aviso de status. Sem isso, o fluxo trava justamente quando o cliente demora a responder.
Custo
A cobrança da Cloud API é por conversa, não por mensagem avulsa — e existe uma cota gratuita mensal de conversas iniciadas pelo negócio (o número exato varia e é definido pela Meta), suficiente para operações pequenas testarem sem custo.
A Cloud API exige mais configuração inicial que a Evolution API, mas remove o risco de banimento — a troca vale a pena para qualquer operação que dependa do WhatsApp para funcionar de verdade.
Perguntas frequentes
A WhatsApp Cloud API tem risco de banimento?
Não, quando usada dentro das regras da Meta — é o canal oficial, hospedado pela própria empresa, ao contrário de soluções não-oficiais como a Evolution API.
O que é a regra das 24 horas na Cloud API?
É a janela de tempo, a partir da última mensagem do cliente, em que você pode responder livremente com texto normal. Fora dela, só mensagens de template pré-aprovadas pela Meta são permitidas.
A WhatsApp Cloud API é gratuita?
Existe uma cota gratuita mensal de conversas iniciadas pelo negócio, suficiente para operações pequenas. Acima dela, a cobrança é por conversa, não por mensagem avulsa.
Este tutorial faz parte do guia Curso de n8n do zero ao avançado: o guia completo em português. Veja também: Node, trigger e workflow: o vocabulário do n8n em 10 minutos · A estrutura de dados do n8n: por que tudo é um array com json · Item linking no n8n: como ele decide qual item vai pra saída · Execuções passo a passo: como achar onde o fluxo do n8n quebrou · A Canvas UI do n8n 2.0: o que mudou e como se orientar · n8n Cloud ou self-hosted: a decisão que define seu custo e sua liberdade
Este tutorial faz parte do guia Curso de n8n do zero ao avançado: o guia completo em português. Veja também: Node, trigger e workflow: o vocabulário do n8n em 10 minutos · A estrutura de dados do n8n: por que tudo é um array com json · Item linking no n8n: como ele decide qual item vai pra saída · Execuções passo a passo: como achar onde o fluxo do n8n quebrou · A Canvas UI do n8n 2.0: o que mudou e como se orientar · n8n Cloud ou self-hosted: a decisão que define seu custo e sua liberdade
