Como monto um bot de atendimento no WhatsApp com o n8n?

Como funciona

1. Chega o webhook do Connect
2. Assinatura e token
3. Já processei?
4. Estado do contato
5. Decidir
6. IA · pessoa · horário · mídia · descadastro
7. POST /v1/messages

E à parte: message.echo (você respondeu pelo celular) → o bot fica quieto nessa conversa · message.status com falha → registro e aviso, sem nova tentativa.

O que ele faz, um por um

• Confere que a mensagem vem do Connect: o token do cabeçalho (o n8n confere antes de rodar qualquer coisa) e a assinatura HMAC X-Connect-Signature-256 sobre timestamp.corpo, com 5 minutos de tolerância. Uma assinatura errada recebe 401.
• Nunca responde duas vezes. O Connect tenta de novo se não recebe 2xx, e a Meta às vezes reentrega a mesma mensagem (o Connect a reenvia com outro id de evento mas o mesmo id do WhatsApp). O workflow anota o id do WhatsApp e ainda manda um Idempotency-Key ligado a ele: mesmo que algo se repita, o Connect não manda outra resposta.
• Responde com IA lendo as instruções do seu negócio (o que vende, horários, tom) de um campo só, com memória por contato. O modelo é um nó separado: vem a OpenAI e há um de Claude pronto para trocar.
• Passa para uma pessoa se o cliente pede ou se a IA não sabe (ela responde uma marca que o cliente nunca vê): diz que alguém vai atender, avisa você e fica quieto nessa conversa pelas horas que você escolher.
• 🔑 Se você responde pelo celular, o bot fica quieto nessa conversa pelo tempo que escolher. É o que a convivência permite: o Connect manda message.echo com o que você escreveu no app. Quando o bot volta, a IA sabe o que você disse.
• Horário de atendimento: fora do horário manda uma mensagem e nada mais (não repete a cada mensagem).
• Áudio, imagem, vídeo, figurinha, localização: uma resposta honesta («só leio texto, pode escrever?»), não silêncio.
• Descadastro: se escrevem «baja» ou «stop», confirma uma vez e não escreve mais; «alta» ou «start» traz de volta.
• Erros: se o Connect rejeita um envio (chave errada, teste vencido, número desconectado, cota) ou a Meta rejeita depois (por exemplo a janela de 24 h), fica anotado numa tabela e você recebe um aviso. Nunca tenta de novo, e um aviso que falha não gera outro aviso: não há loop possível.

Baixe

Baixar o workflow (JSON)

Colocar para rodar em 5 passos

1. Importe. No n8n: Workflows → ⋮ → Import from File e escolha o JSON. Aperte ▶ no nó Run once: create tables (cria as 3 tabelas que ele usa: duplicados, contatos, erros).
2. Credenciais (o workflow não traz nenhum segredo): Connect webhook token — tipo *Header Auth*, Name X-Connect-Token, Value o seu token wct_…; Connect API key — *Header Auth*, Name Authorization, Value Bearer wc_live_… (no painel: API → Criar API key); OpenAI (ou Anthropic); e SMTP se quiser os avisos por e-mail.
3. Config. Abra o nó Config e escreva o seu negócio em businessInstructions, o horário em openingHours, o seu e-mail em ownerEmail. Para conferir a assinatura, cole o seu whsec_… em signingSecret.
4. Ative (o interruptor de cima) e copie a Production URL do nó Connect webhook. ⚠ A de teste (Test URL) escuta uma vez só.
5. No Connect → Webhooks → Adicionar endpoint: essa URL, eventos message.received, message.echo e message.status, e gere o token estático. Aperte Testar: tem que dar 200. Depois mande um WhatsApp de outro telefone.

O nó de WhatsApp que o n8n já traz não basta?

O n8n traz o próprio nó de WhatsApp, que fala direto com a Meta. Muitas vezes basta, e é grátis: se você já tem um app da Meta, o seu número está na Cloud API e você não usa o app WhatsApp Business no telefone, use esse.

O que muda com o Connect, sem rodeios (o que dizemos do nó do n8n sai do código dele, versão 2.40.7):

Se nada da coluna da direita faz falta, fique com o nó do n8n. O workflow serve de exemplo do mesmo jeito: as ideias (anotar o id do WhatsApp, responder 200 antes da IA, não mandar texto livre fora das 24 h, não tentar de novo às cegas) valem para qualquer provedor.

O que convém saber antes

• Precisa de um n8n com Data tables (testamos no 2.40.7). É onde ficam os duplicados, o estado de cada contato e os erros; você os vê em Data tables.
• A memória da IA vive no n8n: se apaga quando o n8n reinicia e não funciona em modo fila (queue mode). Para algo durável, troque o nó de memória pelo de Postgres ou Redis com a mesma chave.
• O segredo de assinatura fica dentro do workflow (nó Config): o n8n não deixa um nó ler uma credencial. Se exportar ou compartilhar o workflow, apague antes. O token do cabeçalho e a API key ficam em credenciais.
• O nó Code do n8n não pode usar crypto numa instalação própria (vem proibido por padrão): por isso a assinatura é calculada com o nó Crypto.
• O aviso no seu WhatsApp vai por template, nunca como texto livre: fora da janela de 24 h a Meta rejeita. Sem um template aprovado, use o e-mail.
• As mensagens automáticas do app (boas-vindas, ausência) também saem do telefone. Não conseguimos medir: se estiverem ativas, podem contar como resposta sua e calar o bot.
• A partir de 1º de outubro de 2026 a Meta cobra também as respostas dentro da janela de 24 h, por mensagem. Cada resposta do bot tem esse custo da Meta; o Connect não soma nada.

O seu bot vive numa planilha do Google?

Se você não usa o n8n e montou o bot numa planilha, tem o guia com o Google Sheets. A forma exata de cada evento está em Receber o webhook (em inglês).

Fontes (consultadas em 29/09/2026)

• n8n: o gatilho de WhatsApp
• n8n: o nó de WhatsApp
• n8n: módulos permitidos no nó Code (NODE_FUNCTION_ALLOW_BUILTIN)
• n8n: Data tables
• n8n: Simple Memory e o modo fila