Como Criar um Agente de IA Para WhatsApp com Claude Code

O que é um agente de IA no WhatsApp feito com Claude Code

Um agente de IA no WhatsApp é um atendente automático que lê a mensagem do cliente, consulta o que sabe sobre o seu negócio e responde em linguagem natural. Diferente de um chatbot de menu, ele entende perguntas escritas de qualquer jeito e pode seguir regras, como agendar, qualificar ou transferir para um humano.

O Claude Code entra como a ferramenta que monta tudo isso para você. Em vez de arrastar blocos numa plataforma visual, você descreve em português o que o agente deve fazer, e o Claude Code cria os arquivos, configura a conexão e ajusta o comportamento. Ele roda no seu computador, em Windows, Mac ou Linux.

• O agente responde em linguagem natural, não por menu de opções.
• O Claude Code monta a estrutura a partir de instruções em português.
• A conexão com o WhatsApp é feita por uma API, oficial ou não oficial.
• A qualidade do atendimento depende mais da base de conhecimento do que da tecnologia.

Passo a passo para criar o agente

O caminho mais curto tem cinco etapas. Cada uma pode ser pedida ao Claude Code em uma frase, e ele conduz a configuração explicando o que está fazendo. O ponto de atenção é não pular a etapa de testes: um agente que responde errado no primeiro dia custa mais caro que um agente que demora uma semana para entrar no ar.

• 1. Instale o Claude Code e abra uma pasta só para o projeto do agente.
• 2. Conecte o número: escolha entre a API oficial do WhatsApp Business ou uma API como a Evolution API e peça ao Claude Code para configurar a instância.
• 3. Escreva a base de conhecimento: produtos, preços que podem ser informados, horários, políticas e as perguntas que mais chegam.
• 4. Defina as regras: o que o agente nunca responde, quando ele transfere para um humano e qual tom de voz usar.
• 5. Teste com o seu próprio número antes de liberar para clientes, mandando as perguntas difíceis de propósito.

Base de conhecimento: onde o agente acerta ou erra

O agente só sabe o que você escreveu para ele. Se a política de troca não está na base, ele vai improvisar ou dizer que não sabe. Por isso, a melhor fonte para montar a base é o histórico real de conversas: as dúvidas que o seu time responde todo dia são exatamente o que o agente precisa saber.

Vale também escrever o que ele não deve fazer. Uma linha como "nunca prometa prazo de entrega, peça o CEP e transfira para o atendimento" evita mais problema do que dez parágrafos de descrição do produto.

• Comece pelas 20 perguntas que mais chegam no seu WhatsApp.
• Escreva respostas curtas, do jeito que você responderia ao cliente.
• Inclua o que o agente não pode responder e para quem ele deve passar.
• Revise a base toda semana com as perguntas que o agente não soube responder.

Cuidados para não ter o número bloqueado

O WhatsApp observa o comportamento do número, não a presença de um bot. Um agente que responde quem chegou por conta própria se parece com atendimento comum. O risco aparece quando o mesmo número passa a abrir muitas conversas novas por dia com pessoas que não respondem.

Outra prática que ajuda é responder em uma mensagem condensada, e não em vários balões seguidos em poucos segundos. Rajadas de mensagens deixam o padrão mais parecido com automação abusiva.

• Use o agente para responder, não para disparar em massa para contatos frios.
• Prefira uma resposta completa em um balão a várias mensagens em sequência.
• Número novo, sem histórico, merece volume menor nas primeiras semanas.
• Para escala com mensagens ativas, a API oficial da Meta é o caminho de menor risco.

Claude Code ou plataforma de chatbot pronta: comparação

Plataformas prontas de chatbot são rápidas para começar e cobram mensalidade. Montar com Claude Code dá mais controle sobre o comportamento e os dados, e o custo fica concentrado na assinatura da ferramenta e na API escolhida. A escolha depende de quanto você quer ajustar o agente ao seu negócio.

• Plataforma pronta — começo rápido, menos controle, mensalidade por número ou por conversa.
• Claude Code — você controla regras, base e integrações, e o projeto fica no seu computador.
• Fluxos visuais como n8n — flexíveis, mas exigem montar cada nó na mão.
• Para quem não programa, o Claude Code reduz a parte técnica a instruções em português.