Treinamento ACG · Aula 2 · Shine Salon

Conectar as ferramentas do agente

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 comandos
⚠️ Regras de hoje O WhatsApp do salão fica só leitura: nada é enviado para cliente. O servidor é o mesmo da Marmoraria: nunca mexer em nada que começa com "Marmoraria". Senhas e chaves: você cola direto no arquivo que o Claude abrir, nunca no chat.
Como usar
  1. Abra o VS Code na pasta ClaudeCode e comece uma conversa nova no Claude.
  2. Você = você faz à mão. Claude = copie o pedido e cole no Claude. Adriano = a ACG libera.
  3. Quando o Claude abrir um arquivo .env para preencher: cole cada valor depois do =, salve com ⌘ S e escreva "preenchi".
  4. Marque Feito em cada passo. O progresso fica salvo neste navegador.
📱 EvolutionWhatsApp: próxima aula
🔔 Telegramavisa você quando algo acontece
🧠 Cloudflare AIa IA que escreve as respostas
⚙️ n8nonde o agente "mora"
💬 Chatwootpainel onde a recepção assume
0 de 10 feitos

🧭 Começo

uns 5 min

Combinar as regras e organizar a pasta antes de conectar qualquer coisa.

1

Combinar as regras com o Claude

Claude

📖 Em palavras simples

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

Pedido para colar
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.

🔔 Bot de alertas no Telegram

uns 10 min

O agente vai avisar você aqui: quando der erro, quando a recepção precisar assumir uma conversa.

2

Criar o bot no celular

Você no Telegram

📖 Em palavras simples

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.

  1. No Telegram, busque @BotFather (tem selo azul) e toque em Iniciar.
  2. Mande /newbot.
  3. Nome: Shine Salon Alertas.
  4. Usuário: precisa terminar em bot. Ex.: ShineSalonAlertasBot (se já existir, tente outro).
  5. O BotFather responde com um token (uma linha comprida com números, dois-pontos e letras). Copie e guarde. Não mande para ninguém.
  6. Toque no link do seu bot novo e mande /start para ele.
3

Ligar o bot no Claude e testar

Claude

Pedido para colar
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.

🧠 Inteligência artificial (Cloudflare)

uns 15 min

Para testar o agente sem custo. Conta própria do salão: nunca usa a cota da Marmoraria nem da ACG.

4

Criar a conta Cloudflare e a chave da IA

Você no navegador

📖 Em palavras simples

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.

  1. Abra dash.cloudflare.com/sign-up e crie a conta com o e-mail do salão. É grátis, não pede cartão.
  2. Confirme o e-mail e entre no painel.
  3. Account ID: está no endereço do navegador, logo depois de dash.cloudflare.com/ (uma sequência de 32 letras e números). Copie e guarde.
  4. Clique no ícone de pessoa (canto superior direito) → Profile → API Tokens → Create Token → Create Custom Token.
  5. Nome: workers-ai-shine-salon.
  6. Em Permissions, escolha: Account → Workers AI → Edit. (É "Edit" mesmo: é o que libera usar a IA.)
  7. Continue to summary → Create Token → copie o token na hora (só aparece uma vez).

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.

5

Ligar a IA no Claude e testar

Claude

Pedido para colar
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".

⚙️ Automações (n8n)

uns 15 min

É onde o agente vai "morar". É o mesmo n8n da Marmoraria: você vai enxergar os fluxos da Carol também, mas só olha, nunca mexe.

6

Pegar a chave do n8n (token "Shine n8n")

Você + Adriano

📖 Em palavras simples

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

  1. Tenha em mãos a chave Shine n8n (o Adriano te ajuda a achar, se precisar).
  2. Endereço do n8n: https://n8n.mariacarolina.tech.
  3. Não cole a chave aqui nem no chat: só no arquivo que o Claude abrir no passo 7.
7

Ligar o n8n no Claude e testar

Claude

Pedido para colar
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".

💬 Painel de conversas (Chatwoot)

uns 10 min

Onde a recepção acompanha o que o agente respondeu e assume a conversa quando precisar.

8

Entrar na conta do Shine Salon

Você + Adriano

📖 Em palavras simples

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.

  1. Abra https://chat.mariacarolina.tech e entre com o login da Marmoraria (é ele que tem acesso às duas contas).
  2. No canto superior esquerdo, troque para a conta Shine Salon (número 3). A conta da Marmoraria é a número 1: lá não se mexe.
  3. Clique na sua foto → Profile settings → role até Access Token → copie.
9

Ligar o Chatwoot no Claude e testar

Claude

Pedido para colar
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.

✅ Fechamento

uns 5 min

Conferir que tudo o que foi ligado hoje está funcionando.

10

Conferência final

Claude

Pedido para colar
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".

Fica para a próxima aula

📱 Conectar o WhatsApp do salão

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.

🔍 Estudar as conversas

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.

Próxima aula: o agente

Com a auditoria pronta

Escrevemos o jeito de responder do Shine Salon: primeira resposta, dúvidas, objeções e quando passar para a recepção.

Montamos o fluxo no n8n

WhatsApp → agente (IA) → resposta. Primeiro em modo teste, respondendo só os números de vocês.

Passagem para a recepção

Reclamação, saúde, desconto ou cliente irritada: o agente para e avisa no Telegram e no Chatwoot.

Se travar

O Claude pediu para eu colar a chave no chat

Não cole. Responda: "crie o arquivo .env e abra no editor, eu preencho lá".

Apareceu algo com "Marmoraria"

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.

O teste deu erro 401 ou "Unauthorized"

A chave foi colada errada (espaço sobrando ou faltando um pedaço). Abra o arquivo .env, cole de novo e salve com ⌘ S.

A IA respondeu que o limite acabou

É o limite grátis do dia da Cloudflare. Ele volta no dia seguinte. Para os testes de hoje, uma ou duas chamadas bastam.