# Agente de IA no WhatsApp com Claude Code: VPS e controle humano > Um agente de IA no WhatsApp recebe mensagens pela integração de WhatsApp, consulta instruções e histórico, prepara respostas e encaminha o atendimento quando necessário. Claude Code ajuda a construir essa aplicação; a VPS mantém o serviço independente do computador local. Um painel permite revisar prompts, testar conversas e alternar entre IA e humano. - URL canônica: https://blog.lenaai.com.br/agente-ia-whatsapp-claude-code-vps - Autor: Thalena Lima; publicado por Lena AI. - Publicado em 8 de outubro de 2026; atualizado em 11 de outubro de 2026. - Leitura estimada: 5 min. - Categorias: IA na prática, Tecnologia, Tutorial. - Conteúdo complementar: https://www.youtube.com/watch?v=6LHNvmJE9UM --- > Um agente de IA no WhatsApp recebe mensagens pela integração de WhatsApp, consulta instruções e histórico, prepara respostas e encaminha o atendimento quando necessário. Claude Code ajuda a construir essa aplicação; a VPS mantém o serviço independente do computador local. Um painel permite revisar prompts, testar conversas e alternar entre IA e humano. ## Atendimento contínuo começa com um escopo claro Automatizar o primeiro contato não exige construir um CRM inteiro. O objetivo inicial é uma recepcionista digital: compreender a demanda, qualificar e entregar contexto ao atendente, sem promessas indevidas. A qualificação demonstrada por Thalena Lima reúne quatro informações: quem é a pessoa, qual é o negócio, o que precisa e para quando. Adapte as perguntas ao nicho. Determine quais informações o agente pode consultar, quais assuntos ficam fora do escopo e quando deve interromper a automação. ![Diagrama editorial que separa Claude Code no desenvolvimento do fluxo WhatsApp, UAZAPI, aplicação na VPS, modelo de IA, banco e painel. Ilustração conceitual.](https://raw.githubusercontent.com/vinilevy/lena-blog-assets/main/posts/agente-ia-whatsapp-claude-code-vps/arquitetura.jpg) ## Arquitetura: desenvolver, executar e controlar são funções diferentes Claude Code é a ferramenta de desenvolvimento: lê arquivos, escreve código e executa comandos. O atendimento é realizado pela aplicação publicada, conectada ao modelo de IA definido no projeto. **Ter Claude Code instalado não significa ter um agente de WhatsApp pronto.** | Componente | Função | Controle necessário | |---|---|---| | Claude Code | Construir e revisar a aplicação | Plano, permissões e testes por etapa | | VPS Hostinger | Hospedar o serviço | Processo ativo e recuperação após falhas | | UAZAPI | Receber eventos e enviar mensagens | Instância, credenciais e webhook | | Supabase | Persistir conversas e autenticar o painel | Políticas de acesso e segredos no servidor | | Painel | Editar instruções e assumir atendimentos | Versão publicada e pausa por número | A demonstração utiliza uma **camada não oficial via UAZAPI**, com o número também conectado à modalidade oficial. Não confunda essa camada com a API oficial da Meta. Avalie a integração: o exemplo não comprova disponibilidade garantida nem custo zero. > [!tip] **VPS e cupom da descrição** > [Acesse a Hostinger pelo link da Thalena](https://www.hostg.xyz/SHJ5B). A descrição anuncia o cupom **THALENA**, com 10% OFF nos planos anuais de VPS para contas novas. Confirme elegibilidade e valor no checkout. Link de afiliada; oferta não validada no checkout. ## Implementação em etapas: da VPS ao atendimento real 1. **Prepare o servidor.** Selecione o template com Claude Code pré-instalado e abra o terminal web da VPS. Thalena recomenda KVM 1 para testes e KVM 2 para produção; isso é uma orientação do tutorial, não um dimensionamento para qualquer volume. Verifique e autentique: ```bash claude --version claude ``` 2. **Organize o ambiente.** Inspecione antes de instalar dependências. No exemplo, o ambiente recebe Docker, Compose, usuário e pasta próprios, além de skills para planejamento, implementação e validação. Revise as mudanças. 3. **Aprove o plano antes do código.** Defina perguntas de qualificação, informações autorizadas, histórico e passagem ao humano. Comece por uma versão simulada; depois integre banco, IA, publicação e WhatsApp. Evite pedir apenas “crie um agente”. 4. **Configure dados e credenciais.** Prepare o Supabase e guarde segredos no ambiente privado do servidor, nunca no prompt, repositório ou navegador. Um arquivo `.env` não substitui políticas de acesso. Chaves secretas do Supabase possuem acesso elevado e devem permanecer no backend. Confirme autenticação e cobrança do modelo que responderá aos clientes: o acesso ao Claude Code para desenvolver não define os custos dessa execução. 5. **Construa os controles antes de liberar.** O painel precisa editar instruções, salvar versões, testar conversas e pausar a IA globalmente ou por número. Conecte a UAZAPI conforme sua documentação e comece com apenas um número autorizado para teste. 6. **Valide a transição e a persistência.** Envie mensagens, confira o histórico, use “Assumir” e verifique que a IA permanece silenciosa. Depois, retome explicitamente a automação. Teste a aplicação com o terminal fechado e após reiniciar o serviço. Manter o atendimento independente do computador exige a aplicação efetivamente ativa na VPS. ![Diagrama editorial das seis etapas de implementação, da preparação da VPS aos testes de atendimento e passagem ao humano.](https://raw.githubusercontent.com/vinilevy/lena-blog-assets/main/posts/agente-ia-whatsapp-claude-code-vps/etapas-implementacao.jpg) ## Recursos, Descontos e Ecossistema Lena AI - 🎁 **Prompts e comandos da aula:** [comunidade gratuita Lena Academy](https://academy.lenaai.com.br/?utm_source=organico&utm_medium=youtube&utm_campaign=videos&utm_term=descricao&utm_content=video101). - ⚡ **Infraestrutura:** [VPS Hostinger e cupom THALENA](https://www.hostg.xyz/SHJ5B), conforme condições anunciadas. - 🎥 **Integração complementar:** [tutorial sobre coexistência oficial e não oficial](https://youtu.be/30SRcJIBEgA). ## Assista ao tutorial prático no YouTube > **Vídeo complementar:** [Criei uma IA que Atende no WhatsApp 24 Horas (Claude Code)](https://www.youtube.com/watch?v=6LHNvmJE9UM) ## Respostas diretas **Como funciona o fluxo de um agente de WhatsApp hospedado em VPS?** A integração entrega a mensagem à aplicação na VPS. A aplicação usa instruções, histórico e um modelo de IA para preparar a resposta, que retorna ao WhatsApp. O serviço precisa permanecer ativo no servidor para funcionar sem o computador local. **Como controlar a passagem do atendimento da IA para uma pessoa?** O projeto demonstrado inclui pausa global, pausa por número e um botão para assumir a conversa. A validação deve confirmar que a IA não responde durante o atendimento humano e só retorna depois de uma ação explícita de retomada. **Claude Code é o serviço de atendimento do WhatsApp?** Claude Code ajuda a desenvolver e revisar a aplicação. O serviço publicado recebe mensagens e utiliza o modelo de IA configurado no projeto. A instalação do Claude Code e sua assinatura não substituem a configuração e a verificação dos custos de execução do agente. ## Perguntas frequentes **Quais contas e serviços devo preparar antes de começar?** Prepare acesso ao Claude Code para desenvolver, uma VPS, um número de WhatsApp, uma instância UAZAPI e um projeto Supabase. Confirme separadamente o provedor de IA e suas credenciais para a aplicação responder aos clientes. **O tutorial apresenta um CRM completo?** Não. A solução demonstrada concentra-se no primeiro atendimento, qualificação do contato e controle da IA por um painel simples. Recursos de CRM, como funil comercial e gestão de oportunidades, não são o objetivo da aplicação. **Preciso configurar atualização do painel em tempo real?** A demonstração mostra o histórico sendo atualizado ao recarregar a página. Atualização em tempo real é mencionada como melhoria possível, não como recurso já implementado e comprovado no tutorial. **Existe uma medição de latência ou capacidade do agente?** O vídeo demonstra respostas no WhatsApp, mas não apresenta um benchmark de latência, concorrência ou volume suportado. Esses parâmetros precisam ser medidos na aplicação e na infraestrutura escolhidas. **Onde estão os prompts exatos utilizados pela Thalena?** A descrição do vídeo direciona os prompts e comandos para a comunidade gratuita Lena Academy. Use o link específico da aula para consultar os materiais; o guia do blog organiza o processo sem reproduzir comandos que não foram fornecidos integralmente. ## Fontes - [Thalena Lima — Criei uma IA que Atende no WhatsApp 24 Horas (Claude Code), 08/10/2026](https://www.youtube.com/watch?v=6LHNvmJE9UM): O tutorial demonstra construção por etapas, qualificação por quatro informações, painel de instruções, pausa por número, histórico no Supabase e passagem ao humano. - [Descrição original do vídeo de Thalena Lima](https://www.youtube.com/watch?v=6LHNvmJE9UM): A descrição completa fornece os links Hostinger, Lena Academy com parâmetros video101 e vídeo de coexistência; anuncia THALENA com 10% OFF em VPS anual para contas novas. Oferta não validada no checkout. - [Anthropic — Claude Code Overview](https://code.claude.com/docs/en/overview): Claude Code lê código, edita arquivos e executa comandos; claude --version verifica a instalação e claude inicia uma sessão. - [Hostinger — How to use the Claude Code VPS template](https://www.hostinger.com/support/11970152-how-to-use-the-claude-code-vps-template/): O template Ubuntu 24.04 com Claude Code da Hostinger oferece o programa pré-instalado e acesso por terminal web ou SSH. - [UAZAPI — Visão geral da integração](https://docs.uazapi.com/): A UAZAPI oferece API HTTP, sessões, envio de mensagens e webhooks; credenciais administrativas devem permanecer no backend. - [Supabase — API keys](https://supabase.com/docs/guides/getting-started/api-keys): Chaves secretas do Supabase têm acesso elevado e são destinadas a componentes controlados no servidor; chaves publicáveis dependem de políticas de Row Level Security. - [Anthropic — Authentication in Claude Code](https://code.claude.com/docs/en/authentication): Claude Code aceita autenticação por assinatura Claude Pro/Max e outras modalidades documentadas; isso não determina o provedor do agente construído.