🏛️ O que é o Olimpo?

Imagine que seus anúncios na internet são como uma lojinha na praça mais movimentada da cidade. Todo dia você paga um valor para chamar as pessoas até a vitrine. O problema: como saber se esse dinheiro está voltando em vendas ou indo pelo ralo?

O Olimpo é o seu painel de controle que responde essa pergunta. Ele funciona como a cabine de um avião: em vez de você abrir mil telas do Facebook e fazer contas na calculadora, o Olimpo mostra tudo em uma tela só, com cores que qualquer pessoa entende:

• 🟢 Verde = está indo muito bem, pode acelerar
• 🟡 Amarelo = atenção, fique de olho
• 🔴 Vermelho = perigo, precisa agir agora

O que o Olimpo faz sozinho, sem você pedir

• Busca os números dos seus anúncios no Meta Ads (Facebook/Instagram) de hora em hora, automaticamente
• Analisa se cada campanha está dando lucro e decide: escalar, manter ou pausar
• Manda mensagem no seu WhatsApp quando algo importante acontece (bom ou ruim)
• Avisa antes de dar problema — por exemplo, quando a "chave de acesso" ao Facebook está perto de vencer

Quem mora no Olimpo

O sistema tem 7 agentes (assistentes inteligentes), cada um com nome de deus grego e uma especialidade — como um time de futebol onde cada jogador tem sua posição. O capitão do time é o Zeus: ele olha tudo e dá as ordens. Você vai conhecer cada um no Capítulo 6.

🔑 Entrando no app

Passo 1 — Abrir o Olimpo

Se o Olimpo já está publicado na internet (na sua VPS), basta abrir o endereço dele no navegador, como se fosse um site qualquer.

Se quiser rodar no seu Mac, abra o aplicativo Terminal e cole estas três linhas, uma de cada vez, apertando Enter depois de cada uma:

Depois abra o navegador e digite: http://localhost:8001

Passo 2 — A senha

Assim que a página abrir, aparece uma caixinha pedindo a senha de acesso. Digite:

Se errar a senha, aparece "ACESSO NEGADO". Sem pânico: é só recarregar a página (aperte F5 ou o botão de atualizar do navegador) e digitar de novo.

Passo 3 — Escolher: Demo ou Dados Reais

Depois da senha, o Olimpo pergunta como você quer entrar:

🗺️ Conhecendo a tela

A tela do Olimpo é dividida em 3 partes, de cima para baixo. Vamos passear por elas:

1. A barra do topo (cabeçalho)

• ⚡ OLYMPUS — o nome do sistema e, embaixo, o nome do projeto que está aberto (ex: "Neuroganho · Destrave a Fala")
• Contador "DIAS P/ EVENTO" — quantos dias faltam para o seu lançamento ou evento. Ele conta sozinho, baseado na data cadastrada no projeto
• Botão "⚡ Coletar Agora" — força o Olimpo a buscar os números mais recentes do Facebook neste exato momento, sem esperar a coleta automática de hora em hora. Use quando quiser ver dados fresquinhos
• Botão "Conectar" — reabre a caixinha de escolha entre Demo e Dados Reais. Quando a bolinha ao lado dele fica verde piscando, significa que você está vendo dados reais
• Seletor de projeto — se você tiver mais de um projeto cadastrado (ex: Destrave a Fala e Imersão T21), aparece uma caixinha para trocar entre eles

2. As abas (o menu de navegação)

Logo abaixo do topo há 4 abas. Clicar em cada uma muda o que aparece na tela:

3. O conteúdo

É a área grande que muda conforme a aba escolhida. Nos próximos capítulos vamos explorar cada aba com calma.

📊 Aba Visão Geral — os números explicados

O banner do Zeus (a faixa dourada no topo)

A primeira coisa que você vê é a ordem do dia do Zeus, o comandante. Ele resume em uma frase o que fazer agora, por exemplo: "ESCALAR REMARKETING · MANTER PROSPECÇÃO". Ao lado, um selo colorido mostra a decisão principal:

• ESCALAR — tem campanha indo tão bem que merece mais dinheiro
• MANTER — está tudo ok, não mexa em nada por enquanto
• PAUSAR — tem campanha queimando dinheiro, desligue-a

Os cartões de KPI (os números grandes)

KPI é só um nome chique para "número importante". Cada cartão tem uma linha colorida em cima indicando se está bom. Veja o que cada um significa:

Alertas dos agentes

Logo abaixo dos números ficam os avisos recentes: cartõezinhos com borda verde (oportunidade), amarela (atenção) ou vermelha (perigo). São os mesmos avisos que chegam no seu WhatsApp (Capítulo 8).

Os gráficos

• Investimento vs Receita — duas linhas: a dourada é o que sai, a verde é o que entra. Você quer a linha verde por cima da dourada
• ROAS por campanha — barrinhas mostrando qual campanha traz mais retorno. Barra verde = ótima, vermelha = ruim
• Distribuição de Budget — uma rosquinha mostrando como o dinheiro está dividido entre as campanhas

📋 Aba Campanhas — a tabela de decisões

Aqui você vê cada campanha individualmente, como um boletim escolar: nota por nota, matéria por matéria.

A tabela de cima

Cada linha é uma campanha. As colunas mostram: gasto, ROAS, CPA, CTR, Hook Rate e Frequência (todas explicadas no Capítulo 4 e no Dicionário). Cada número aparece numa "pastilha" colorida — bateu o olho e já sabe se está bom ou ruim.

A última coluna, DECISÃO, é a nota final que o Olimpo dá para a campanha:

Os cartões de análise detalhada

Abaixo da tabela, cada campanha ganha um cartão maior com todos os números e um conselho escrito pelo agente responsável — por exemplo, o Zeus explicando por que mandou aguardar, ou a Afrodite explicando por que uma campanha de conteúdo não deve ser julgada pelo CPA.

Botão "↻ Atualizar"

Recarrega os dados na tela. Se quiser dados novinhos direto do Facebook, use o "⚡ Coletar Agora" lá do topo.

⚡ Os 7 Agentes do Olimpo

Pense nos agentes como 7 funcionários especialistas que trabalham para você. A aba "Agentes" mostra um cartão para cada um, com sua recomendação atual e os "gatilhos" — as situações em que ele entra em ação.

🗣️ Aba "Como Usar" — conversando com os agentes no Claude

Os agentes não são só cartões bonitos no painel — cada um tem uma "personalidade" escrita num arquivo de texto, e você pode conversar com eles dentro do Claude. É como dar um crachá para o Claude: "agora você é a Athena, especialista em criativos".

O passo a passo (funciona para todos os agentes)

1. Abra a pasta do projeto no seu Mac: trafego. Lá estão os arquivos promptZeus.txt, promptAthena.txt, promptAres.txt e assim por diante
2. Abra o arquivo do agente que você quer e copie todo o texto
3. Abra uma conversa nova com o Claude e cole o texto como primeira mensagem
4. Depois, conte a situação da sua campanha com os números que a aba "Como Usar" pede para aquele agente

Atalho: as skills do Claude Code

Se você estiver usando o Claude Code (o Claude no Terminal), existe um atalho: digite /zeus, /athena, /ares, /artemis, /hermes, /afrodite ou /hephaestus e o agente já é ativado sem precisar copiar e colar nada.

A aba "Como Usar" do painel

Essa aba é uma cola rápida: mostra um cartão por agente com o gatilho (quando usar), os passos e um modelinho pronto dos dados que você deve informar. Exemplo do cartão do Ares:

É só preencher os espacinhos com seus números e mandar para o agente na conversa.

📱 Alertas no WhatsApp — o Zeus te chama

Essa é a parte mais mágica do Olimpo: você não precisa ficar olhando o painel o dia inteiro. A cada coleta (de hora em hora), o Zeus analisa os números e, se algo importante acontecer, ele manda mensagem direto no seu WhatsApp.

Os tipos de mensagem que você pode receber

Regras de bom senso dos alertas

• O Zeus só analisa campanhas que já gastaram pelo menos R$20 — antes disso é cedo demais para julgar
• Ele não repete o mesmo alerta toda hora: cada tipo tem um período de silêncio (em geral 24 horas) para não encher seu WhatsApp
• Alertas urgentes de saturação podem repetir a cada 8 horas, porque são graves

Testando se o WhatsApp está funcionando

Quer conferir se a conexão está ok? Abra este endereço no navegador ou peça ao Claude para chamar:

Se tudo estiver certo, chega na hora uma mensagem "⚡ OLYMPUS — TESTE · Integração funcionando!" no número cadastrado.

🔌 Ligando os dados reais (Meta Ads)

Para o Olimpo mostrar seus números de verdade, ele precisa de duas informações — pense nelas como o endereço e a chave da sua conta de anúncios:

• meta_account — o "endereço" da sua conta de anúncios. Sempre começa com act_ seguido de números (ex: act_123456789). Você encontra esse número no Gerenciador de Anúncios do Facebook
• meta_token — a "chave" que autoriza o Olimpo a ler seus dados. É gerada no site Meta for Developers. O ideal é um token de "Usuário do Sistema" (System User), porque ele nunca vence

Onde colocar essas informações

No arquivo backend/projects.json. Cada projeto é um bloquinho assim:

Traduzindo cada campo:

• alert_phone — o WhatsApp que recebe os alertas (código do país + DDD + número, sem espaços)
• event_date — a data do evento/lançamento (alimenta o contador de dias do painel)
• product_price — o preço do seu produto
• cpa_max — o máximo que você aceita pagar por uma venda (o teto)
• cpa_viral — abaixo desse custo por venda, o Zeus grita "oportunidade viral!"

Depois de editar, reinicie o Olimpo (feche com Ctrl + C no Terminal e ligue de novo, ou systemctl restart olympus na VPS).

Ferramentas extras (endereços úteis)

Vários projetos ao mesmo tempo

O Olimpo aceita vários projetos (ex: Destrave a Fala, Imersão T21, cliente da AcessIA). Basta adicionar outro bloquinho no projects.json, com id e nome próprios. No painel, aparece o seletor de projeto no topo para alternar entre eles.

📖 Dicionário do Tráfego (de A a Z)

Todo termo estranho que aparece no painel, explicado como para uma pessoa de 12 anos. Use a lupa 🔍 lá em cima para achar direto o que procura!

Anúncio (criativo)

A peça que as pessoas veem: o vídeo, a imagem e o texto. "Criativo" é como o pessoal de marketing chama o anúncio em si.

Budget (verba)

O dinheiro reservado para os anúncios. Como a mesada da campanha: quando acaba, o anúncio para de aparecer.

Break-even (empate)

O ponto onde você não ganha nem perde: o que entrou pagou exatamente o que saiu. Tudo acima disso é lucro.

Campanha

Um "pacote" de anúncios com o mesmo objetivo. Ex: uma campanha para vender a Destrave a Fala, outra para trazer seguidores.

Conversão

Quando alguém faz o que você queria: comprou, se cadastrou, clicou no link. No Olimpo, conversão geralmente = venda.

CPA — Custo Por Aquisição

Quanto custou conseguir UMA venda. Se você gastou R$100 e fez 4 vendas, o CPA é R$25. Quanto menor, melhor.

CTR — Taxa de Cliques

De cada 100 pessoas que viram o anúncio, quantas clicaram. CTR 2% = 2 cliques a cada 100 visualizações. Mede se o anúncio chama atenção.

Escalar

Aumentar o dinheiro de uma campanha que está dando lucro, para ela vender ainda mais. Regra do Olimpo: aumente no máximo 30% por vez, senão o Facebook "se perde".

Fadiga criativa

Quando o anúncio "cansou": as pessoas já viram tanto que pararam de reagir. Sinal: CTR caindo com frequência subindo. Remédio: anúncio novo.

Fase de aprendizado

Os primeiros dias de uma campanha, quando o Facebook ainda está testando para quem mostrar. Os números oscilam — não julgue nem mexa nesse período (uns 5 dias).

Frequência

Quantas vezes a MESMA pessoa viu seu anúncio, em média. Frequência 3 = cada pessoa viu 3 vezes. Acima disso, o público começa a enjoar.

Funil

O caminho do cliente até a compra: descobrir você → se interessar → confiar → comprar. Como um escorregador que afunila: entra muita gente em cima, sai comprador embaixo.

Gerenciador de Anúncios (Ads Manager)

O painel oficial do Facebook/Instagram onde as campanhas são criadas, pausadas e editadas. O Olimpo lê os dados de lá, mas as mudanças você faz lá.

Hook Rate (taxa de gancho)

Em anúncios de vídeo: de cada 100 pessoas, quantas assistiram os 3 primeiros segundos. Mede se o começo do vídeo "fisga". Bom: 40%+. Ruim: abaixo de 15%.

Impressões

Quantas vezes o anúncio apareceu na tela de alguém. 8.000 impressões = apareceu 8 mil vezes (pode ser várias vezes para a mesma pessoa).

KPI

Sigla para "indicador-chave". Tradução honesta: os números que realmente importam. ROAS, CPA e CTR são KPIs.

Lookalike (público semelhante)

Um público que o Facebook monta procurando pessoas PARECIDAS com seus compradores. Tipo: "Facebook, ache mais gente igual a quem já comprou de mim". Precisa de 100+ compras para funcionar bem.

ManyChat

Ferramenta que responde automaticamente comentários e mensagens no Instagram. Ex: a pessoa comenta "FALA" no post e recebe o link no direct, sozinha. Quem cuida disso é o Hephaestus.

Meta Ads

A plataforma de anúncios do Facebook + Instagram (a empresa dona dos dois se chama Meta).

Pixel

Um "espiãozinho do bem" instalado no seu site que conta ao Facebook o que os visitantes fizeram: viram a página, colocaram no carrinho, compraram. Sem pixel funcionando, os números ficam cegos. Quem cuida dele é o Hermes.

Prospecção (público frio)

Anunciar para quem NUNCA ouviu falar de você. É mais caro e difícil — como se apresentar num lugar onde ninguém te conhece.

Remarketing (público quente)

Anunciar para quem JÁ te conhece: visitou o site, viu vídeo, abandonou o carrinho. Costuma ser a campanha mais lucrativa, porque a pessoa já estava quase comprando.

ROAS — Retorno Sobre Investimento em Anúncios

O número mais importante de todos: para cada R$1 investido, quantos reais voltaram. ROAS 3.0 = investiu R$1, voltaram R$3. Abaixo de 1 = prejuízo. No Olimpo, 2.5+ é sinal de escalar.

Segmentação

Escolher PARA QUEM o anúncio aparece: idade, cidade, interesses. Ex: "mulheres de 30 a 56 anos interessadas em Síndrome de Down". Especialidade da Artemis.

Token

A "chave digital" que autoriza o Olimpo a ler os dados da sua conta no Facebook. Alguns tokens vencem (aí o Olimpo avisa no WhatsApp); o de "Usuário do Sistema" dura para sempre.

Webhook

Um aviso automático entre sistemas. Ex: quando alguém compra na Hotmart, ela "cutuca" o Olimpo na hora dizendo "vendeu!". É como uma campainha entre programas.

🆘 Socorro! Problemas comuns