# Como montar um agente de IA no WhatsApp com n8n, do webhook à resposta

> Um agente de IA no WhatsApp com n8n funciona assim: a mensagem chega por webhook, o nó de agente consulta o modelo de linguagem com memória e ferramentas, e a resposta volta pela API oficial. O CRM guarda o lead e o histórico. Este guia mostra a arquitetura, os oito passos, um prompt para copiar e os erros que mais derrubam o fluxo.

Página original: https://www.adprotecnologia.com.br/crm/blog/agente-de-ia-no-whatsapp-com-n8n
Autor: AD PRO Tecnologia. Publicado em 2026-10-24.

O n8n é um caminho comum para quem quer um agente de IA no WhatsApp sem escrever um sistema do zero: o fluxo é visual e a ligação com o CRM é feita por webhook e API. O que separa o agente que funciona na demonstração do que aguenta o atendimento são os detalhes de montagem, e é neles que este guia se concentra.

Duas páginas vizinhas respondem a outras perguntas. Para entender como o n8n se liga ao DataCrazy em geral, veja [integração do DataCrazy com o n8n](https://www.adprotecnologia.com.br/crm/integracao-datacrazy-n8n). Para decidir se a automação deve morar no CRM ou no n8n, veja [automação nativa ou n8n](https://www.adprotecnologia.com.br/crm/blog/automacao-nativa-ou-n8n). Aqui o assunto é construir o agente, peça por peça. O exemplo é a Clínica Alvorada, uma clínica de fisioterapia **fictícia**, que quer um agente para triagem e agendamento.

## Qual é a arquitetura de um agente de IA no WhatsApp com n8n?

A arquitetura tem sete peças: entrada da mensagem, tratamento, agente de IA, memória da conversa, ferramentas, resposta e registro no CRM. O n8n costura todas em um fluxo, e o modelo de linguagem fica dentro do nó do agente.

**As peças de um agente de IA no WhatsApp montado no n8n**

| Peça | O que faz | Como aparece no n8n |
| --- | --- | --- |
| Entrada | Recebe a mensagem do cliente assim que ela chega | Nó de Webhook, chamado pela plataforma que está conectada à API oficial do WhatsApp |
| Tratamento | Separa o texto, o telefone e o identificador da conversa; descarta o que não é mensagem do cliente | Nós de edição de campos e de condição |
| Agente de IA | Lê a mensagem, decide se responde ou usa uma ferramenta | Nó de agente, ligado a um modelo de linguagem e às instruções |
| Memória | Lembra o que já foi dito naquela conversa | Nó de memória, com uma chave por conversa |
| Ferramentas | Consultam agenda, estoque ou cadastro; criam ou atualizam o lead | Ferramentas do agente, em geral chamadas HTTP para APIs |
| Resposta | Envia o texto ao cliente | Chamada à API oficial do WhatsApp, pelo conector que a plataforma oferecer |
| Registro | Grava a conversa e o resultado no CRM | Chamada à API do CRM ou webhook de saída |

A documentação oficial do n8n descreve o nó de agente com ferramentas e explica como a memória funciona. Vale ler as duas antes de começar: nomes e opções dos nós mudam com as versões.

## Como montar o fluxo em oito passos?

Monte o fluxo na ordem em que a mensagem viaja, testando cada passo antes de seguir. O erro mais comum é conectar tudo de uma vez e não saber onde quebrou.

1. **Defina o escopo do agente.** Escreva em uma frase o que ele faz e o que não faz. Para a Clínica Alvorada: faz triagem por tipo de atendimento, oferece horários e coleta dados de contato; não opina sobre dor, diagnóstico ou tratamento.
2. **Crie o webhook de entrada.** No n8n, o nó de Webhook gera uma URL. Cadastre essa URL como destino das mensagens recebidas na plataforma que está ligada à API oficial do WhatsApp. Mande uma mensagem de teste e confira o que chega.
3. **Trate a mensagem.** Extraia o texto, o telefone e o identificador da conversa. Descarte o que não é mensagem do cliente, como o aviso de entrega de uma mensagem que o próprio robô mandou. Esse filtro evita o robô responder a si mesmo.
4. **Configure o agente e a memória.** Escolha o modelo de linguagem, cole as instruções do agente (há um modelo logo abaixo) e ligue a memória usando o telefone ou o identificador da conversa como chave. Sem essa chave, conversas de clientes diferentes se misturam.
5. **Adicione as ferramentas.** Uma ferramenta por tarefa: consultar horários, reservar horário, buscar o cadastro, criar ou atualizar o lead no CRM. Descreva cada uma em linguagem simples, dizendo quando usar, porque o agente decide pelo que lê.
6. **Envie a resposta.** Mande o texto do agente de volta pela API oficial do WhatsApp. Respeite a janela de 24 horas: fora dela, só modelo aprovado pela Meta.
7. **Registre no CRM.** Grave o lead, a etapa do funil, o resumo e o motivo da passagem para humano, se houver. No DataCrazy, a AD PRO monta essa ligação por webhook e API, e a equipe encontra tudo no lead.
8. **Trate o erro.** Se o modelo falhar, a ferramenta der erro ou o tempo estourar, o fluxo manda uma mensagem curta de contingência e passa a conversa para a fila de pessoas. Nunca deixe o cliente sem resposta.

## O que escrever nas instruções do agente?

As instruções devem dizer quem o agente é, o que ele pode fazer, o que nunca faz, quando chamar uma pessoa e em que formato responde. Instrução curta e objetiva funciona melhor do que um texto longo cheio de exceções.

**Instruções do agente (Clínica Alvorada, clínica fictícia)**

```text
PAPEL
Você é o assistente virtual da Clínica Alvorada no WhatsApp. Na primeira mensagem, diga que é um assistente automático e que a pessoa pode pedir um atendente a qualquer momento.

O QUE VOCÊ FAZ
- Descobre se a pessoa quer fisioterapia ortopédica, pilates clínico ou avaliação.
- Oferece até 3 horários livres usando a ferramenta consultar_horarios.
- Reserva o horário escolhido com a ferramenta reservar_horario e confirma com dia, hora e endereço.
- Registra nome e telefone com a ferramenta atualizar_lead.

O QUE VOCÊ NUNCA FAZ
- Não comenta sintoma, diagnóstico, tratamento nem resultado esperado.
- Não informa preço que não esteja na lista de valores aprovada.
- Não pede exame, laudo ou foto pelo chat.
- Não inventa horário: só oferece o que a ferramenta devolver.

QUANDO CHAMAR UMA PESSOA
- A pessoa pede atendente, reclama ou fala de urgência.
- Você não entendeu duas vezes seguidas.
- A pergunta foge do que está acima.
Nesses casos, use a ferramenta passar_para_humano e avise que a equipe responde em seguida.

COMO RESPONDER
Português do Brasil, frases curtas, uma pergunta por mensagem, sem emojis em excesso.
```

Para ir além desse modelo, com instruções por etapa do funil e exemplos de resposta, veja [prompt para atendimento no WhatsApp](https://www.adprotecnologia.com.br/crm/blog/prompt-para-atendimento-no-whatsapp). Os nomes das ferramentas acima são livres: cada fluxo define os seus.

## Como ligar o agente ao DataCrazy?

A ligação com o DataCrazy é feita por webhook e API, e é a AD PRO que monta. O DataCrazy conecta a API oficial do WhatsApp, recebe a conversa no multiatendimento, a AD PRO monta por webhook o caminho da mensagem até o n8n, e o agente responde e grava o resultado no lead pela API.

Pela página de planos, os webhooks existem em todos os planos, com quantidades diferentes (3 no Starter e 15 no Essential), e a API REST e o MCP Server aparecem na lista do Essential (site oficial em 20 de outubro de 2026). Se o agente vai criar ou atualizar lead por API, confira em [datacrazy.io/planos](https://www.adprotecnologia.com.br/ir/datacrazy?de=agente-de-ia-no-whatsapp-com-n8n&pos=texto&p=%2Fplanos) se o plano escolhido inclui a API REST. Os detalhes de API, webhook e MCP Server estão em [DataCrazy, API, webhook e MCP](https://www.adprotecnologia.com.br/crm/datacrazy-api-webhook-mcp).

> **Como a AD PRO monta isso:** A gente começa pelo funil e pelo que o agente deve devolver ao CRM: etapa, motivo, resumo e responsável. Só depois desenha o fluxo no n8n, com tratamento de erro, limite de tentativas e passagem para a equipe. O objetivo é o vendedor ou a recepção abrir o lead e saber o que aconteceu, sem ler a conversa inteira.

## Que regras do WhatsApp e da Meta o agente precisa seguir?

O agente precisa respeitar a janela de 24 horas, usar modelo aprovado para iniciar conversa, ter consentimento para mensagens de marketing e deixar claro que é automático. A política da Meta para IA também diferencia a IA da sua empresa atendendo seus clientes de um assistente de IA genérico oferecido ao público.

- **Janela de 24 horas e modelos:** veja [janela de 24 horas do WhatsApp](https://www.adprotecnologia.com.br/crm/blog/janela-de-24-horas-do-whatsapp) e [templates do WhatsApp API](https://www.adprotecnologia.com.br/crm/blog/templates-do-whatsapp-api).
- **Política de IA da Meta:** o texto [chatbot de IA no WhatsApp é permitido?](https://www.adprotecnologia.com.br/crm/blog/chatbot-de-ia-no-whatsapp-e-permitido) explica o que a Meta chama de provedor de IA e por que o atendimento da própria empresa é outro caso.
- **Consentimento:** veja [opt-in no WhatsApp](https://www.adprotecnologia.com.br/crm/blog/opt-in-whatsapp) antes de qualquer mensagem que a empresa inicia.
- **Saída para uma pessoa:** sempre disponível, em qualquer etapa.
- **Dados pessoais:** o modelo de linguagem recebe texto de clientes. Leia as condições do provedor e veja [IA e LGPD no atendimento](https://www.adprotecnologia.com.br/crm/blog/ia-e-lgpd-no-atendimento).

## Como testar o agente antes de ligar para clientes?

Teste com uma lista de situações escritas de antemão, rodando cada uma e anotando o resultado. O n8n mantém o histórico das execuções, o que facilita ver em que nó o fluxo errou. Só ligue para clientes quando passar nos casos difíceis, não só no caminho feliz.

1. Pergunta dentro do escopo, com erro de digitação e gíria.
2. Pergunta fora do escopo (preço de outro serviço, assunto pessoal).
3. Pedido de atendente na primeira e na quinta mensagem.
4. Cliente que muda de ideia no meio do agendamento.
5. Áudio, imagem ou documento no lugar de texto.
6. Falha forçada de uma ferramenta (agenda fora do ar) para ver a contingência.
7. Conversa de duas pessoas diferentes ao mesmo tempo, para conferir que a memória não mistura.

Uma lista mais completa está em [cenários de teste para agente de IA](https://www.adprotecnologia.com.br/crm/blog/cenarios-de-teste-para-agente-de-ia). Depois que o agente entra no ar, leia uma amostra das conversas toda semana.

## Quais erros derrubam um agente de IA montado no n8n?

Os erros mais frequentes são de fluxo, não de modelo: o robô responder a si mesmo, a memória misturar clientes, o mesmo evento chegar duas vezes e a ausência de plano B quando algo falha. Todos se evitam com desenho.

**Erros comuns e como evitar**

| Erro | Sintoma | Como evitar |
| --- | --- | --- |
| Robô responde a si mesmo | Mensagens em loop ou resposta a avisos de entrega | Filtre no começo do fluxo tudo o que não for mensagem de cliente |
| Memória sem chave por conversa | Cliente recebe resposta sobre assunto de outro | Use o telefone ou o identificador da conversa como chave |
| Evento duplicado | Mesma resposta enviada duas vezes | Registre o identificador da mensagem e ignore repetidos |
| Ferramenta sem descrição clara | Agente usa a ferramenta errada ou não usa nenhuma | Descreva quando usar cada uma, em linguagem simples |
| Sem tratamento de erro | Cliente fica sem resposta quando algo falha | Ramo de contingência que avisa e passa para a fila de pessoas |
| Credencial exposta | Chave de API num campo de texto do fluxo | Use a área de credenciais do n8n e limite quem tem acesso |
| Consumo sem limite | Conta de IA maior do que o esperado | Limite o tamanho da conversa na memória e monitore o consumo |

## Quem mantém o agente e o que entra no custo?

Entram no custo a hospedagem do n8n (em nuvem ou em servidor próprio), o modelo de IA, a API oficial do WhatsApp, o CRM e o tempo de alguém revisando o agente. A manutenção costuma ser a parte esquecida: preço muda, serviço novo entra e uma pergunta nova aparece.

Quem hospeda o n8n por conta própria assume atualização, backup e segurança do servidor. Condições e valores do n8n mudam, então confira no site oficial. A conta do agente como um todo está em [quanto custa implementar IA no atendimento](https://www.adprotecnologia.com.br/crm/quanto-custa-implementar-ia), e o que a AD PRO entrega em [agente de IA no WhatsApp](https://www.adprotecnologia.com.br/crm/agente-de-ia-no-whatsapp).

## Quando não vale montar o agente no n8n?

Não vale quando a necessidade cabe em automação por etapa do próprio CRM: boas-vindas, distribuição de lead, lembrete e mudança de etapa. Menos peças, menos pontos de falha. O n8n compensa quando o agente precisa consultar sistemas de fora ou fazer um fluxo que o CRM não faz sozinho.

O DataCrazy traz automação por etapa e a Crazy IA nos fluxos, e muitas empresas resolvem a primeira fase só com isso. A [comparação de quando usar cada um](https://www.adprotecnologia.com.br/crm/blog/automacao-nativa-ou-n8n) ajuda a decidir, e a [visão geral de automações do DataCrazy](https://www.adprotecnologia.com.br/crm/datacrazy-automacoes) mostra o que já vem pronto.

## Perguntas frequentes

### Dá para fazer um agente de IA no WhatsApp com n8n?

Dá. O desenho usual é um webhook que recebe a mensagem, um nó de agente com modelo de linguagem, memória e ferramentas, e uma chamada à API oficial do WhatsApp para responder. O CRM entra para guardar o lead e o histórico.

### Preciso saber programar para usar o n8n?

O fluxo é visual e muita coisa se faz sem código. Para ligar sistemas por API, tratar erros e depurar execuções, ajuda ter alguém com base técnica, e é esse trabalho que a AD PRO assume na implementação.

### O n8n é gratuito?

Existem formas de instalar e de usar na nuvem, e as condições e os preços variam e mudam. Confira no site oficial do n8n antes de decidir, e some a hospedagem, o modelo de IA e a API do WhatsApp na conta.

### O agente funciona com o aplicativo WhatsApp Business?

Um agente que conversa e consulta ferramentas usa a API oficial do WhatsApp, que o DataCrazy conecta. O aplicativo no celular tem respostas automáticas simples, mas não recebe webhook nem conversa com sistemas.

### Como o agente passa a conversa para uma pessoa?

Por uma ferramenta de passagem: ela marca a conversa, avisa a equipe e para as respostas do robô. No DataCrazy, a conversa cai na fila do multiatendimento com o resumo gravado no lead.

### Qual modelo de IA usar no agente?

Depende do tipo de conversa, do custo por uso e das condições de tratamento de dados do provedor. Comece por um modelo que resolva o escopo com respostas curtas, meça o consumo e troque só se o resultado pedir.

## Fontes

- [n8n, documentação do nó de agente com ferramentas](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/tools-agent), conferido em 2026-10-24
- [n8n, documentação sobre como a memória funciona](https://docs.n8n.io/build/integrate-ai/understand-ai-components/how-memory-works), conferido em 2026-10-24
- [DataCrazy, planos e valores (lidos em 20/10/2026)](/ir/datacrazy?de=agente-de-ia-no-whatsapp-com-n8n&pos=texto&p=%2Fplanos), conferido em 2026-10-24
- [DataCrazy, página inicial](/ir/datacrazy?de=agente-de-ia-no-whatsapp-com-n8n&pos=texto), conferido em 2026-10-24
- [Meta for Developers, preços da WhatsApp Business Platform](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing), conferido em 2026-10-24

---

AD PRO Tecnologia LTDA, CNPJ 68.425.611/0001-15, São Paulo/SP. Atendimento on-line para todo o Brasil. Diagnóstico comercial gratuito de 30 minutos: https://www.adprotecnologia.com.br/#agendar. WhatsApp +55 11 98604-5939. Fatos e preços publicados: https://www.adprotecnologia.com.br/fatos