Blog

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

5 min de leitura8 leiturasVídeo complementar
Thalena Lima ao lado das frases Agente IA e Sem programar, com ícones de WhatsApp e Claude e um painel ilustrativo com o botão Assumir.

Vídeo complementar

Abrir origem

Resposta 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.

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.

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.

ComponenteFunçãoControle necessário
Claude CodeConstruir e revisar a aplicaçãoPlano, permissões e testes por etapa
VPS HostingerHospedar o serviçoProcesso ativo e recuperação após falhas
UAZAPIReceber eventos e enviar mensagensInstância, credenciais e webhook
SupabasePersistir conversas e autenticar o painelPolíticas de acesso e segredos no servidor
PainelEditar instruções e assumir atendimentosVersã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

  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:

    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.

Recursos, Descontos e Ecossistema Lena AI

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

Thalena Lima — Criei uma IA que Atende no WhatsApp 24 Horas (Claude Code), 08/10/2026

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

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

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

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

A UAZAPI oferece API HTTP, sessões, envio de mensagens e webhooks; credenciais administrativas devem permanecer no backend.

Supabase — 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

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