Como criar um bot no WhatsApp?
Para criar um bot no WhatsApp, conecte um número dedicado a uma API, como a oficial do WhatsApp Business ou a Evolution API, ligue essa conexão a um backend que recebe as mensagens e use um modelo de IA para gerar as respostas. Com o Claude Code montando as peças, o setup guiado leva cerca de 15 minutos.
Existem dois grandes tipos de bot. O bot de menu segue um fluxo fixo de opções, como digite 1 para vendas, e funciona enquanto o cliente obedece ao roteiro. O bot com IA, também chamado de agente, interpreta a mensagem escrita do jeito do cliente e decide a resposta com base no conteúdo que você forneceu. Para atendimento e vendas, o segundo costuma oferecer uma experiência muito melhor.
O Claude Code é a ferramenta da Anthropic que cria e edita projetos a partir de instruções em português. Ele roda em Mac, Windows e Linux e permite montar o bot sem escrever o código à mão: você descreve o comportamento e ele gera, testa e corrige a estrutura. O bot não depende do seu computador ligado.
- Um número de WhatsApp dedicado ao bot, nunca o seu número pessoal.
- Uma API do WhatsApp: a oficial do WhatsApp Business ou a Evolution API, que é open-source.
- Um backend leve que recebe as mensagens, como um Cloudflare Worker ou uma Supabase Edge Function.
- Uma chave de modelo de IA: Google Gemini, que tem plano gratuito, OpenAI ou Anthropic.
- Conteúdo de base e a regra de quando a conversa passa para uma pessoa.
Bot de menu ou bot com IA: qual escolher
O bot de menu é previsível e fácil de entender: cada opção leva a uma resposta ou a outro menu. Ele funciona bem em processos rígidos, como segunda via de boleto ou consulta de status com número de pedido. O problema aparece quando o cliente escreve uma pergunta em vez de escolher uma opção, e o bot repete o menu ou trava.
O bot com IA entende linguagem natural, responde perguntas variadas e pode executar ações, como registrar o lead no CRM ou enviar um link de pagamento. Em troca, exige um conteúdo de base bem feito, regras claras e revisão das conversas, porque pode errar quando falta informação. Para a maioria dos negócios, essa troca compensa.
- Compreensão — menu: só reconhece as opções; IA: entende texto livre e variações de linguagem.
- Previsibilidade — menu: total; IA: alta quando as instruções e o conteúdo estão bem definidos.
- Manutenção — menu: redesenhar fluxos a cada mudança; IA: atualizar o conteúdo de base.
- Melhor uso — menu: processos rígidos e curtos; IA: atendimento, dúvidas variadas e qualificação de leads.
Comparativo das formas de conectar o número
A conexão do número define boa parte do custo, da estabilidade e do risco do bot. A API oficial do WhatsApp Business, mantida pela Meta, exige cadastro da empresa e segue regras mais rígidas, especialmente para mensagens iniciadas pela empresa. A Evolution API é open-source, conecta por QR Code e é mais rápida de configurar, mas não é homologada pela Meta.
Existem ainda plataformas sem código que oferecem construtores visuais de fluxo, às vezes integradas com ferramentas como o n8n. Elas reduzem a parte técnica, mas exigem configurar cada gatilho e integração manualmente e costumam ter mensalidade. A escolha depende do volume, do orçamento e de quanto controle você quer ter.
- API oficial do WhatsApp Business — estabilidade e conformidade: as maiores; configuração: mais burocrática; indicada para operações com volume alto e marca estabelecida.
- Evolution API — configuração: rápida, por QR Code; custo: baixo se auto-hospedada; risco: maior em caso de uso abusivo, por não ser oficial.
- Plataformas sem código — facilidade inicial: alta; flexibilidade: limitada ao que a plataforma oferece; custo: geralmente mensalidade.
- Em todas as opções, o risco de bloqueio cresce com disparo em massa para quem não pediu contato.
Passo a passo para criar o bot com IA
O caminho mais curto é deixar o Claude Code conduzir a montagem. Você descreve o que o bot deve fazer, entrega o conteúdo do seu negócio e ele cria o webhook, o backend e o prompt de atendimento. No kit Agente IA WhatsApp 15M com Claude Code, da ZX LAB, ele lê a sua página de vendas, gera o prompt e ativa um agente que qualifica pelo método BANT e envia o checkout.
Se preferir montar sem kit, a sequência é a mesma, com mais tentativa e erro. Em qualquer caso, não ligue o bot para todo o volume de mensagens no primeiro dia: comece com uma parte, leia as conversas e ajuste antes de liberar para todos. Cada ajuste nas primeiras conversas evita que o mesmo erro se repita com dezenas de clientes depois.
- 1. Separe um número dedicado e escolha a API de conexão.
- 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 gerar o prompt a partir do seu conteúdo real.
- 4. Defina a qualificação e o momento de enviar o link de pagamento ou chamar uma pessoa.
- 5. Teste com uma parte do volume, revise as conversas e ajuste antes de liberar para todos.
Como escrever as instruções do bot
As instruções, também chamadas de prompt, são o que transforma um modelo genérico no atendente do seu negócio. Elas dizem quem o bot é, para quem fala, qual o tom, o que pode responder e o que deve encaminhar. Instruções vagas geram respostas vagas; instruções específicas geram um bot que parece conhecer a empresa.
Um bom ponto de partida é usar as conversas reais do seu WhatsApp. As perguntas que os clientes já fazem, com as palavras que eles usam, mostram exatamente o que o bot precisa saber. Inclua também os limites: o bot não deve inventar preço, prometer prazo inexistente nem opinar sobre assuntos fora do seu negócio.
- Defina a identidade do bot, o público e o tom de voz.
- Inclua preços, prazos e políticas atualizados, sem contradições.
- Liste o que o bot nunca deve prometer ou inventar.
- Descreva os gatilhos de passagem para humano, como frustração, pedido explícito ou assunto sensível.
- Peça respostas curtas, adequadas à leitura no celular.
Risco de banimento e boas práticas
O erro mais caro é usar o número pessoal ou o principal da empresa para automação. O WhatsApp pode restringir ou banir números com comportamento que parece spam, e o risco cresce muito com disparos em massa para pessoas que nunca falaram com você. Um bot que responde quem chegou por conta própria, vindo de anúncio, site ou Instagram, opera num cenário bem mais seguro.
Também é importante ser transparente. Avise que o cliente está falando com um atendimento automático e deixe sempre fácil chegar a uma pessoa. E nunca peça dados sensíveis, como senha ou número completo de cartão, pelo chat automatizado. Essas regras simples protegem o número, o cliente e a reputação da empresa ao mesmo tempo, e não exigem nenhuma configuração técnica complexa.
- Use um número separado só para o bot.
- Foque em responder quem procurou você e evite disparo em massa não solicitado.
- Sempre tenha fallback humano com gatilhos claros.
- Avise que é atendimento automático e nunca peça dados sensíveis pelo chat.
- Revise as conversas toda semana, principalmente no início.
Custos, tempo e quando um bot não vale a pena
Com Evolution API auto-hospedada e backend serverless, a infraestrutura pode ter custo próximo de zero. O gasto principal é o modelo de IA, que varia com o volume e o tamanho das conversas; com o Gemini gratuito, dá para validar antes de pagar por API. O setup guiado leva cerca de 15 minutos, mas o ajuste fino das instruções continua nas primeiras semanas.
Alunos da ZX LAB já colocaram bots de IA no WhatsApp em operações reais. Bruno A. colocou um agente de IA qualificando leads para um cliente do ramo imobiliário. Cami automatizou o próprio WhatsApp usando um Setup ZX Control como base do prompt e repetiu o processo para o Instagram. São casos individuais, não promessa de resultado.
- Não vale a pena se você recebe poucas mensagens por semana e responde todas rapidamente.
- Não substitui atendimento humano em temas sensíveis, como saúde, jurídico ou reclamação formal.
- Não corrige oferta ruim: o bot acelera o atendimento, mas não define preço nem estratégia.
- Vale a pena quando leads esfriam esperando resposta ou a equipe passa o dia repetindo as mesmas respostas.
😱 Agente de IA em 15 Minutos no WhatsApp com Claude Code
Na ZX LAB, parte do primeiro atendimento roda com um bot de IA conectado ao WhatsApp, que responde as perguntas repetidas na hora e só chama um humano quando o caso foge do padrão. Rafael Castro, fundador da ZX LAB, monta e ajusta esses bots com o Claude Code, sem equipe de programação, e ensina o mesmo método aos mais de 15 mil alunos da escola.