Configurações

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

Integrações

Meta Ads

Desconectado

OAuth do Facebook Business para puxar contas, campanhas, conjuntos, anúncios e insights diários.

— Em V2: fluxo OAuth via /api/integrations/meta/connect.
— App ID/Secret virão do .env (META_APP_ID/META_APP_SECRET).
— Tokens são armazenados encriptados em Integration.config.

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.

ANTHROPIC_API_KEY

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.

Mapeamento campanha → produto

Por que isso importa

Sem mapeamento, a regra de ROI mínimo não consegue se aplicar — a campanha vira "Sem mapeamento". Esse painel é onde se diz "essa campanha vende esse produto".

Em V2 — quando a Meta estiver conectada e novas campanhas chegarem, esse painel pede pra mapear cada uma a um produto/oferta.