Cinco prompts, na ordem. Copia, cola no Claude Code, responde o que ele perguntar.
uma vez só, antes de tudo
Dá ao Claude a permissão de mexer no seu servidor. Sem token, sem colar chave: abre uma tela e você autoriza com sua conta.
Instale o MCP da Hostinger pra mim. Rode este comando: claude mcp add --transport http hostinger https://mcp.hostinger.com Depois me diga exatamente o que eu preciso fazer em seguida para autorizar, e se eu preciso reiniciar alguma coisa para a conexão valer.
O Claude roda o comando sozinho. Vai abrir uma tela pedindo autorização da sua conta Hostinger: é o momento em que fica claro que você está dando uma permissão, não entregando uma senha.
logo depois de autorizar
Antes de construir qualquer coisa, prove que a ligação funcionou.
Use o MCP da Hostinger e me mostre, numa lista curta: - quais VPS eu tenho, com nome e IP - qual sistema cada uma roda - quais projetos Docker já estão rodando em cada uma Não crie nem altere nada ainda. Só me mostre o que existe.
O IP da sua VPS e um projeto chamado traefik já rodando. Se apareceu isso, o acesso está certo.
o prompt grande, o que faz tudo
Ele vai te fazer perguntas antes de construir. Responda com calma, porque é daí que sai a qualidade do atendimento.
Quero construir um agente de IA que atende meu WhatsApp e conversa com meus clientes. Ele vai rodar na minha VPS da Hostinger, em contêineres Docker, usando a Evolution API para conectar o WhatsApp e o Claude como modelo. Sem API oficial da Meta. ANTES DE ESCREVER QUALQUER CÓDIGO, me pergunte, uma pergunta por vez: 1. Qual é o meu negócio e o que eu vendo? 2. O agente deve VENDER (mandar link de pagamento) ou AGENDAR (marcar horário)? 3. Qual o objetivo dele em uma frase? O que eu considero uma conversa bem-sucedida? 4. Como ele deve falar? Me peça um exemplo de mensagem escrita do meu jeito. 5. O que ele NUNCA pode dizer ou fazer? 6. Quais informações do meu produto ou serviço ele precisa saber? Me pergunte preço, o que está incluso, como é a entrega, garantia, e as dúvidas que meus clientes mais fazem. 7. Quando ele deve passar a conversa para um humano? Espere minha resposta de cada pergunta antes de seguir para a próxima. DEPOIS QUE EU RESPONDER TUDO, construa nesta pasta: - prompt/agente.md com quem ele é: objetivo, tom, como conduzir a conversa, e um bloco "NUNCA FAÇA ISSO" com as proibições que eu te disse - base/produto.md com tudo que ele sabe, em tabelas simples, e a regra de que campo não preenchido não se adivinha: ele diz que confirma com a equipe - servidor/app.mjs com o cérebro: recebe a mensagem, junta o histórico, chama o Claude, executa as ferramentas e responde - sql/schema.sql com as tabelas: lead, mensagem, evento e venda - ATUALIZAR.bat que manda as mudanças pro servidor sem reiniciar nada O cérebro precisa ter: - buffer que espera alguns segundos juntando mensagem picotada antes de responder - identificação correta de quem mandou, lendo remoteJidAlt e não só remoteJid, porque o WhatsApp agora usa LID e o remoteJid pode não ser o telefone - memória por contato, guardada no banco - humanizador que quebra a resposta em balões e mostra "digitando" - teto de mensagens por hora, contra bloqueio do número - as ferramentas que fazem sentido pro meu caso, conforme o que eu respondi Ao terminar, me mostre a pasta criada e me explique cada arquivo em uma linha. Não suba nada pro servidor ainda.
É aqui que o aluno percebe que não vai programar: ele vai responder perguntas sobre o próprio negócio.
depois que a pasta estiver criada
Agora suba tudo pra minha VPS da Hostinger, usando o MCP. Crie dois projetos Docker separados: PROJETO 1, chamado "infra", com três contêineres: - postgres, que é o banco de dados - redis, para o cache da Evolution - evolution-api, que conecta o WhatsApp PROJETO 2, chamado "cerebro", com o código que você escreveu. Separe em dois projetos de propósito: assim eu atualizo o cérebro quantas vezes quiser sem derrubar a conexão do WhatsApp. Gere senhas fortes para o banco e para a Evolution, e salve num arquivo à parte na minha máquina, fora da pasta do projeto. Não escreva essas senhas no chat. Quando terminar: 1. confirme que os quatro contêineres estão rodando 2. me diga em qual endereço eu abro o painel da Evolution 3. me diga se falta alguma chave minha para o agente funcionar
Senha e chave não podem aparecer na tela. Peça pra ele salvar em arquivo, nunca escrever no chat.
com o celular na mão
O webhook é o passo que ninguém lembra e que falha em silêncio: sem ele, o QR conecta e nada acontece.
Agora vamos conectar meu WhatsApp. 1. Crie uma instância na Evolution chamada "atendimento", usando a conexão por QR code (Baileys) 2. Me diga o endereço onde eu abro o painel da Evolution e onde eu clico pra ver o QR 3. Configure o webhook dessa instância apontando pro cérebro, no evento de mensagem recebida. Isso é o que faz a mensagem chegar até ele 4. Depois que eu escanear, confirme pra mim que a instância está conectada e que o webhook está gravado Me avise antes, porque o QR expira rápido e eu preciso estar com o celular na mão.
Mostre o QR na tela e escaneie ao vivo. É o instante em que o sistema deixa de ser abstrato.
a prova final
Vou mandar uma mensagem do meu celular pro número conectado agora. Depois que eu mandar: 1. me mostre o log do cérebro, pra eu ver a mensagem chegando 2. me diga o que ele respondeu e quais ferramentas ele usou 3. se não responder, me diga exatamente onde parou: a mensagem chegou na Evolution? chegou no cérebro? o modelo respondeu? deu erro de chave? Não conserte nada ainda. Primeiro me mostre o que aconteceu.
E para mudar o jeito dele falar, depois:
Quero ajustar como meu agente fala. O que me incomodou: [escreva aqui o que ele fez que você não gostou] O que eu queria no lugar: [escreva como você responderia] Ajuste o prompt/agente.md e suba a mudança. Não mexa no código do cérebro, só no texto.
Quase todo ajuste de comportamento é texto, não código. Quem entende isso para de ter medo de mexer.
o fecho da aula
É aqui que deixa de ser um bot e vira um sistema que dá pra vender.
Agora construa o painel do dono e suba junto com o cérebro. É uma página web protegida por senha, onde eu acompanho tudo sem abrir o WhatsApp. Ela lê direto do banco. Precisa ter: CONVERSAS, em três colunas - lista de quem falou, com a última mensagem e há quanto tempo - o chat no meio, com quem falou o quê - a ficha da pessoa na direita: nome, o que ela quer, em que etapa do funil está, e o histórico do que o agente fez O BOTÃO DE ASSUMIR A CONVERSA - quando eu assumo, o agente para de responder SÓ aquela conversa - as outras seguem normais com ele - eu respondo dali mesmo e a mensagem sai no WhatsApp - quando eu devolvo, ele continua de onde parou, sem recomeçar FUNIL - quantas pessoas em cada etapa, e quanto passou de uma pra outra CLIENTES - tabela com todo mundo que já falou, com filtro e botão de baixar planilha - é daqui que eu tiro a lista pra campanha depois [se o agente for de agendamento, acrescente:] AGENDA - os horários marcados, agrupados por dia, começando por hoje e amanhã - quem vem, que serviço, com quem e o telefone Regras: - senha única pra entrar, com sessão que dura 30 dias - a tela atualiza sozinha a cada poucos segundos, sem piscar - funciona no celular, porque o dono vai abrir no celular - o estado de "assumida" tem que ser impossível de não ver: se eu esquecer que assumi, o cliente fica sem resposta Quando terminar, me diga o endereço do painel e onde está a senha.
O aluno acabou de ver o agente respondendo. Aí você abre essa tela e ele entende que tem um produto na mão, não um bot.