Integrações (Integrations)¶

O módulo de Integrações é o centro de conectividade da Brandvelia. Ele gerencia as conexões com redes de afiliados (ClickBank), plataformas de tráfego pago, webhooks em tempo real e rotas de sincronização agendadas.

O que a Central de Integrações gerencia¶

Recurso	Descrição
Aplicações Conectadas	Lista de plataformas externas e status de conectividade (ClickBank, Meta Ads, Plausible).
Webhooks em Tempo Real	Endpoints de entrada para recebimento de notificações instantâneas (INS 8.0), protegidos por rate limiting (120 req/min) no middleware.
Rotas de Cron & Sync	Execução de rotas `/api/cron/*` para reconciliação diária de QuickStats e atualização do marketplace.
Verificações de Integridade	Diagnóstico de integridade da base de dados e validação de chaves de API com um clique.

Integração Nativa ClickBank¶

A Brandvelia possui suporte completo às capacidades do ClickBank (localizadas em packages/integrations/src/clickbank/):

LinkBuilder: Construtor oficial de links de afiliados com anexação automática de extclid e sub-IDs (aff_sub1-5).
Instant Notification Service (INS 8.0): Webhook atômico com descriptografia AES-256-CBC, deduplicação rigorosa (dedup_key) e atribuição click_id → bv_visits → landing page → campanha → oferta.
QuickStats API: Consulta de relatórios agregados diários via chave única API Order Read em CLICKBANK_API_KEY_1 (CLICKBANK_API_KEY_2 opcional para uma 2ª conta) com checagem de integridade diária.
Browser Scraper Autenticado: Captura semi-automatizada da listagem completa do marketplace logado através do mini app nativo via protocolo brandvelia-capture://.
Opportunity Score: Algoritmo determinístico de pontuação multivariada (0–100) para o Radar.

Rastreamento Analítico com Plausible¶

A Brandvelia suporta integração com o Plausible Analytics para rastreamento de tráfego sem cookies invasivos: - URL de campanha vinculada ao slug da landing page; - Estatísticas detalhadas por endereço IP público, fonte de referência (referrer), navegador, sistema operacional e país.

Ciclo de Vida da Conexão¶

flowchart LR
    A[Informar Credenciais / URL] --> B[Testar Conexão / Webhook]
    B --> C[Verificar Atribuição com Teste]
    C --> D[Ativar Sincronização e Ledger]