Como criar um agente de IA?
Para criar um agente de IA, você define a tarefa que ele vai assumir, escolhe um modelo de linguagem (Gemini, OpenAI ou Anthropic), escreve as instruções com base no conteúdo real do negócio, conecta o canal de atendimento, como o WhatsApp, e testa antes de liberar. Com o Claude Code conduzindo a montagem, não é preciso programar.
O trabalho técnico, que inclui webhook, backend e integração com o canal, pode ficar com o Claude Code, a ferramenta da Anthropic que lê e edita arquivos a partir de instruções em português. Ele roda em Mac, Windows e Linux. O trabalho que continua sendo seu é o que define a qualidade do agente: dizer o que ele deve fazer, com que conteúdo e quando chamar uma pessoa.
Por isso, criar um agente de IA é menos um desafio de programação e mais um desafio de clareza. Quem conhece bem as perguntas dos clientes, as objeções comuns e as regras do negócio tem meio caminho andado. O resto é montagem, teste e ajuste. Com as instruções certas, o agente passa a responder como alguém da equipe que conhece bem o negócio.
- Uma tarefa bem definida: atender dúvidas, qualificar leads, agendar ou dar suporte inicial.
- Um modelo de linguagem: Google Gemini (com plano gratuito), OpenAI ou Anthropic.
- Conteúdo de base: página de vendas, perguntas frequentes, preços e políticas do negócio.
- Um canal: no WhatsApp, um número dedicado conectado a uma API.
- Uma regra de passagem para humano quando o agente não deve seguir sozinho.
Agente de IA versus chatbot de fluxo: qual a diferença
Um chatbot de fluxo segue um roteiro fixo de botões e palavras-chave. Funciona enquanto o cliente faz exatamente o que o roteiro prevê, e trava quando a pessoa escreve algo inesperado. Um agente de IA usa um modelo de linguagem para entender a intenção da mensagem e decidir o próximo passo, mesmo fora do roteiro.
Isso não torna o chatbot inútil. Para menus muito simples e previsíveis, ele é suficiente e não tem custo por mensagem. O agente faz diferença quando as perguntas variam, quando é preciso qualificar o cliente com uma conversa natural ou quando o atendimento precisa executar ações como registrar o lead ou enviar um link de pagamento.
- Entendimento — chatbot: palavras-chave e botões; agente: interpreta a intenção em linguagem natural.
- Mensagem inesperada — chatbot: repete opções ou trava; agente: consulta o conteúdo e responde.
- Custo — chatbot: geralmente fixo; agente: cresce com o volume e o tamanho das conversas.
- Onde o chatbot é melhor — menus curtos e previsíveis, em que a variação de perguntas é mínima.
- Ações — agente: pode registrar no CRM, verificar informação e enviar checkout no momento certo.
Os componentes de um agente de IA
Todo agente de IA no WhatsApp tem a mesma estrutura básica. O número é conectado a uma API, que recebe as mensagens. Cada mensagem dispara um webhook que leva o texto ao backend. O backend envia a mensagem ao modelo de linguagem com as instruções do agente e o histórico da conversa, e a resposta volta ao cliente pela mesma API.
O backend pode ser leve: um Cloudflare Worker ou uma Supabase Edge Function resolve a maior parte dos casos. As ações extras, como consultar o CRM ou marcar um horário, entram como ferramentas que o agente chama quando a conversa pede. Entender essas peças ajuda a diagnosticar problemas, mesmo que o Claude Code faça a montagem.
- API do WhatsApp: Evolution API (open-source) ou a API oficial do WhatsApp Business.
- Webhook: avisa o backend sempre que chega uma mensagem nova.
- Modelo de linguagem: interpreta a mensagem e gera a resposta seguindo as instruções.
- Ferramentas: ações como registrar o lead ou enviar o link de pagamento.
- Fallback humano: regra que interrompe o agente e chama uma pessoa.
Passo a passo para criar o agente com Claude Code
A sequência abaixo vale tanto para quem monta do zero quanto para quem usa um roteiro guiado. A diferença é a quantidade de tentativa e erro: com um kit preparado, o Claude Code já sabe a ordem das etapas e as configurações necessárias, e o setup leva cerca de 15 minutos. Sem kit, cada peça precisa ser configurada e testada por você.
Em qualquer caso, não ligue o agente para todo o volume de mensagens no primeiro dia. Comece com uma fração, leia as primeiras conversas uma a uma e ajuste as instruções. É nessa leitura que aparecem as perguntas que o conteúdo de base ainda não cobre. Ajustes feitos cedo evitam erros repetidos depois.
- 1. Separe um número dedicado e conecte-o à API do WhatsApp escolhida.
- 2. Peça ao Claude Code para criar o webhook e o backend que chama o modelo de IA.
- 3. Entregue a página de vendas e as perguntas frequentes para gerar o prompt a partir do seu conteúdo real.
- 4. Defina a qualificação, por exemplo pelo método BANT, e o momento de enviar o checkout ou chamar o vendedor.
- 5. Teste com uma fração do volume, leia as conversas e ajuste antes de liberar para todos.
Como escrever as instruções do agente
As instruções, também chamadas de prompt de sistema, são o que mais influencia a qualidade do agente. Elas dizem quem ele é, o que pode e não pode responder, qual tom usar e quando passar a conversa para uma pessoa. Instruções vagas geram respostas genéricas; instruções baseadas no conteúdo real do negócio geram respostas úteis.
Um cuidado importante é proibir o agente de inventar. Tudo que ele promete, como preço, prazo ou condição, precisa estar no conteúdo de base. Se a resposta não estiver lá, a instrução deve mandar o agente dizer que vai verificar e encaminhar para a equipe, em vez de improvisar. Isso protege a marca e o cliente.
- Defina o papel do agente e o objetivo da conversa em uma ou duas frases.
- Liste o que ele pode responder e o que deve sempre encaminhar.
- Proíba inventar preço, prazo ou condição fora do conteúdo de base.
- Descreva o tom de voz da marca com exemplos de resposta.
- Mantenha as instruções enxutas: prompt longo encarece cada mensagem sem melhorar a resposta.
Qual modelo de IA escolher para o agente
O agente pode funcionar com Gemini, OpenAI ou Anthropic, e nenhum vence em todos os cenários. O Gemini tem plano gratuito, o que facilita validar a ideia sem gastar. OpenAI e Anthropic cobram por uso desde a primeira mensagem. A qualidade em português e com instruções longas varia, e só o teste com conversas reais do seu público mostra qual atende melhor.
Uma regra prática é começar pelo modelo que permite testar sem custo, medir a qualidade com conversas reais e só então decidir se vale migrar. Com as instruções bem separadas do código, trocar de provedor é trocar a chave e testar de novo, sem reconstruir o agente. Registre os testes para comparar depois.
- Custo para começar — Gemini: plano gratuito; OpenAI e Anthropic: cobrança por uso.
- Qualidade — teste os três com as mesmas conversas reais antes de decidir.
- Volume alto — em todos, o custo cresce com o tamanho das conversas.
- Troca de provedor — com o agente bem estruturado, é uma mudança de configuração.
Erros comuns, custos e quando não criar um agente
O erro mais caro é usar o número pessoal ou o principal da empresa para automação. Disparo em massa para quem nunca pediu contato pode levar a restrições ou banimento do número. Um agente que responde quem chegou por conta própria, vindo de anúncio, site ou Instagram, opera num cenário bem mais seguro.
Alunos da ZX LAB já aplicam agentes em operações reais. Bruno A. colocou um agente de IA no WhatsApp qualificando leads para cliente do ramo imobiliário. Isac colocou no ar um agente que atende leads do site e de anúncio no Facebook. Thiago L. fechou o primeiro cliente, uma empresa de saúde e bem-estar, e implementou um agente de atendimento. São casos individuais, não promessa de resultado.
- Não use número pessoal: separe um número só para o agente.
- Nunca rode sem passagem para humano em casos de frustração ou pedido explícito.
- Acompanhe o custo do modelo, que cresce com o volume de mensagens.
- Não vale a pena se você recebe poucas mensagens e responde todas rapidamente.
- Não use sem revisão humana em temas sensíveis, como saúde, jurídico ou reclamação formal.
😱 Agente de IA em 15 Minutos no WhatsApp com Claude Code
Na ZX LAB, agentes de IA respondem leads no WhatsApp em segundos e só passam o contato para uma pessoa quando a qualificação está completa. Rafael Castro, fundador da ZX LAB, monta e ajusta esses agentes com o Claude Code, e o ajuste fino das respostas continua nas semanas seguintes ao setup. O mesmo método é ensinado aos mais de 15 mil alunos da escola.