Configurações

Conexões com Meta Ads, Guru e Claude. Mapeamento de campanha → produto e regras de classificação.

Integrações

Meta Ads · Read-only
Conectado
OAuth somente leitura. Importa ad accounts, campaigns, ad sets, ads e insights diários (spend / impressions / clicks / reach / CTR / CPC / CPM). Não pausa, não edita, não cria nada.
OAuth configurado
Conectado
read-only · sync por conta
Conectado como: Felipe Rosalen
Último sync: 09/07/2026, 08:50:21
1. Contas de anúncio (42)
2. Sincronizar conta selecionada

Cada etapa é 1 request independente. Se uma etapa de 7d ou 3d falhar (timeout 504), o sistema re-divide aquela janela em etapas de 1 dia automaticamente. Conta que ainda timeouta: use o modo Seguro. 1 conta por vez; repita pra cada conta.

Sync manual consome cota da Meta/Netlify — evite repetir em poucos minutos. Há cooldown de 30 min por conta.

Read-only: ads_read + business_management. Token AES-256-GCM via ENCRYPTION_KEY. Sync é por conta pra não estourar timeout — repita pra cada conta.

Guru · Webhook (fonte primária)
URL ok
Secret 64c
Vendas, refunds e mudanças de status chegam em tempo real via POST /api/webhooks/guru. Idempotente por transactionId. Toda chegada vira um IngestionEvent auditável.
Configurar webhook + ver eventos
  • — URL e status do secret no painel /imports.
  • — Sync via API (REST paginada) chegará em V2 pra backfill histórico.
  • — Google Sheets fica como reconciliação diária (V2.1) — não substitui o webhook.
Claude (análise IA)
Mock V1
V1 gera sugestões a partir de regras locais sobre os dados seedados. V2 substitui por chamada real ao Anthropic API com contexto do dashboard atual.

Configurável via .env. Quando preenchida na V2, o painel Análises Claude passa a chamar a API real.

Regras

ROI mínimo por tipo de oferta
Régua usada para classificar campanhas como saudáveis, atenção ou investigar.
Low ticket1.20x
Bump (low ticket)1.20x
Evento / ingresso1.20x
Bump (evento)1.20x
Recorrência1.50x
Backend2.00x

Editáveis na V2 (formulário com validação + auditoria). Hoje vivem emlib/analytics/calc.ts.

Mapeamentos

Escopos isolados
Operações que precisam de métricas próprias, mas não devem somar no consolidado nem no expert principal.
Abrir escopos isolados
Produtos Guru → Expert + Produto interno
Cada produto que chega via webhook precisa ser ligado a um Expert + Produto interno (categoria, papel no funil, ativo/inativo). Sem mapeamento, vendas aparecem como "Expert: —" e não contam no dashboard.
Abrir mapeamento de produtosConferir produto + bumps no Guru

Inclui backfill automático: ao mapear, vendas antigas daquele produto ganham expertId + productId retroativamente. A conferência é read-only e ajuda a separar produto vendido, variação de oferta e bump associado.

Campanha Meta → Expert + Produto
Quando uma campanha tem gasto mas a venda não casa por UTM, ligue manualmente a um Expert + Produto. Gera ROI estimado agregado (rotulado "mapping manual"). Não altera vendas Guru.
Abrir mapeamento de campanhas