08 de outubro de 2026
Agente de IA no WhatsApp com Claude Code: VPS e controle humano
Crie um agente de WhatsApp com qualificação de contatos, histórico no Supabase e painel para pausar a IA e assumir a conversa. Entenda a construção por etapas com Claude Code e publicação em VPS.
por Thalena Lima

Vídeo complementar
Abrir origemResposta rápida
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.
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.

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. 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
-
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:
claude --version claude -
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.
-
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”.
-
Configure dados e credenciais. Prepare o Supabase e guarde segredos no ambiente privado do servidor, nunca no prompt, repositório ou navegador. Um arquivo
.envnã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. -
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.
-
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.

Recursos, Descontos e Ecossistema Lena AI
- 🎁 Prompts e comandos da aula: comunidade gratuita Lena Academy.
- ⚡ Infraestrutura: VPS Hostinger e cupom THALENA, conforme condições anunciadas.
- 🎥 Integração complementar: tutorial sobre coexistência oficial e não oficial.
Assista ao tutorial prático no YouTube
Vídeo complementar: Criei uma IA que Atende no WhatsApp 24 Horas (Claude Code)
Para continuar
Respostas citáveis
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.
Blocos citáveis
- Claude Code é uma ferramenta de desenvolvimento; a aplicação de WhatsApp precisa de integração, persistência, controles e publicação próprios.
- Na demonstração de Thalena Lima, o painel permite publicar instruções, testar conversas e alternar o atendimento entre IA e humano.
- Uma aplicação em VPS pode operar sem o computador local ligado, desde que seu processo e suas dependências permaneçam disponíveis.
- Na integração apresentada, a camada UAZAPI usada para conversar é não oficial, ainda que o número também tenha conexão oficial mencionada no tutorial.
Perguntas frequentes
Fontes e evidências
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.
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.
Claude Code lê código, edita arquivos e executa comandos; claude --version verifica a instalação e claude inicia uma sessão.
O template Ubuntu 24.04 com Claude Code da Hostinger oferece o programa pré-instalado e acesso por terminal web ou SSH.
A UAZAPI oferece API HTTP, sessões, envio de mensagens e webhooks; credenciais administrativas devem permanecer no backend.
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.
Claude Code aceita autenticação por assinatura Claude Pro/Max e outras modalidades documentadas; isso não determina o provedor do agente construído.
Próximas leituras
Categorias
Mais vistos
Grok 4.7 vs Claude Opus 5.5 vs GPT-6 Sol e Luna: Guia Prático de Escolha e Benchmarks
18 leituras
Grok 4.7 vs Claude Opus 5.5 vs GPT-6 Sol e Luna: Comparativo Real
14 leituras
Hermes Agent Grátis com OmniRoute: Guia Prático 24/7 na VPS
12 leituras
Agentes e sistemas com IA em produção: princípios de engenharia da Lena AI
11 leituras
A IA vai acabar com os softwares? O que o REA realmente faz
9 leituras
