Como criar um chatbot de WhatsApp com IA usando n8n e Z-API

1. 1. Crie a instância na Z-API e conecte o número

   Crie uma conta na Z-API, gere uma instância e escaneie o QR Code com o WhatsApp do número que vai atender — o mesmo gesto de conectar o WhatsApp Web. Use um número dedicado ao atendimento, nunca o seu pessoal: se algo der errado, o bloqueio cai no número conectado. A instância gera um ID e um token, que são as credenciais de todas as chamadas seguintes. O teste grátis dura 3 dias, suficiente para validar o fluxo inteiro antes de pagar.

2. 2. Crie o Webhook no n8n e cadastre na Z-API

   Num workflow novo do n8n, adicione um nó Webhook com método POST e copie a URL de produção. No painel da Z-API, cole essa URL no campo de webhook 'Ao receber' ('on-message-received'). A partir daí, toda mensagem que chegar no número conectado vira uma chamada HTTP para o seu fluxo, com telefone do remetente, nome e texto no corpo do payload. Detalhe que trava muita gente: o n8n precisa estar numa URL pública (cloud ou VPS com domínio) — rodando só no seu computador, a Z-API não tem como te encontrar.

3. 3. Filtre o que não deve acionar o bot

   Antes da IA, coloque um nó IF ou Filter. Ignore mensagens enviadas por você mesmo (o payload traz o campo fromMe), mensagens de grupos (se o bot for de atendimento individual) e tipos que o fluxo ainda não trata, como áudio e figurinha. Esse filtro barato evita duas dores clássicas: o bot respondendo a si mesmo em loop e chamadas desnecessárias à API do modelo — que é onde mora o custo variável do projeto.

4. 4. Configure o nó AI Agent com modelo e prompt

   Adicione o nó AI Agent e passe o texto da mensagem como entrada. No slot de modelo, conecte um chat model — OpenAI, Anthropic ou Gemini, o que sua conta tiver — com a credencial da API. O comportamento do bot vive no system prompt: diga quem ele é, o que a empresa faz, o tom de voz, o que ele pode e o que não pode responder, e o que fazer quando não souber (encaminhar para humano, nunca inventar). Prompt vago gera bot que fala bonito e erra preço; seja específico.

5. 5. Adicione memória com o telefone como sessão

   Conecte o sub-nó Simple Memory ao AI Agent usando o número de telefone do cliente como chave de sessão. É isso que transforma respostas soltas em conversa: o cliente diz o nome na primeira mensagem e o bot ainda sabe na quinta. O Simple Memory guarda o histórico na própria instância do n8n e atende bem para começar; operação com volume alto ou vários workers costuma migrar para memória em Redis ou Postgres depois.

6. 6. Devolva a resposta pelo send-text da Z-API

   Depois do AI Agent, adicione um nó HTTP Request com POST para o endpoint send-text da sua instância (a URL leva o ID da instância e o token; o header leva o Client-Token da conta). No corpo, envie phone com o número do remetente e message com a saída do agente. Um truque que muda a percepção do cliente: chame antes o endpoint de 'digitando...' ou adicione um Wait de 2 a 4 segundos — resposta instantânea demais entrega que é robô e soa fria.

7. 7. Teste, acompanhe e só depois amplie

   Mande mensagens reais de outro número: pergunta comum, pergunta fora do escopo, gíria, mensagem picada em três balões. Acompanhe as execuções pelo log do n8n e ajuste o prompt onde o bot escorregar — é normal reescrever o system prompt cinco vezes na primeira semana. Só depois de estável vale ampliar: conectar uma ferramenta de agenda, consultar pedidos por HTTP Request ou transferir para atendente humano quando o cliente pedir.

Z-API é não oficial: o que isso significa na prática

A Z-API conecta um número comum de WhatsApp por QR Code, sem passar pela aprovação da Meta. É o que torna o setup rápido — em meia hora o número está respondendo — e é também o risco do modelo: por não ser a API oficial, um número que dispara mensagem em massa para quem nunca conversou com ele pode ser bloqueado pelo WhatsApp. Para chatbot de atendimento, que só responde quem chama primeiro, o risco é baixo; para disparo frio, é alto e não vale o número.

A alternativa é a API oficial do WhatsApp Business (via Meta ou provedores como Twilio), que exige empresa verificada, cobra por conversa e não usa QR Code. Compensa quando o volume é grande ou quando a operação não pode, em hipótese alguma, perder o número. Para começar um bot de atendimento de pequena empresa, a via não oficial segue sendo o caminho de menor atrito — sabendo do trade-off.

Quanto custa manter esse bot rodando

O custo tem três partes, e só uma delas é fixa de verdade:

AI Agent vs fluxo de botões: qual chatbot você está construindo?

Vale separar duas coisas que o mercado chama igualmente de 'chatbot'. O fluxo de botões (digite 1 para financeiro, 2 para vendas) é um menu: previsível, barato, e frustrante quando o cliente foge do script. O agente de IA que este guia monta é outra categoria: ele lê a pergunta em linguagem natural, consulta o contexto da conversa e responde como um atendente treinado responderia.

O nó AI Agent do n8n é o que torna isso montável sem programar: ele orquestra o modelo de linguagem, a memória e as ferramentas num único ponto do fluxo. Quem quiser entender o conceito antes de pôr a mão na massa pode começar pelo nosso guia de como criar um agente de IA no n8n sem programar; a lógica é a mesma, o WhatsApp entra aqui só como canal de entrada e saída.

Os três erros que mais derrubam esse fluxo

Primeiro: webhook que não dispara. Em nove de dez casos é URL errada no painel da Z-API ou n8n rodando em localhost sem exposição pública. Se a sua instância ainda está no notebook, o passo zero é subir o n8n numa VPS — o processo completo está no nosso guia de instalação do n8n em VPS.

Segundo: bot sem memória. O AI Agent sem sub-nó de memória trata cada mensagem como a primeira da vida, e conversa de WhatsApp é picada por natureza — o cliente manda 'quanto custa?' e três segundos depois 'e o prazo?'. Sem sessão por telefone, a segunda pergunta chega órfã.

Terceiro: deixar a IA responder tudo. Preço, prazo e política de troca devem vir de fonte estruturada (planilha, API do sistema) via ferramenta conectada ao agente, não da 'cabeça' do modelo. O system prompt deve proibir explicitamente inventar valores e mandar transferir para humano em caso de dúvida — um bot que erra preço custa mais caro do que não ter bot.

Perguntas frequentes

Leia também

Guia

Como automatizar respostas no WhatsApp com n8n (passo a passo)

Como automatizar o WhatsApp com n8n e a Evolution API: receber a mensagem por webhook, responder sozinho e plugar IA. Passo a passo em português, sem tomar ban e sem custo de API oficial.

Ler →

Guia

Como criar um agente de IA com n8n sem saber programar

Crie um agente de IA com n8n sem escrever código: conecte a OpenAI, dê memória de conversa ao nó AI Agent, ligue ferramentas e coloque no WhatsApp. Passo a passo em português, do zero.

Ler →

Guia

Como instalar n8n em VPS no Brasil (guia completo com custos reais)

Guia passo a passo para instalar n8n self-hosted em VPS no Brasil. Inclui custos reais em reais, comparativo de providers, configuração com Docker e HTTPS.

Ler →

Guia

Como automatizar follow-up de leads no WhatsApp com n8n

Crie uma régua de follow-up automática no WhatsApp com n8n: mensagens personalizadas por etapa do funil, intervalos configuráveis, integração com o CRM e parada quando o lead responde.

Ler →

Glossário

Webhook

Entenda o que é webhook, como funciona na prática e como usar no n8n e Make para criar automações em tempo real sem precisar saber programar.

Ler →