O n8n é uma ferramenta de automação de fluxos que você pode auto-hospedar, e vem com nós nativos de WhatsApp para a API oficial WhatsApp Business Cloud da Meta. Se a sua organização se qualifica para a API oficial, este é o caminho em conformidade e à prova de banimento para enviar notificações e construir um chatbot, sem gateway não oficial. Este guia foca nesse caminho oficial; se você não pode usar a API oficial, veja nosso guia complementar sobre APIs não oficiais com n8n. Prefere uma ferramenta totalmente hospedada, sem nada para gerenciar? O mesmo fluxo com a API oficial é possível com o Zapier ou o Make.
Os dois nós nativos
- Nó WhatsApp Business Cloud, envia mensagens: mensagens de template para iniciar conversas e respostas livres de texto/mídia dentro de uma sessão aberta.
- Nó WhatsApp Trigger, dispara seu fluxo quando uma mensagem ou atualização de status chega pelo webhook da Meta, para você responder automaticamente.
O que você precisa antes
Como esta é a API oficial, há configuração de verdade: uma conta Meta Business, um app WhatsApp Business Cloud no painel do Meta for Developers, um número de telefone para a API e credenciais de acesso (um token de acesso e um ID de número de telefone). É aqui também que a elegibilidade importa, a Meta restringe alguns usos, e mensagens políticas/eleitorais em particular frequentemente não são permitidas. Cobrimos isso em Como um partido político pode usar a API do WhatsApp Business?.
Passo 1: Conecte o n8n à Cloud API
No n8n, crie credenciais de WhatsApp com seu token de acesso e o ID de número de telefone do painel da Meta. Adicione um nó WhatsApp Business Cloud a um fluxo e selecione seu número, pronto para enviar.
Passo 2: Envie uma mensagem de template
A API oficial só permite iniciar uma conversa com um template pré-aprovado (para mensagens de utilidade, autenticação ou marketing). No nó WhatsApp Business Cloud escolha “Send Template”, selecione seu template aprovado e mapeie as variáveis (como um nome ou número de pedido) de etapas anteriores do fluxo. É assim que se enviam lembretes, confirmações e transmissões com opt-in em conformidade.
Passo 3: Responda dentro da janela de 24 horas
Quando um usuário lhe escreve, abre-se uma janela de atendimento de 24 horas durante a qual você pode enviar mensagens livres (sem template). Use o WhatsApp Trigger para capturar a mensagem recebida e depois um nó “Send Message” do WhatsApp Business Cloud para responder com texto simples ou mídia, sem template enquanto a janela estiver aberta.
Passo 4: Construa um chatbot simples
- Adicione um WhatsApp Trigger e conecte o webhook da Meta a ele.
- Ramifique pelo texto da mensagem com um nó IF ou Switch, ou passe-o a um nó de IA para entender a intenção.
- Consulte os dados de que precisar (um banco de dados, CRM ou planilha do Google).
- Responda com um nó WhatsApp Business Cloud, e passe a um humano o que o bot não conseguir resolver.
Oficial ou não oficial: qual caminho?
Use a Cloud API oficial com o n8n quando você se qualifica e precisa de mensagens em conformidade e escaláveis, ela não vai banir seu número e suporta templates e transmissões com opt-in. Se a Meta não aceitar você, ou se você só precisa de uma pequena automação pessoal, uma API não oficial como a Evolution API é a alternativa, com as ressalvas que descrevemos lá. Para uma experiência de API oficial totalmente gerenciada sem construí-la você mesmo, veja a Wati.
Perguntas frequentes
O n8n tem um nó de WhatsApp embutido?
Sim. O n8n inclui um nó nativo WhatsApp Business Cloud para enviar mensagens e um nó WhatsApp Trigger para recebê-las, ambos usando a Cloud API oficial da Meta.
Por que preciso de templates de mensagem?
A API oficial exige um template pré-aprovado para iniciar uma conversa. Depois que o usuário responde, abre-se uma janela de 24 horas em que você pode enviar mensagens livres sem template.
A API oficial é gratuita?
O n8n em si é gratuito para auto-hospedar, mas a Meta cobra pela API do WhatsApp Business por conversa. Confira a tabela atual da Meta para a sua região e caso de uso.
