Como criar um agente de IA para WhatsApp com Claude Code?
Para criar um agente de IA para WhatsApp com Claude Code, você conecta um número dedicado a uma API do WhatsApp, escolhe um modelo de linguagem (Gemini, OpenAI ou Anthropic) e pede ao Claude Code que monte o webhook, o prompt de atendimento e a regra de passagem para humano. Com roteiro guiado, o setup leva cerca de 15 minutos.
O Claude Code é a ferramenta de linha de comando da Anthropic que lê e edita os arquivos de um projeto a partir de instruções em português. Em vez de escrever o código do agente na mão, você descreve o que ele deve fazer: quais perguntas responder, como qualificar o lead, quando enviar o link de pagamento e em que momento chamar uma pessoa da equipe. O Claude Code gera a estrutura, testa e corrige.
Ele roda em macOS, Linux e Windows, então o sistema operacional não é barreira. O que realmente decide se o agente funciona é a qualidade das instruções e do conteúdo que você entrega a ele: a página de vendas, as dúvidas frequentes, as objeções reais dos seus clientes e as regras do seu negócio.
- Número dedicado ao atendimento, nunca o seu número pessoal.
- Uma API do WhatsApp para receber e enviar mensagens: a Evolution API (open-source) ou a API oficial do WhatsApp Business.
- Uma chave de modelo de IA: Google Gemini (que tem plano gratuito), OpenAI ou Anthropic.
- O Claude Code instalado no computador para montar, testar e ajustar o agente por instruções em linguagem natural.
- Conteúdo de base: página de vendas, perguntas frequentes e a regra de quando a conversa passa para um humano.
O que é um agente IA no WhatsApp (e o que ele não é)
Um agente de IA no WhatsApp lê a mensagem do cliente, entende a intenção em linguagem natural e decide o próximo passo. Isso é diferente do menu de botões (digite 1 para vendas) e das respostas automáticas fixas do WhatsApp Business, que só funcionam enquanto o cliente segue o roteiro previsto.
A diferença prática aparece quando alguém escreve algo inesperado: um menu trava ou repete as opções, enquanto o agente interpreta a pergunta, consulta o conteúdo que recebeu e responde. Ele também pode executar ações, como registrar o lead no CRM, verificar uma informação ou enviar o checkout quando o cliente demonstra que está pronto.
- O agente decide o próximo passo com base no contexto da conversa, não num fluxo de botões fixo.
- Ele não é um vendedor completo: lida mal com reclamações sensíveis, negociações complexas e casos fora da curva.
- Ele não substitui a equipe, mas filtra e qualifica para que o time humano fale só com quem está pronto.
- Ele erra quando o conteúdo de base está incompleto, por isso a revisão das conversas nas primeiras semanas é obrigatória.
Como o agente funciona por baixo dos panos
A arquitetura de um agente IA no WhatsApp tem quatro peças. O número é conectado a uma API; cada mensagem recebida dispara um webhook que entrega o texto ao seu backend; o backend envia esse texto ao modelo de linguagem junto com as instruções do agente e o histórico da conversa; e a resposta gerada volta ao WhatsApp pela mesma API.
O backend pode ser leve. Um Cloudflare Worker ou uma Supabase Edge Function resolve a maior parte dos casos com custo próximo de zero. As ferramentas extras, como buscar no CRM, consultar estoque ou marcar um horário no Google Calendar, entram como ações que o agente pode chamar quando a conversa pede.
- API do WhatsApp: recebe e envia as mensagens do número conectado.
- Webhook: avisa o seu backend sempre que chega uma mensagem nova.
- Modelo de linguagem: interpreta a mensagem e gera a resposta seguindo as instruções do agente.
- Ferramentas: ações que o agente pode executar, como registrar o lead ou enviar o link de pagamento.
- Fallback humano: regra que interrompe o agente e chama uma pessoa da equipe.
Passo a passo para colocar o agente no ar
O caminho mais curto é deixar o Claude Code conduzir a montagem. No kit Agente IA WhatsApp 15M com Claude Code, da ZX LAB, ele lê o conteúdo da sua página, gera o prompt de vendas e ativa um agente que responde leads 24 horas, qualifica pelo método BANT (orçamento, autoridade, necessidade e prazo) e envia o checkout. O setup leva cerca de 15 minutos e dispensa o n8n.
Se você preferir montar sem kit, a sequência é a mesma, só que com mais tentativa e erro, porque cada peça precisa ser configurada e testada por você. O ponto de atenção é o teste: nunca ligue o agente para todo o volume de mensagens no primeiro dia, e leia as primeiras conversas uma a uma.
- 1. Separe um número dedicado e conecte-o à API escolhida.
- 2. Peça ao Claude Code para criar o webhook que recebe as mensagens e o backend que chama o modelo de IA.
- 3. Entregue a página de vendas e as perguntas frequentes para que o prompt de atendimento seja gerado a partir do seu conteúdo real.
- 4. Defina a qualificação (por exemplo, BANT) e o momento exato de enviar o checkout ou chamar o vendedor.
- 5. Teste com uma fração do volume, leia as conversas e ajuste as instruções antes de liberar para todos.
Qual modelo de IA escolher: Gemini, OpenAI ou Anthropic
O agente funciona com qualquer um dos três provedores, e a escolha depende do momento do seu negócio. Não existe um vencedor absoluto: o que muda é o custo para começar, a qualidade das respostas no seu tipo de atendimento e a facilidade para testar antes de gastar com API.
Uma regra útil é começar pelo modelo que permite testar sem custo, medir a qualidade das respostas com conversas reais e só então decidir se vale migrar. Trocar o provedor depois é uma alteração de configuração, não uma reconstrução do agente, desde que as instruções estejam bem separadas do código.
- Custo para começar — Gemini: tem plano gratuito, ótimo para validar a ideia; OpenAI e Anthropic: cobram por uso desde a primeira mensagem.
- Qualidade de conversa — vale testar os três com as mesmas conversas reais: as diferenças aparecem em instruções longas e no tom em português, e só o seu teste mostra qual atende melhor o seu público.
- Volume alto — em todos os três o custo cresce com o tamanho das conversas, então instruções enxutas pesam mais do que o provedor escolhido.
- Troca de provedor — com o agente bem estruturado, mudar de modelo é trocar a chave e testar de novo, sem refazer o fluxo.
Erros comuns e o risco de banimento
O erro mais caro é usar o número pessoal ou o número principal da empresa para automação. O WhatsApp pode restringir ou banir números com comportamento que parece spam, e o risco cresce muito quando o número dispara mensagens em massa para pessoas que nunca falaram com você nem pediram contato.
Um agente que responde quem chegou por conta própria, vindo de anúncio, site ou Instagram, opera num cenário bem mais seguro do que uma ferramenta de disparo. O risco não é zero com uma API não oficial, mas ele se concentra no uso abusivo, e não no atendimento de quem pediu contato.
- Não use número pessoal: separe um número só para o agente.
- Evite disparo em massa não solicitado; foque em responder quem já te procurou (opt-in).
- Nunca rode sem fallback humano: defina gatilhos como frustração, pedido explícito ou palavra-chave.
- Não deixe o agente inventar preço ou condição: tudo que ele promete precisa estar no conteúdo de base.
- Revise as conversas toda semana no início; é ali que aparecem as perguntas que o prompt ainda não cobre.
Quanto custa, quanto tempo leva e quando não usar
A infraestrutura pode ter custo próximo de zero com Evolution API auto-hospedada e backend serverless. O gasto principal é o modelo de IA, que varia com o volume e o tamanho das conversas; com o Gemini gratuito, dá para validar sem gastar com a API. O tempo de setup guiado é de cerca de 15 minutos, mas o ajuste fino do prompt continua nas primeiras semanas.
Alunos da ZX LAB já aplicam o modelo 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 de IA que atende leads do site e de anúncio no Facebook e prospecta sozinho o nicho escolhido. São casos individuais, não promessa de resultado.
- Não vale a pena se você recebe poucas mensagens por semana e consegue responder todas rapidamente.
- Não use como substituto de atendimento em temas sensíveis, como saúde, jurídico ou reclamação formal, sem revisão humana.
- Não resolve oferta ruim: o agente acelera o atendimento, mas não decide preço, posicionamento nem estratégia comercial.
- Vale a pena quando leads de anúncio esfriam esperando resposta ou quando a equipe gasta o dia respondendo as mesmas perguntas.
😱 Agente de IA em 15 Minutos no WhatsApp com Claude Code
Na operação da ZX LAB, agentes de IA respondem os leads de tráfego pago no WhatsApp em segundos e só passam o contato para o vendedor quando a qualificação está completa; antes, o atendimento manual levava de horas a um dia útil. Rafael Castro, fundador da ZX LAB, usa o Claude Code para montar e ajustar esses agentes, e o mesmo método é ensinado aos mais de 15 mil alunos da escola.