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

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. Para decidir se a automação deve morar no CRM ou no n8n, veja automação 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.

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. 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. 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. 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. 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. 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. 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. 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. 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.

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. 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 se o plano escolhido inclui a API REST. Os detalhes de API, webhook e MCP Server estão em DataCrazy, API, webhook e MCP.

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 e templates do WhatsApp API.
• Política de IA da Meta: o texto chatbot de IA no WhatsApp é 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 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.

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. 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.

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, e o que a AD PRO entrega em 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 ajuda a decidir, e a visão geral de automações do DataCrazy mostra o que já vem pronto.