Como colocar IA no WhatsApp?
Para colocar IA no WhatsApp, você conecta um número dedicado a uma API do WhatsApp, liga essa API a um modelo de IA (Gemini, OpenAI ou Anthropic) por um webhook e escreve as instruções do agente, incluindo quando passar a conversa para uma pessoa. Com o Claude Code conduzindo o setup, a parte técnica fica acessível sem programar.
Existem jeitos mais simples e mais completos de fazer isso. As respostas automáticas do aplicativo WhatsApp Business resolvem saudação e ausência, mas não entendem perguntas abertas. Um agente de IA de verdade lê a mensagem, interpreta a intenção, consulta o conteúdo do seu negócio e responde, podendo também qualificar o lead e enviar o link de pagamento.
Este guia mostra o que você precisa antes de começar, os caminhos possíveis comparados pelos mesmos critérios, o passo a passo com Claude Code, o que a IA resolve bem e os erros que levam a bloqueio de número. A ideia é que, ao final, você saiba qual caminho combina com o tamanho do seu negócio e o que fazer em cada etapa.
- Número de WhatsApp dedicado ao atendimento, separado do seu número pessoal.
- Uma API do WhatsApp: a Evolution API, que é open-source, ou a API oficial do WhatsApp Business.
- Uma chave de modelo de IA: Google Gemini, que tem plano gratuito, OpenAI ou Anthropic.
- Conteúdo de base: página de vendas, perguntas frequentes e regras de atendimento.
O que você precisa preparar antes de começar
A parte técnica é a mais rápida. O que define se a IA vai atender bem é a preparação: um número separado, um conteúdo de base completo e regras claras. Usar o número pessoal ou o principal da empresa é o erro que mais custa caro, porque um bloqueio derruba junto todos os seus contatos.
O conteúdo de base é o que a IA vai usar para responder. Junte a página de vendas, as perguntas que os clientes mais fazem, as objeções reais, os horários, as políticas de troca ou reembolso e os casos em que a conversa precisa ir para uma pessoa. Quanto mais completo esse material, menos a IA improvisa.
- Separe um chip ou número só para o agente de IA.
- Liste as 20 perguntas mais frequentes que chegam hoje pelo WhatsApp, com as respostas certas.
- Escreva o que a IA não pode prometer, como descontos, prazos especiais ou condições fora da política.
- Defina quem da equipe recebe a conversa quando a IA passar o atendimento.
Três caminhos para colocar IA no WhatsApp: comparativo
Há basicamente três caminhos, e cada um faz sentido em um momento. As respostas automáticas do WhatsApp Business são gratuitas e simples, mas não são IA. Plataformas prontas de chatbot entregam uma interface visual e suporte, em troca de mensalidade e de menos controle. O agente próprio, montado com uma API e um modelo de IA, dá controle total e custo baixo, mas exige configuração.
Nenhum caminho é o melhor para todos. Quem recebe poucas mensagens pode ficar nas respostas automáticas. Quem quer algo pronto e não se importa com mensalidade pode preferir uma plataforma. Quem quer um agente com a cara do negócio, que qualifica e envia checkout, e prefere não depender de ferramenta de terceiros, tende ao agente próprio.
- Entende perguntas abertas — respostas automáticas: não; plataforma pronta: depende do plano e da ferramenta; agente próprio: sim, via modelo de IA.
- Custo — respostas automáticas: gratuito; plataforma pronta: mensalidade; agente próprio: infraestrutura baixa mais uso do modelo de IA.
- Controle e personalização — respostas automáticas: mínimo; plataforma pronta: limitado ao que a ferramenta oferece; agente próprio: total.
- Esforço de setup — respostas automáticas: minutos; plataforma pronta: aprender a ferramenta; agente próprio: configuração técnica, bem mais simples com o Claude Code.
Passo a passo para colocar a IA atendendo com Claude Code
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. Ele roda em macOS, Windows e Linux. No caso do WhatsApp, ele monta o webhook que recebe as mensagens, conecta o modelo de IA, escreve o prompt de atendimento com base no seu conteúdo e testa o fluxo de ponta a ponta.
Depois que o agente está no ar, ele fica hospedado num backend, como um Cloudflare Worker ou uma Supabase Edge Function, e continua respondendo mesmo com o seu computador desligado. O trabalho das primeiras semanas passa a ser revisar as conversas e ajustar o prompt. Anote as perguntas que o agente não soube responder e acrescente as respostas ao conteúdo de base a cada semana.
- 1. Conecte o número dedicado à API do WhatsApp, por exemplo lendo o QR Code na Evolution API.
- 2. Peça ao Claude Code para criar o webhook que recebe as mensagens e as envia ao modelo de IA.
- 3. Entregue o conteúdo de base e peça um prompt com tom de voz, limites e objetivo da conversa.
- 4. Defina a regra de passagem para humano: reclamação, negociação, pedido explícito ou pergunta fora do escopo.
- 5. Teste com mensagens reais e inesperadas antes de divulgar o número.
O que a IA resolve bem no WhatsApp (e o que não resolve)
A IA brilha em perguntas repetitivas e no primeiro contato. Ela responde em segundos a qualquer hora, atende várias conversas ao mesmo tempo e não deixa o lead de anúncio esfriando à espera de alguém disponível. Também consegue qualificar o interesse com perguntas simples e enviar o link de pagamento quando o cliente está pronto.
Ela não substitui o humano em negociação, reclamação grave ou situações que exigem julgamento caso a caso. E não é ligar e esquecer: perguntas novas aparecem toda semana, o conteúdo muda e o prompt precisa acompanhar. Alunos da ZX LAB usam o modelo em operações reais: Bruno A. colocou um agente qualificando leads para um cliente do ramo imobiliário. É um caso individual, não promessa de resultado.
- Resolve bem: preço, como funciona, horários, status e dúvidas frequentes.
- Resolve bem: qualificação inicial do lead e envio do checkout no momento certo.
- Não resolve: negociação, reclamação formal e decisões que dependem de exceção.
- Não resolve: oferta ruim; a IA acelera o atendimento, mas não muda o que você vende.
Erros comuns e o risco de banimento
O WhatsApp pode restringir ou banir números com comportamento que parece spam. O risco cresce muito quando o número dispara mensagens em massa para pessoas que nunca falaram com você. Um agente que só responde quem chegou por conta própria, vindo de anúncio, site ou Instagram, opera num cenário bem mais seguro.
O segundo grupo de erros é de experiência do cliente: esconder que é um atendimento automatizado, deixar a pessoa presa sem opção de falar com alguém e guardar histórico de conversa sem cuidado com dados pessoais. Todos são fáceis de evitar quando estão no roteiro desde o primeiro dia. Anunciar logo na primeira mensagem que é um assistente virtual, e como falar com alguém, já resolve boa parte deles.
- Usar o número pessoal ou o principal da empresa para automação.
- Fazer disparo em massa para quem não pediu contato.
- Não oferecer caminho claro para falar com uma pessoa.
- Ignorar a LGPD ao armazenar histórico e dados pessoais das conversas.
Quanto custa e quanto tempo leva
A infraestrutura pode ter custo próximo de zero com a Evolution API auto-hospedada e um backend serverless. O gasto principal é o modelo de IA, que varia com o volume e o tamanho das conversas; com o plano gratuito do Gemini, dá para validar o agente antes de pagar por API. A API oficial do WhatsApp Business tem cobrança própria da Meta, que vale consultar na tabela oficial.
Com um roteiro guiado, o setup técnico leva cerca de 15 minutos. O ajuste fino do prompt continua nas primeiras semanas, conforme aparecem perguntas que o conteúdo de base ainda não cobre. Esse tempo de revisão é o que separa um agente que ajuda de um que atrapalha. Reserve alguns minutos por semana para essa revisão.
- Infraestrutura: próxima de zero com Evolution API e backend serverless.
- Modelo de IA: custo por uso, com opção gratuita do Gemini para começar.
- Setup guiado: cerca de 15 minutos com o Claude Code conduzindo.
- Ajuste fino: revisão semanal das conversas nas primeiras semanas.
😱 Agente de IA em 15 Minutos no WhatsApp com Claude Code
Na ZX LAB, o primeiro contato de quem chega pelo WhatsApp é feito por um agente de IA: ele responde as dúvidas frequentes, qualifica o interesse na hora e passa a conversa para o time humano quando o assunto sai do padrão ou envolve negociação. Rafael Castro, fundador da ZX LAB, monta e ajusta esses agentes com o Claude Code e ensina o método aos mais de 15 mil alunos da escola.