Conecte um agente de atendimento ao WhatsApp

O atendimento usa dois Nodes oficiais: WhatsApp Trigger recebe eventos e WhatsApp Business Cloud envia mensagens. Entre eles, você conecta o AI Agent com modelo de chat e ferramentas. Comece com texto. Áudio, imagens e documentos exigem preparar o conteúdo antes do agente.

Configure as credenciais corretas

A documentação do n8n exige acesso de desenvolvedor da Meta, portfólio empresarial e aplicativo com WhatsApp configurado. Os dois Nodes usam autenticações diferentes:

Node	Credencial	Campos documentados
WhatsApp Trigger	OAuth2	Client ID e Client Secret
WhatsApp Business Cloud	API key	Access Token e Business Account ID

No aplicativo Meta, App settings > Basic fornece o identificador e o segredo usados pelo trigger. WhatsApp > API Setup fornece o token e o identificador empresarial para envio. Siga a página oficial de credenciais para os requisitos de publicação do aplicativo.

Monte o atendimento com texto

Adicione WhatsApp Trigger e selecione o evento Messages. Faça chegar uma mensagem de exercício e examine o JSON recebido. Use os campos reais da execução para identificar texto e remetente, sem presumir que todo evento contém uma mensagem textual.

Conecte o agente. Em Prompt, escolha Define below e preencha Prompt (User Message) com a expressão para o texto recebido. Configure System Message para delimitar o assunto do atendimento e conecte as ferramentas necessárias.

Depois do agente, adicione WhatsApp Business Cloud com Message > Send. Configure o remetente empresarial, mapeie o destinatário a partir da mensagem original e use a resposta do agente como texto. O destinatário vem do evento recebido, sem preenchimento pelo modelo.

Teste recebimento e resposta

Envie uma mensagem real para o número configurado. Confira o trigger, o texto recebido pelo agente e o retorno do envio. Se o trigger não iniciar, verifique também a assinatura do aplicativo na WABA: publicar o workflow registra o webhook, mas não faz essa assinatura.

A Meta permite um webhook por aplicativo. Alternar teste e produção substitui a URL registrada. Use um aplicativo separado para o exercício se o aplicativo atual atende tráfego real.

Memória por conversa

Para continuar o assunto entre mensagens, conecte uma memória ao agente e use uma chave que identifique cada conversa. Não reutilize uma chave fixa para todos os remetentes. Valide duas conversas separadas antes de ampliar o atendimento.