Hoje o Claude Code liga, uma por uma, as peças que o agente SDR vai usar: alertas, inteligência artificial, automações e painel de conversas. O WhatsApp e a leitura das conversas ficam para a próxima aula.
10 passos · cerca de 1h15 · sem precisar saber comandosClaudeCode e comece uma conversa nova no Claude..env para preencher: cole cada valor depois do =, salve com ⌘ S e escreva "preenchi".Combinar as regras e organizar a pasta antes de conectar qualquer coisa.
Claude
Antes de mexer no servidor, o Claude relê o manual do projeto e repete as regras. Se ele errar alguma, a gente corrige antes de começar.
💡 Regra nova: tudo fica dentro da pasta ClaudeCode, organizado em gavetas. Assim nada se perde em Downloads ou na Mesa, e depois fica simples montar o "cérebro" do salão a partir de uma pasta só.
Hoje vamos conectar as ferramentas do agente do Shine Salon. Leia o CLAUDE.md e confirme, em 4 linhas, as regras que valem hoje: 1. o WhatsApp do salão é SÓ LEITURA (nunca enviar mensagem, nunca desconectar, nunca apagar); 2. o servidor é compartilhado com a Marmoraria: só mexer no que começa com "Shine Salon" e nunca tocar em nada "Marmoraria" nem em variáveis CAROL_*; 3. senha e chave nunca no chat: eu colo direto no arquivo .env que você abrir; 4. antes de cada passo, me diga o que vai fazer e espere a minha permissão; 5. TUDO fica dentro da pasta ~/ClaudeCode, organizado em subpastas. Nada em Downloads, Mesa, Documentos ou pastas temporárias do sistema. Arquivo temporário vai em ~/ClaudeCode/tmp e é apagado no fim. Grave essas regras no CLAUDE.md se ainda não estiverem lá. Depois crie (só o que ainda não existir) esta organização e escreva no CLAUDE.md, numa seção "Onde guardar cada coisa": ~/ClaudeCode/ ├── CLAUDE.md ← o manual do projeto ├── cerebro/ ← decisões, aprendizados e anotações (base do cérebro) ├── salao/ ← perfil.md + conversas/ (dados das clientes, fora do Git) ├── agente/ ← prompt do agente, testes e fluxos do n8n exportados ├── entregas/ ← relatórios, auditorias, kits (nome: AAAA-MM-DD_assunto) ├── credentials/ ← senhas e chaves (fora do Git) ├── treinamento/ ← material das aulas └── tmp/ ← temporários (fora do Git, apagar no fim) Se encontrar algum arquivo do projeto fora de ~/ClaudeCode (por exemplo em Downloads), me avise e pergunte antes de mover. Coloque tmp/ no .gitignore.
O agente vai avisar você aqui: quando der erro, quando a recepção precisar assumir uma conversa.
Você no Telegram
Um bot é um "contato robô" do Telegram que manda mensagens para você. Quem cria bots é o próprio Telegram, por um contato oficial chamado BotFather.
/newbot.ShineSalonAlertasBot (se já existir, tente outro).Claude
Vamos ligar o bot de alertas do salão no Telegram. 1. Crie credentials/telegram-salao.env com os campos vazios TELEGRAM_BOT_TOKEN= e TELEGRAM_CHAT_ID=, proteja com chmod 600, abra no editor e espere eu dizer "preenchi" (eu colo só o token). 2. Depois, descubra o meu chat_id pela API do Telegram (getUpdates: eu já mandei /start para o bot) e grave no arquivo. Não mostre o token na tela. 3. Me peça permissão e mande uma mensagem de teste para mim: "✅ Bot de alertas do Shine Salon funcionando". 4. Anote no CLAUDE.md, em "Contas conectadas": bot de alertas do salão, credencial credentials/telegram-salao.env.
Se o Claude disser que não achou o chat_id: mande /start de novo para o bot e peça para ele tentar outra vez.
Para testar o agente sem custo. Conta própria do salão: nunca usa a cota da Marmoraria nem da ACG.
Você no navegador
A Cloudflare tem um serviço chamado Workers AI que roda inteligência artificial de graça, até um limite por dia. O agente "pergunta" para ela como responder cada cliente. Foi o mesmo tipo de IA usado nos testes da Carol, da Marmoraria.
💡 O limite grátis dá para dezenas de mensagens de teste por dia. Para atender clientes de verdade, depois a gente troca por uma IA paga (OpenAI, conta do salão) sem refazer o agente.
dash.cloudflare.com/ (uma sequência de 32 letras e números). Copie e guarde.Se a tela estiver um pouco diferente, peça ao Claude: "estou no painel da Cloudflare, me guie para criar um token com permissão Workers AI Edit" e descreva o que aparece.
Claude
Vamos ligar a IA de teste do agente: Cloudflare Workers AI, conta do salão. 1. Crie credentials/cloudflare-ai-salao.env com os campos vazios CLOUDFLARE_ACCOUNT_ID= e CLOUDFLARE_AI_TOKEN=, proteja com chmod 600, abra no editor e espere eu dizer "preenchi". 2. Teste pequeno: chame POST https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai/v1/chat/completions com o modelo @cf/meta/llama-3.3-70b-instruct-fp8-fast e a mensagem "Responda só, em português: OK, IA do Shine Salon funcionando". Me mostre só a resposta e quanto tempo levou (sem mostrar o token). 3. Liste os modelos de texto disponíveis (GET /accounts/<ACCOUNT_ID>/ai/models/search?task=Text%20Generation) e me diga, em palavras simples, quais 3 servem melhor para conversar em português. Os modelos mudam com o tempo: não assuma um nome fixo. 4. Anote no CLAUDE.md, em "Contas conectadas": IA de TESTE do agente = Cloudflare Workers AI (conta do salão, grátis, limite de ~10.000 "neurons" por dia), credencial credentials/cloudflare-ai-salao.env. IA de produção (futura) = OpenAI, conta do salão. Se der erro de permissão (401 ou 403), me diga em palavras simples: provavelmente o token foi criado sem a permissão "Workers AI → Edit".
É onde o agente vai "morar". É o mesmo n8n da Marmoraria: você vai enxergar os fluxos da Carol também, mas só olha, nunca mexe.
Você + Adriano
A chave "Shine n8n" já foi criada no seu n8n. Ela é a chave do dono: abre o n8n inteiro, inclusive os fluxos da Carol (Marmoraria). Por isso a regra é dura: o Claude só cria e altera fluxos com nome "Shine Salon" e trata tudo de "Marmoraria" como vitrine trancada (só olhar).
Claude
Vamos ligar o n8n do salão. 1. Crie credentials/n8n-salao.env com os campos vazios N8N_URL= e N8N_API_KEY=, proteja com chmod 600, abra no editor e espere eu dizer "preenchi". (A URL é o endereço do n8n que o Adriano passou, sem barra no final.) 2. Teste SÓ LEITURA: liste os fluxos (GET /api/v1/workflows) e me mostre em 2 grupos: "Shine Salon" (pode ser zero) e "Marmoraria / outros" (só a contagem e os nomes). - Não abra, não ative, não desative, não edite e não apague nenhum fluxo hoje. 3. Grave no CLAUDE.md, em destaque, esta regra: "n8n compartilhado com a Marmoraria. A chave é de DONO (abre tudo). Só criar/alterar/ativar/apagar fluxos, credenciais, tabelas e variáveis com nome começando em 'Shine Salon'. Fluxos da Marmoraria (Carol) = só leitura, nunca alterar, ativar, desativar, reexecutar ou apagar, nem 'para arrumar'. Nunca usar $env.CAROL_* nem credenciais da Marmoraria. Nunca criar/alterar usuários do n8n. Antes de QUALQUER alteração no n8n, mostrar o nome do fluxo e esperar meu OK." 4. Anote a credencial credentials/n8n-salao.env em "Contas conectadas".
Onde a recepção acompanha o que o agente respondeu e assume a conversa quando precisar.
Você + Adriano
O Chatwoot é como um "WhatsApp Web da equipe": várias pessoas veem as mesmas conversas. O salão tem uma conta separada da Marmoraria, para nada se misturar.
Claude
Vamos ligar o painel de conversas (Chatwoot) do salão. 1. Crie credentials/chatwoot-salao.env com os campos vazios CHATWOOT_URL=, CHATWOOT_ACCOUNT_ID= e CHATWOOT_TOKEN=, proteja com chmod 600, abra no editor e espere eu dizer "preenchi". (A conta do salão é a número 3: CHATWOOT_ACCOUNT_ID=3.) 2. Teste só leitura: busque os dados da conta (GET /api/v1/accounts/3) e me diga o NOME da conta e quantas caixas de entrada ela tem. - O nome tem que ser "Shine Salon". Se for outro: PARE e me diga para avisar o Adriano. 3. Grave no CLAUDE.md: "Chatwoot: o token também abre a conta 1 (Marmoraria, da Carol). Só usar a conta 3 (Shine Salon) — nunca ler, criar ou alterar nada na conta 1, nem webhooks, etiquetas ou integrações dela." 4. Não crie nem altere nada no Chatwoot hoje. Só anote a credencial em "Contas conectadas" no CLAUDE.md.
Conferir que tudo o que foi ligado hoje está funcionando.
Claude
Faça a conferência final da aula, só leitura: 1. Teste cada conexão e me mostre uma tabela "ferramenta | status | observação": Telegram (bot responde?), Cloudflare Workers AI (IA responde?), n8n (quantos fluxos eu enxergo?), Chatwoot (nome da conta). O WhatsApp (Evolution) fica para a próxima aula: não teste hoje. 2. Confira que nenhuma chave aparece em arquivo fora de credentials/ e que o .gitignore bloqueia credentials/ e salao/conversas/. 3. Atualize a tabela "Contas conectadas" do CLAUDE.md e faça um commit no Git: "Aula 2: Telegram, IA (Cloudflare), n8n e Chatwoot conectados".
Parear o celular do salão com a Evolution (código de 8 letras ou QR code). O histórico de conversas começa a chegar logo depois.
Com o histórico carregado, o Claude lê as conversas reais e mostra o que faz as clientes agendarem e onde desistem. É a base do agente.
Escrevemos o jeito de responder do Shine Salon: primeira resposta, dúvidas, objeções e quando passar para a recepção.
WhatsApp → agente (IA) → resposta. Primeiro em modo teste, respondendo só os números de vocês.
Reclamação, saúde, desconto ou cliente irritada: o agente para e avisa no Telegram e no Chatwoot.
Não cole. Responda: "crie o arquivo .env e abra no editor, eu preencho lá".
No n8n e no Chatwoot é normal ver a Marmoraria (é o mesmo servidor). Só olhe: não clique, não altere e não peça para o Claude "arrumar". Se o Claude propuser mexer em algo "Marmoraria", responda "não" e avise o Adriano.
A chave foi colada errada (espaço sobrando ou faltando um pedaço). Abra o arquivo .env, cole de novo e salve com ⌘ S.
É o limite grátis do dia da Cloudflare. Ele volta no dia seguinte. Para os testes de hoje, uma ou duas chamadas bastam.