Gaviões 24h — Agente de Tráfego

Visão Geral — Todas as Unidades

Investimento total

—

Contatos

—

Vendas

—

Custo por Contato

—

Teto: mês anterior × multiplicador

Custo por Venda

—

Teto: mês anterior

Retorno sobre Investimento

—

Mínimo: 4x

Receita prevista imediata

—

vendas × ticket médio (R$ 130,42)

Receita prevista ao longo do tempo

—

receita imediata × LTV (9,3 meses)

Evolução ao longo do tempo

Olá! Sou o agente de tráfego da Academia Gaviões 24h, treinado com o Playbook completo — Pilares 1, 2 e 3 + ciclo PDCA.

Posso diagnosticar campanhas pelo PMDO, verificar gatilhos (CPA>R$200, CPL>R$10, CTR<0,55%), orientar sobre as etapas C1–C7 e executar o checklist da agência.

O que você precisa?

Diagnosticar campanhas pelo PMDO

Qual etapa cada campanha está?

CPL acima do limite — o que fazer?

Frequência > 4 — próximos passos

Checklist semanal da agência

Como estruturar campanha pré-venda?

Gerar plano de ação corretiva

Diagnóstico PMDO — Gatilhos ativos

Cada gatilho recebe uma nota de 0–100 (quanto mais alto, mais atenção). A tabela está ordenada pela unidade que mais precisa de ação (soma das notas) → menor.

Unidade ↕	Tipo ↕	Gatilho ↕	Nota ↕	Ação recomendada
Carregando…

Aguardando dados

Análise por unidade

Selecione uma unidade para ver a análise individual

Visão geral — Todas as unidades

	Unidade ↕	Objetivo ↕	Investimento ↕	Vendas ↕	Custo/Venda ↕	Contatos ↕	Custo/Contato ↕	ROI ↕	Receita LTV ↕	Otim.
Carregando…

Estrutura de campanhas C1–C7 — 4 etapas

ETAPA 1

Geração de Audiência

~60 dias antes da inauguração

C1Reconhecimento — vídeos 15s, renders 3D, banners "Em Breve"

C2Tráfego Perfil — ativa em TODAS as etapas

ETAPA 2

Pré-Venda

~15 dias antes da inauguração

C2Tráfego Perfil (continua)

C3Mensagem WhatsApp — Lote 1

C4Virada de Lote — urgência

C5Último Lote — escassez final

ETAPA 3

Perpétuo

Pós-inauguração — operação contínua

C2Tráfego Perfil (continua)

C6Venda Direta — fotos reais + depoimentos

C7Distribuição — posts orgânicos impulsionados

ETAPA 4

Comercial

Ações esporádicas — qualquer momento

—Sazonais: Dia das Mães, Black Friday

—Promoções: Mês do Amigo, Taxa Zero

—Engajamento: Desafios, aulões, eventos

Hierarquia de gatilhos PMDO

Protocolo Mestre de Diagnóstico e Otimização

GP1

CPA > R$ 200 — Gatilho Primário 1

Agência: 24h para diagnóstico + plano de ação escrito

GP2

CPL > R$ 10 — Gatilho Primário 2

Se CTR<0,55% → criativo ruim. Se CPM>R$13,50 → audiência cara. Senão → lead mal qualificado

Frequência > 4,0 — Saturação de público

Novos criativos, expandir audiência, excluir engajados 7–15 dias — 48h

CPC > R$ 4 — Custo por clique elevado

Revisar copy e gancho, testar formatos, ajustar lances — 48h

CTR < 0,55% — Baixa relevância do criativo

Pausar anúncios, criar novos, teste A/B — 48h

⚑

Regra dos 7 dias

Se gatilho continuar após ação → escalonamento automático para o Hub

Diagnóstico de funil

▸

CPA alto + CPL alto → problema de mídia — agência ajusta

▸

CPA alto + CPL baixo → problema comercial — gestão intervém

▸

CPL bom + matrículas baixas → problema no atendimento/vendas

Como o painel calcula cada métrica

▸

Investimento (spend): campo spend da API Meta v19 — direto, sem transformação.

▸

Vendas: action_type omni_purchase (prioridade 1), com fallback para purchase e offsite_conversion.fb_pixel_purchase. Por que omni: o Gerenciador soma online + offline e usar só purchase retorna ~50% do real.

▸

Contatos: action_type onsite_conversion.messaging_conversation_started_7d (prioridade 1), fallback messaging_conversation_started. Equivale à coluna "Conversas por mensagem iniciadas" no Gerenciador. Não usar lead — retorna dados completamente diferentes.

▸

Custo/Venda (CPV): spend ÷ vendas por campanha. Se vendas = 0, CPV é nulo (não pontua o gate GP1).

▸

Custo/Contato (CPL): spend ÷ contatos por campanha. Se contatos = 0, CPL é nulo (não pontua o gate GP2).

▸

CTR, CPM, Frequência: campos diretos da API (ctr, cpm, frequency). CTR é multiplicado por 100 para virar percentual.

Tetos dinâmicos (mês anterior)

▸

Teto Custo/Venda: (spend total ÷ vendas totais do mês anterior) × multiplicador. O multiplicador é configurável em Configurações (padrão 1,5×). Se não houver dados do mês anterior, fallback = R$ 200 × multiplicador.

▸

Teto Custo/Contato: (spend ÷ contatos do mês anterior) × multiplicador. O multiplicador é configurável em Configurações (padrão 1×). Fallback: R$ 10.

▸

Por que dinâmicos: os tetos do playbook (R$ 200 e R$ 10) são referência teórica. Na prática, comparamos cada campanha contra o desempenho histórico real da própria conta.

Pontuação dos gatilhos (0–100)

Cada gatilho acionado recebe uma nota individual. Quanto maior, mais atenção. Gatilhos com nota zero não aparecem na lista. As notas são ordenadas pela criticidade do playbook: GP1 > GP2 > GS Frequência > GS CTR. Em uma campanha com vários gatilhos, o painel mostra apenas o mais crítico — clique para ver todos.

GP1 — Custo por Venda (CPV)

▸

Aciona quando (caso 1): teve venda mas cpv > teto_cpv (teto dinâmico do mês anterior × multiplicador).

▸

Aciona quando (caso 2 — pior cenário): vendas = 0 e investimento > teto_cpv. Campanha queimou um teto inteiro sem gerar venda nenhuma.

▸

Fórmula (com venda): nota = min(100, log₂(cpv ÷ teto) ÷ log₂(16) × 100).

▸

Fórmula (sem venda): nota = max(50, min(100, 50 + log₂(spend ÷ teto) ÷ log₂(16) × 50)). Começa em 50 (já é grave) e cresce até 100 conforme queima mais tetos sem retorno.

▸

Lógica: escala logarítmica em base 2. Cada dobra acima do teto vale ~25 pontos no caso com venda. 16× o teto = 100 (catastrófico).

▸

Exemplo com venda (teto R$ 200): CPV R$ 240 → 5 · R$ 300 → 15 · R$ 400 (2×) → 25 · R$ 800 (4×) → 50 · R$ 1.600 (8×) → 75 · R$ 3.200 (16×) → 100.

▸

Exemplo sem venda (teto R$ 200): spend R$ 300 → 50 · R$ 400 (2×) → 63 · R$ 800 (4×) → 75 · R$ 1.600 (8×) → 88 · R$ 3.200 (16×) → 100.

▸

Ação recomendada: agência tem 24h para diagnóstico escrito + plano de ação.

GP2 — Custo por Lead/Contato (CPL)

▸

Aciona quando: cpl > R$ 10 (teto fixo do playbook).

▸

Fórmula: nota = min(100, log₂(cpl ÷ 10) ÷ log₂(128) × 100).

▸

Lógica: escala log base 2 com saturação em 128× o teto (R$ 1.280). Cada dobra ≈ +14 pontos. Por que log: a faixa real de CPL é gigante (R$ 11 até R$ 1.280+), e linear satura cedo demais.

▸

Exemplo: R$ 11 → 1 · R$ 15 → 6 · R$ 20 → 14 · R$ 40 → 29 · R$ 80 → 43 · R$ 160 → 57 · R$ 320 → 71 · R$ 640 → 86 · R$ 1.280 → 100.

▸

Diagnóstico automático: se CTR < 0,55% → "Criativo irrelevante"; se CPM > R$ 13,50 → "Audiência cara"; senão → "Lead mal qualificado".

▸

Ação recomendada: agência tem 24h para diagnóstico escrito + plano de ação.

GS — Frequência (saturação de público)

▸

Aciona quando: frequency > 4,0.

▸

Fórmula: nota = min(100, log₂(freq ÷ 4) ÷ log₂(2) × 100) = min(100, log₂(freq ÷ 4) × 100).

▸

Lógica: a partir de 4, dobrar a frequência (8) já é catastrófico (100). Faixa real é mais estreita que CPL.

▸

Exemplo: 4,5 → 18 · 5,0 → 32 · 6,0 → 58 · 7,0 → 78 · 8,0 → 100.

▸

Ação recomendada: novos criativos, expandir audiência, excluir engajados 7–15 dias — 48h.

GS — CTR (relevância do criativo)

▸

Aciona quando: ctr < 0,55% E o gate GP2 (CPL) não está acionado para a mesma campanha (evita dupla contagem — quando CPL alto + CTR baixo, o GP2 já cobre via diagnóstico "criativo irrelevante").

▸

Fórmula: nota = min(100, ((0,55 − ctr) ÷ 0,55) × 100).

▸

Lógica: linear (não log), porque a faixa é limitada (0% a 0,55%). Mede o quanto está abaixo do limite, em percentual.

▸

Exemplo: 0,50% → 9 · 0,40% → 27 · 0,30% → 45 · 0,20% → 64 · 0,10% → 82 · 0% → 100.

▸

Ação recomendada: pausar anúncios, criar novos, teste A/B — 48h.

Cores das notas

●

0–39 (azul/âmbar suave): atenção leve, monitorar.

●

40–69 (âmbar): intervenção necessária, mas não emergencial.

●

70–100 (vermelho): crítico — ação imediata.

Ciclo PDCA

PLAN

▸Mapeamento de etapa por unidade

▸Campanhas C1–C7 a ativar

▸Orçamento e distribuição

▸Calendário e datas

▸Briefing de criativos

▸Setup técnico ≤10 dias úteis

▸Lançamento conforme Pilar 1

▸Monitoramento diário

▸1 teste A/B/semana/unidade

▸Planilha até 12h do dia seguinte

CHECK

▸Check semanal — toda segunda

▸Quinzenal — reunião 30–45min

▸Mensal — comparativo completo

▸Análise de funil completo

▸Top 3 e Bottom 3 unidades

ACT

▸GP1/GP2 → 24h diagnóstico

▸Secundários → 48h ação

▸Regra 7 dias → escalonamento

▸Plano por escrito obrigatório

▸Aprendizados → banco criativos

Escalonamento

Nível 1
0–48h

Agência resolveIdentifica, corrige, documenta e comunica o Hub.

Nível 2
48h–7 dias

Hub intervémRevisão conjunta. Hub pode exigir mudanças. Deadline: +7 dias.

Nível 3
14+ dias

Ary decideWARNING (30 dias última chance) ou SUBSTITUIÇÃO.

Avaliação trimestral da agência

Performance

50%

▸CPA < R$ 200

▸CPL < R$ 10

▸Meta de matrículas atingida

▸Evolução mês a mês positiva

Compliance

30%

▸Planilha diária até 12h

▸Relatórios quinzenais e mensais

▸SLAs de escalonamento

▸Setup técnico correto

Proatividade

20%

▸Melhorias espontâneas

▸A/B além do mínimo

▸Benchmarks de mercado

▸Otimizações proativas

Resultado possível

✓

CONTINUA — performance dentro ou acima do esperado

⚠

WARNING — 1+ critérios abaixo. Plano de melhoria 30 dias.

✗

SUBSTITUIÇÃO — 2 warnings consecutivos ou falha crítica.

Parâmetros do negócio

Esses valores são usados nos cálculos de receita e ROI da aba Unidades. Ficam salvos no navegador.

Ticket Médio (R$)

Valor médio de cada venda. Usado em: Receita prevista imediata = vendas × ticket médio

LTV — Tempo de permanência (meses)

Quanto tempo o aluno fica na unidade, em meses. Usado em: Receita ao longo do tempo = receita imediata × LTV

Multiplicador Custo por Contato (×)

Teto = (custo por contato do mês anterior) × este multiplicador. Deixe vazio para usar 1× (igual ao mês anterior).

Multiplicador Custo por Venda (×)

Teto = (custo por venda do mês anterior) × este multiplicador. Deixe vazio para usar 1,5× (padrão).

ROI Mínimo (x)

Retorno mínimo sobre investimento. Abaixo disso, gatilho de alerta.

Ignorar campanhas que contém

Termos separados por vírgula. Campanhas cujo nome contenha qualquer um destes termos serão ignoradas em todo o sistema (PMDO, Unidades, totais, IA). Deixe vazio para não ignorar nada.

Nota: Os tetos de Custo por Contato (custo do mês anterior × multiplicador configurável acima) e Custo por Venda (custo do mês anterior × multiplicador, padrão 1,5×) são dinâmicos — puxados automaticamente do Meta Ads.

Gestão de usuários

Apenas usuários ADM podem gerenciar acessos. Os 3 níveis disponíveis: LEITURA e EDIÇÃO veem tudo no painel mas não acessam Configurações. ADM tem acesso total.

Adicionar novo usuário

Usuários cadastrados

Usuário	Nível	Criado em	Ações
Carregando…

Documentação técnica — Mapeamento de dados

Fonte dos dados Todos os dados exibidos neste painel vêm diretamente da Meta Graph API v19.0, a mesma API que alimenta o Gerenciador de Anúncios do Meta. Nenhum dado é estimado, simulado ou inserido manualmente. O Worker (backend) faz as chamadas autenticadas e repassa os dados brutos para o frontend.

Colunas do Dashboard e Campanhas

Investimento

▸

Campo da API: spend
Valor total gasto na campanha no período selecionado. Equivale à coluna "Valor usado" no Gerenciador de Anúncios.
Tipo: valor direto (sem cálculo)

Vendas (Compras)

▸

Campo da API: actions → busca por action_type
Tipos aceitos (por prioridade):
1. omni_purchase — compras omnichannel (online + loja física). Este é o tipo principal usado pelo Meta no Gerenciador de Anúncios quando a coluna "Compras" está configurada.
2. purchase — compras online (Pixel/CAPI)
3. offsite_conversion.fb_pixel_purchase — compras registradas pelo Pixel do Facebook

Lógica: o sistema busca o primeiro tipo encontrado nessa ordem. O omni_purchase é a soma de todas as compras (online + offline), por isso bate com o Gerenciador de Anúncios.
Tipo: valor direto do campo value da action encontrada

Custo por Venda

▸

Cálculo: spend ÷ vendas
Investimento total dividido pelo número de compras (omni_purchase). Equivale à coluna "Custo por compra" no Gerenciador de Anúncios.
Alerta vermelho: quando ultrapassa R$ 200 (referência do Playbook Gaviões)

Contatos (Conversas)

▸

Campo da API: actions → busca por action_type
Tipos aceitos (por prioridade):
1. onsite_conversion.messaging_conversation_started_7d — conversas iniciadas via Messenger/WhatsApp/Instagram Direct nos últimos 7 dias após ver o anúncio
2. messaging_conversation_started — conversas iniciadas (formato alternativo)

Lógica: busca o primeiro tipo encontrado. Equivale à coluna "Conversas por mensagem iniciadas" no Gerenciador de Anúncios.
Tipo: valor direto do campo value da action encontrada

Custo por Contato

▸

Cálculo: spend ÷ contatos
Investimento total dividido pelo número de conversas iniciadas. Equivale à coluna "Custo por conversa por mensagem iniciada" no Gerenciador de Anúncios.
Alerta vermelho: quando ultrapassa R$ 10 (limite do Playbook Gaviões)

Cards de métricas (topo do Dashboard)

▸

Investimento total: soma de spend de todas as campanhas ativas

▸

Vendas: soma de omni_purchase de todas as campanhas ativas

▸

Custo por Venda: investimento total ÷ vendas totais

▸

Custo por Contato: investimento total ÷ contatos totais

Filtros aplicados

▸

Status: apenas campanhas com effective_status = ACTIVE

▸

Limite: até 100 campanhas por requisição

▸

Períodos disponíveis: last_7d (7 dias), last_30d (30 dias), last_90d (90 dias)

▸

Endpoint: GET /{ad_account}/campaigns com insights.date_preset()

Diagnóstico PMDO — Gatilhos automáticos

▸

CPL > R$ 10 (GP2): usa spend ÷ contatos por campanha. Diagnóstico automático: se CTR < 0,55% → criativo ruim; se CPM > R$ 13,50 → audiência cara; senão → lead mal qualificado

▸

Frequência > 4,0 (GS): usa campo frequency da API. Indica saturação de público.

▸

CTR < 0,55% (GS): usa campo ctr da API (multiplicado por 100 para percentual). Indica baixa relevância do criativo.

Arquitetura técnica

▸

Frontend: gavioes-painel.pages.dev — Cloudflare Pages (HTML estático)

▸

Backend: gavioes-agente-trafego.arijguariza.workers.dev — Cloudflare Worker

▸

Segurança: token Meta e chave Anthropic ficam como secrets no Worker. Nunca expostos no frontend. Login com JWT (8h de expiração).

▸

Chat IA: usa Claude Sonnet via API Anthropic, com system prompt do Playbook Gaviões (Pilares 1, 2, 3 + PDCA)

▸

API do Meta: Graph API v19.0 — chamadas autenticadas pelo Worker com token de usuário do sistema (BM)