Sim, dá para criar um chatbot simples no WhatsApp usando a API oficial da Meta e o n8n. O fluxo básico recebe a mensagem por um webhook, identifica o assunto e envia uma resposta automática. Para começar sem transformar o projeto em um Frankenstein de integrações, use o número de teste da Meta e automatize apenas dúvidas previsíveis.
Este caminho usa a WhatsApp Business Platform (Cloud API), não um robô que controla o WhatsApp Web. Você precisará de uma conta de desenvolvedor da Meta, um número de teste, um token de acesso e uma instalação do n8n. Também há uma regra importante: depois da janela de atendimento de 24 horas, a empresa precisa usar um template aprovado para iniciar ou continuar o contato.
O que você vai montar
O exemplo abaixo cria um atendimento inicial para uma pequena empresa. A pessoa envia uma mensagem, o n8n verifica o texto e responde conforme o assunto:
- “horário”: retorna os dias e horários de atendimento;
- “preço” ou “ orçamento”: avisa que um atendente vai continuar a conversa;
- qualquer outra mensagem: mostra um menu curto com as opções disponíveis.
Na prática, o desenho fica assim: WhatsApp Trigger → filtro de mensagem → Switch ou IF → WhatsApp Business Cloud. O Trigger recebe o evento e o nó do WhatsApp envia a resposta. O n8n documenta os dois nós separadamente: o primeiro reage a eventos, enquanto o segundo envia mensagens e também trabalha com mídia.
Pré-requisitos
- uma conta no Meta for Developers;
- um aplicativo da Meta com o produto WhatsApp configurado;
- o número de teste, o
Phone Number IDe um token de acesso; - uma instalação do n8n Cloud ou uma instância própria acessível pela internet;
- um telefone autorizado como destinatário de teste.
Se o seu n8n estiver rodando apenas em localhost, a Meta não conseguirá entregar o webhook. Em uma instalação própria, publique o serviço com HTTPS e um domínio ou túnel seguro. O endereço de teste e o endereço de produção do n8n são diferentes, e isso causa boa parte da confusão durante a configuração.
1. Crie o ambiente de teste na Meta
Entre no painel de desenvolvedores da Meta, crie um aplicativo e adicione o produto WhatsApp. No início, a própria plataforma fornece dados para teste. Anote o Phone Number ID e gere ou copie um token com permissão para enviar mensagens.
Adicione o seu telefone à lista de destinatários de teste e faça o envio de uma mensagem pelo exemplo da própria Meta. Esse passo separa dois problemas que costumam ser misturados: se a mensagem de teste não chega, o erro ainda está no cadastro da Meta; se ela chega, mas o fluxo não responde, a investigação passa para o webhook ou o n8n.
Para produção, troque o número de teste por um número de negócio, revise as permissões e use um token adequado ao ambiente. Não coloque token no texto do workflow, em print de tela ou em repositório público.
2. Configure as credenciais no n8n
No n8n, abra Credentials, crie uma credencial do tipo WhatsApp Business Cloud e informe os dados pedidos pela versão da sua instalação. O essencial é que a credencial consiga autenticar a conta e tenha acesso ao número configurado na Meta.
Depois, crie um workflow e adicione o nó WhatsApp Trigger. Selecione a mesma credencial e escolha o evento Messages. Esse nó é o ponto de entrada: cada mensagem recebida vira uma execução do workflow.
O n8n tem uma documentação específica para criar e usar webhooks em automações. Vale ler esse guia antes de culpar o WhatsApp por um endereço que ainda não está publicado ou por um workflow que não foi ativado.
3. Ligue o webhook do WhatsApp ao workflow
Salve o workflow e use a URL de teste exibida pelo n8n enquanto estiver fazendo a configuração. Na área de Webhooks do aplicativo da Meta, informe:
- a URL pública do webhook;
- um token de verificação criado por você;
- a assinatura do campo
messagespara receber mensagens.
A Meta faz uma chamada de verificação antes de começar a enviar eventos. Se a validação falhar, confira se o token digitado no painel é exatamente igual ao token esperado pelo workflow e se a URL é pública, usa HTTPS e não termina com um caminho diferente do exibido pelo n8n.
Quando a configuração funcionar, envie uma mensagem do telefone de teste e abra a execução no n8n. O payload de uma mensagem de texto contém, entre outros campos, o número de quem enviou em messages[0].from e o conteúdo em messages[0].text.body. Em instalações que preservam o payload completo, o caminho costuma aparecer como:
{"entry":[{"changes":[{"value":{"messages":[{"from":"5511999999999","type":"text","text":{"body":"horário"}}]}}]}]}Use a saída real do seu Trigger como referência. A estrutura pode variar conforme a versão do nó e o tipo de evento recebido; copiar um caminho sem olhar a execução é uma receita rápida para obter campos vazios.
4. Separe as intenções com IF ou Switch
Depois do Trigger, adicione um nó IF ou Switch. Antes de testar regras de palavras, filtre eventos que não tenham mensagem de texto. O mesmo webhook pode receber atualizações de status, imagens, áudios e outros tipos.
Para um protótipo, use o texto normalizado em minúsculas e crie regras simples:
| Regra | Resposta inicial | Próximo passo |
|---|---|---|
| contém “horário” | “Atendemos de segunda a sexta, das 9h às 18h.” | encerrar ou mostrar o menu |
| contém “preço” ou “orçamento” | “Vou encaminhar sua solicitação para um atendente.” | registrar lead em planilha ou CRM |
| qualquer outro texto | “Digite 1 para horário ou 2 para orçamento.” | aguardar a próxima mensagem |
Esse modelo não é inteligência artificial; é uma árvore de decisões. E isso é uma vantagem no primeiro atendimento: as respostas são previsíveis, fáceis de revisar e não inventam condições comerciais. Depois que o fluxo estiver estável, você pode acrescentar uma planilha, um CRM ou um modelo de IA, mas mantenha um caminho claro para atendimento humano.
5. Envie a resposta pelo WhatsApp Business Cloud
Para cada saída do IF ou do Switch, adicione o nó WhatsApp Business Cloud e escolha a operação Message → Send. Selecione mensagem de texto e preencha:
- Recipient: o número do campo
fromrecebido pelo Trigger; - Text: a resposta correspondente à regra;
- Credential: a mesma credencial do ambiente de teste.
Em vez de digitar um número fixo no destinatário, mapeie o campo que veio do evento. Em um payload completo da Cloud API, a expressão de exemplo é {$json.entry[0].changes[0].value.messages[0].from}. Confira o painel de dados do seu n8n antes de salvar, porque o nó pode apresentar o conteúdo em outro nível.
Ative o workflow apenas depois de testar cada saída. Uma mensagem enviada para o número errado não é um “teste inofensivo”; é uma falha de atendimento que pode expor dados de outra pessoa.
Como testar sem se perder
- envie uma mensagem com a palavra “horário”;
- confirme no n8n se o Trigger recebeu um evento de texto;
- verifique se o IF ou Switch escolheu a saída correta;
- confirme o destinatário no nó de envio;
- teste uma mensagem fora das regras e a passagem para humano;
- publique o workflow e repita o teste usando a URL de produção.
O n8n alerta que o WhatsApp permite apenas um webhook registrado por aplicativo. Ao alternar entre URL de teste e URL de produção, uma pode substituir a outra. Se o teste funciona quando o workflow está aberto, mas para de funcionar depois da publicação, confira qual endereço está atualmente registrado na Meta.
Erros comuns e como corrigir
A Meta não valida o webhook
Verifique HTTPS, URL pública, token de verificação e o método de validação. Um servidor local sem túnel ou domínio público não recebe a chamada da Meta.
O Trigger executa, mas não há resposta
Veja se o fluxo recebeu uma mensagem de texto ou apenas uma atualização de status. Depois confira a credencial, o Phone Number ID e o campo usado como destinatário.
A mensagem fora do teste não é enviada
Para conversas iniciadas pela empresa fora da janela de atendimento, a plataforma exige um template aprovado. Não tente contornar isso com automação de WhatsApp Web: além de instável, esse caminho pode colocar o número em risco.
O workflow duplica respostas
Isso pode ocorrer quando o webhook é cadastrado mais de uma vez em ambientes diferentes ou quando o fluxo não diferencia mensagens de atualizações de status. Mantenha uma URL de produção ativa e filtre eventos antes do nó de envio.
Quanto custa criar esse chatbot?
O n8n pode ter custo de hospedagem ou assinatura, dependendo de onde você roda a ferramenta. A Meta também aplica regras de cobrança que dependem do tipo de mensagem, do país do destinatário, do template e da janela de atendimento. Na documentação consultada em 19 de agosto de 2026, mensagens não-template dentro da janela aberta de atendimento ao cliente não eram cobradas, enquanto templates enviados fora dessa janela seguiam a categoria e a tabela de preços correspondente.
A Meta informa que as tarifas variam por categoria e código de país e mantém uma tabela atualizada. Por isso, não use um preço antigo encontrado em tutorial como orçamento: consulte a página oficial antes de colocar a automação em produção, principalmente porque a documentação também registra mudanças de preços programadas para 2026.
WhatsApp Business comum ou API oficial?
O WhatsApp Business do celular é suficiente para respostas rápidas, catálogo e atendimento manual de uma operação pequena. Já a Cloud API faz sentido quando você precisa conectar o canal a CRM, planilha, help desk, agenda ou n8n.
A API cobra mais conhecimento técnico e exige cuidado com permissões, templates, consentimento e proteção de dados. Em troca, ela oferece um caminho oficial para automação. Se a necessidade é apenas responder “estamos abertos das 9h às 18h”, comece com respostas rápidas do aplicativo; não alugue um caminhão para transportar uma caixa.
Perguntas frequentes
Preciso programar para criar o chatbot no n8n?
Não para o fluxo básico. O n8n permite conectar o Trigger, as regras e o nó de envio visualmente. Você ainda precisa entender campos JSON, credenciais e webhooks, mas não precisa começar escrevendo uma API inteira.
Posso usar meu número pessoal do WhatsApp?
O tutorial usa a WhatsApp Business Platform e um número configurado para a conta da empresa. Verifique as regras atuais de migração e coexistência da Meta antes de tentar reaproveitar um número pessoal.
O chatbot pode responder qualquer pergunta?
O fluxo deste guia responde intenções definidas por regras. Para perguntas abertas, seria necessário adicionar uma base de conhecimento ou um modelo de IA, com revisão humana e limites para evitar respostas inventadas.
Preciso de um template para responder quem acabou de mandar mensagem?
Dentro da janela de atendimento aberta pela mensagem do usuário, você pode enviar mensagens não-template. Fora dessa janela, a plataforma exige um template aprovado para mensagens iniciadas pela empresa.
Resumo: comece com poucas intenções, teste o número da Meta, filtre eventos e só depois conecte CRM ou IA. Um chatbot pequeno que responde certo é mais útil do que um “agente” que promete atender tudo e encaminha ninguém.