cdp-edge 2.3.8 → 2.5.1

package/extracted-skill/tracking-events-generator/models/quiz-funnel.md

@@ -1,15 +1,15 @@
 # Modelo: Quiz Funnel (Cloudflare Native)
 
-Este modelo é destinado a funis de quiz, onde o usuário responde a uma série de perguntas antes de ser redirecionado para a oferta final. O rastreamento foca na progressão do usuário e na captura de dados intermediários.
+Este modelo é destinado a funis de quiz, onde o usuário responde a uma série de perguntas antes de ser redirecionado para a oferta final. O rastreamento foca na progressão do usuário e na **qualificação automática de intenção via Workers AI**.
 
 ---
 
 ## 🏗️ ARQUITETURA TÉCNICA (Quantum Tier)
 
-O rastreamento segue a lógica de micro-eventos:
+O rastreamento segue a lógica de micro-eventos + scoring automático:
 1. **Página**: Dispara um evento a cada resposta dada no quiz via `cdpTrack.track()`.
-2. **Servidor (Worker)**: Recebe e armazena o progresso no banco D1.
-3. **Database (D1)**: Mantém o histórico de respostas vinculado ao `track_user_id`.
+2. **Servidor (Worker)**: Ao receber `QuizComplete`, envia as respostas ao **Quiz Scoring Engine** (Granite 4.0 Micro) que classifica o respondente.
+3. **Pipeline CDP**: A qualificação (`comprador | interessado | curioso | perdido`) é injetada como `intentionLevel` e flui automaticamente para LTV Prediction, Meta Signal Score, D1 e CAPI dispatch.
 
 ---
 
@@ -19,50 +19,114 @@ O rastreamento segue a lógica de micro-eventos:
 |---|---|---|
 | **QuizStart** | Início do quiz | `quiz_name`, `source` |
 | **QuizAnswer** | Resposta a uma pergunta | `question`, `answer`, `step` |
-| **QuizComplete** | Finalização do quiz | `result`, `completion_time` |
+| **QuizComplete** | Finalização + qualificação AI | `quiz_name`, `quiz_answers[]`, `result` |
+
+---
+
+## 🤖 QUALIFICAÇÃO AUTOMÁTICA (Quiz Scoring Engine — Fase 6)
+
+Ao receber `QuizComplete` com `quiz_answers`, o Worker classifica automaticamente:
+
+| Qualificação | Significado | intent_score |
+|---|---|---|
+| **comprador** | Pronto para comprar agora | 0.80–1.00 |
+| **interessado** | Interesse real, avaliando | 0.50–0.79 |
+| **curioso** | Pesquisando, sem urgência | 0.20–0.49 |
+| **perdido** | Fora do público, sem fit | 0.00–0.19 |
+
+O `intent_score` resultante:
+- Alimenta o **LTV Prediction** (comprador → LTV High automaticamente)
+- Compõe o **Meta Signal Score** (pesos dinâmicos por funil)
+- Persiste em `leads.intention_level` e `quiz_sessions` no D1
+- É enviado como `custom_data` para Meta CAPI, GA4 e TikTok
 
 ---
 
 ## 🛠️ PASSO 1: CONFIGURAÇÃO DO SITE
 
 ### 1.1 Rastreamento de Respostas
-Integre este código na lógica de clique do seu quiz.
+Acumule as respostas do quiz em um array local.
 
 ```javascript
-// Exemplo de captura de resposta
+const quizAnswers = [];
+
 function onResponder(pergunta, resposta, etapa) {
+  // Armazena localmente para enviar no QuizComplete
+  quizAnswers.push({ question: pergunta, answer: resposta, step: etapa });
+
+  // Dispara micro-evento por resposta (opcional, para análise granular)
   cdpTrack.track('QuizAnswer', {
     question: pergunta,
     answer: resposta,
     step: etapa,
-    event_id: cdpTrack.generateId()
+    event_id: cdpTrack.generateId(),
   });
 }
 ```
 
-### 1.2 Finalização do Quiz
-Disparar ao chegar no resultado final ou na página de captura pós-quiz.
+### 1.2 Finalização do Quiz — com qualificação AI automática
+Envie todas as respostas no `QuizComplete`. O Worker qualifica automaticamente.
 
 ```javascript
 cdpTrack.track('QuizComplete', {
-  result: 'Perfil_A',
-  event_id: cdpTrack.generateId()
+  quiz_name: 'Diagnóstico de Perfil',   // nome para o dashboard
+  quiz_answers: quizAnswers,             // array com todas as respostas
+  result: 'Perfil_A',                   // resultado exibido ao usuário (opcional)
+  event_id: cdpTrack.generateId(),
 });
 ```
 
+### 1.3 Resposta do Worker
+O endpoint `/track` retorna a qualificação para uso imediato no front:
+
+```json
+{
+  "ok": true,
+  "userProfile": {
+    "score": 87,
+    "user_id": "uuid-xxx"
+  },
+  "quiz_qualification": "comprador",
+  "quiz_confidence": 0.91,
+  "quiz_signals": ["quero comprar", "tenho budget", "agora"],
+  "intent_score": 0.92,
+  "intent_bucket": "high"
+}
+```
+
+Use esses campos para personalizar o redirecionamento pós-quiz no front-end.
+
 ---
 
 ## ⚡ PASSO 2: SERVIDOR (CLOUDFLARE WORKER)
 
-O Worker realiza:
-- **Agregação**: O `user_id` permite que todas as respostas sejam vinculadas a um único perfil no banco D1.
-- **Enriquecimento**: Se o usuário deixar o e-mail no final, todas as respostas anteriores são associadas ao e-mail para a CAPI.
-- **API Dispatch**: Envio de eventos customizados para Meta e TikTok para otimização de público.
+O Worker realiza automaticamente na ordem:
+
+1. **Quiz Scoring Engine**: Granite 4.0 Micro classifica as respostas → `qualification` + `intent_score`
+2. **LTV Prediction**: usa `intentionLevel = 'comprador'` → LTV High → valor previsto em BRL
+3. **Meta Signal Score**: `intent_score` compõe o score composto (intent × ltv × distância)
+4. **D1 Writes**: `quiz_sessions` + `leads.intention_level` + `user_profiles.cohort_label`
+5. **CAPI Dispatch**: Meta/GA4/TikTok recebem evento com `custom_data.intention = 'comprador'`
+
+---
+
+## 🔀 FALLBACK HEURÍSTICO
+
+Se Workers AI estiver indisponível (timeout, cold start), o sistema usa correspondência de palavras-chave:
+
+- `comprador`: "quero", "comprar", "agora", "tenho interesse", "quanto custa"
+- `interessado`: "talvez", "pensando", "em breve", "estou avaliando"
+- `curioso`: "só olhando", "pesquisando", "curiosidade"
+- `perdido`: "não entendi", "errei aqui", "não é para mim"
+
+O campo `quiz_source` indica `"ai"` ou `"heuristic"` para auditoria.
 
 ---
 
 ## ✅ VALIDAÇÃO TÉCNICA
 
-- **Persistência**: Verifique no banco D1 se a jornada do usuário está sendo gravada passo a passo.
-- **Deduplicação**: O `event_id` único por resposta evita contagens duplicadas.
-- **Match Quality**: A vinculação tardia do e-mail com as respostas iniciais aumenta a precisão da atribuição.
+- **Persistência**: `quiz_sessions` no D1 — jornada completa por `user_id`
+- **Deduplicação**: `event_id` único por evento evita contagens duplicadas
+- **Enriquecimento retroativo**: e-mail preenchido pós-quiz associa todas as respostas ao perfil
+- **Match Quality**: `comprador` com e-mail → score máximo na CAPI Meta
+- **VIEW de dashboard**: `v_quiz_qualification_summary` — distribuição de qualificações por quiz

package/extracted-skill/tracking-events-generator/tracking.config.js

@@ -10,9 +10,9 @@
 const CONFIG = {
   // ── Endpoint do Cloudflare Worker ────────────────────────────────────────────
   // Same-domain: evita ad-blockers e CORS.
-  // Em produção: seu-dominio.com.br/api/tracking (Worker roteado)
-  // Em dev: use o URL do Worker diretamente
-  endpoint: '/api/tracking',
+  // Em produção: seu-dominio.com.br/track (Worker roteado via Custom Domain)
+  // Em dev: use o URL do Worker diretamente (ex: https://worker.seu-dominio.workers.dev/track)
+  endpoint: '/track',
 
   // ── Plataformas de checkout habilitadas ──────────────────────────────────────
   // Controla quais plataformas recebem passCheckoutParams() automaticamente.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "2.3.8",
+  "version": "2.5.1",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",
@@ -15,6 +15,7 @@
     "contracts",
     "extracted-skill",
     "server-edge-tracker",
+    "scripts/build-sdk.js",
     "docs",
     "README.md"
   ],
@@ -35,6 +36,8 @@
     "agents:sync": "node scripts/sync-agents.js",
     "agents:sync:list": "node scripts/sync-agents.js --list",
     "agents:sync:all": "node scripts/sync-agents.js --apply-all",
+    "sdk:build": "node scripts/build-sdk.js",
+    "sdk:build:debug": "node scripts/build-sdk.js --debug",
     "typecheck": "tsc --noEmit"
   },
   "keywords": [
@@ -79,6 +82,7 @@
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/node": "^20.19.39",
+    "esbuild": "^0.28.0",
     "semantic-release": "^25.0.3",
     "typescript": "^6.0.2"
   }

package/scripts/build-sdk.js

@@ -0,0 +1,106 @@
+/**
+ * CDP Edge — SDK Build Script
+ *
+ * Gera cdpTrack.min.js: bundle único pronto para <script src=""> em qualquer site.
+ * Entrada: extracted-skill/tracking-events-generator/cdpTrack.js (ES Module)
+ * Saída:   dist/sdk/cdpTrack.min.js   — minificado (produção)
+ *          dist/sdk/cdpTrack.js       — legível (debug)
+ *
+ * Uso:
+ *   node scripts/build-sdk.js
+ *   node scripts/build-sdk.js --debug   (só versão legível)
+ */
+
+import { build } from 'esbuild';
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+const SDK_DIR = resolve(ROOT, 'extracted-skill/tracking-events-generator');
+const OUT_DIR = resolve(ROOT, 'dist/sdk');
+
+const debugOnly = process.argv.includes('--debug');
+
+// Garante que o diretório de saída existe
+mkdirSync(OUT_DIR, { recursive: true });
+
+// ── Banner do bundle ──────────────────────────────────────────────────────────
+const pkg = JSON.parse(readFileSync(resolve(ROOT, 'package.json'), 'utf-8'));
+const banner = `/*!
+ * CDP Edge SDK v${pkg.version}
+ * (c) ${new Date().getFullYear()} CDP Edge — Quantum Tracking
+ * Gerado em: ${new Date().toISOString()}
+ * Endpoint padrão: /track (mesmo domínio — anti-adblock)
+ */`;
+
+// ── Configuração base do esbuild ──────────────────────────────────────────────
+const baseConfig = {
+  entryPoints: [resolve(SDK_DIR, 'cdpTrack.js')],
+  bundle: true,
+  format: 'iife',           // <script> tag — expõe window.cdpTrack
+  globalName: 'cdpTrack',   // window.cdpTrack após carregar
+  platform: 'browser',
+  target: ['es2018'],       // suporta Safari 12+, Chrome 69+, Firefox 62+
+  banner: { js: banner },
+  define: {
+    'process.env.NODE_ENV': '"production"',
+  },
+  // Resolve módulos locais pelo diretório do SDK
+  absWorkingDir: SDK_DIR,
+};
+
+async function buildSDK() {
+  console.log('🏗️  Buildando CDP Edge SDK...\n');
+
+  // ── Versão debug (legível) ────────────────────────────────────────────────
+  console.log('📦 Gerando cdpTrack.js (debug)...');
+  await build({
+    ...baseConfig,
+    outfile: resolve(OUT_DIR, 'cdpTrack.js'),
+    minify: false,
+    sourcemap: false,
+  });
+  const debugSize = (readFileSync(resolve(OUT_DIR, 'cdpTrack.js')).length / 1024).toFixed(1);
+  console.log(`   ✓ dist/sdk/cdpTrack.js — ${debugSize} kB`);
+
+  if (!debugOnly) {
+    // ── Versão produção (minificada) ────────────────────────────────────────
+    console.log('📦 Gerando cdpTrack.min.js (produção)...');
+    await build({
+      ...baseConfig,
+      outfile: resolve(OUT_DIR, 'cdpTrack.min.js'),
+      minify: true,
+      sourcemap: false,
+    });
+    const minSize = (readFileSync(resolve(OUT_DIR, 'cdpTrack.min.js')).length / 1024).toFixed(1);
+    console.log(`   ✓ dist/sdk/cdpTrack.min.js — ${minSize} kB`);
+  }
+
+  // ── Gera snippet de instalação ────────────────────────────────────────────
+  const snippet = `<!-- CDP Edge SDK v${pkg.version} — instalar antes do </body> -->
+<script src="/cdpTrack.min.js"></script>
+<script>
+  // Inicializar após carregar
+  document.addEventListener('DOMContentLoaded', function() {
+    if (window.cdpTrack && window.cdpTrack.init) {
+      window.cdpTrack.init();
+    }
+  });
+</script>`;
+
+  writeFileSync(resolve(OUT_DIR, 'install-snippet.html'), snippet, 'utf-8');
+  console.log(`   ✓ dist/sdk/install-snippet.html — snippet de instalação\n`);
+
+  console.log('✅ SDK build concluído!');
+  console.log('\n📋 Próximos passos para o cliente:');
+  console.log('   1. Copiar dist/sdk/cdpTrack.min.js para a raiz do site');
+  console.log('   2. Adicionar snippet de dist/sdk/install-snippet.html antes de </body>');
+  console.log('   3. O Worker deve estar no mesmo domínio (Custom Domain Cloudflare → /track)\n');
+}
+
+buildSDK().catch(err => {
+  console.error('❌ Build falhou:', err.message);
+  process.exit(1);
+});

package/server-edge-tracker/index.ts

@@ -101,6 +101,15 @@ import {
   handleFraudStats,
 } from './modules/ml/fraud';
 
+// ── Quiz Scoring Engine (Fase 6) ──────────────────────────────────────────────
+import {
+  scoreQuizAnswers,
+  saveQuizSession,
+} from './modules/ml/quiz';
+
+// ── Nurture Engine (Fase 7) ───────────────────────────────────────────────────
+import { scheduleNurture } from './modules/nurture';
+
 // ── Intelligence Agent (Cron) ─────────────────────────────────────────────────
 import {
   runIntelligenceAgent,
@@ -246,6 +255,99 @@ export default {
       }, null, 2), { headers });
     }
 
+    // ── GET /validate-install ─────────────────────────────────────────────────
+    // Endpoint de diagnóstico pós-deploy. Chamado por `cdp-edge validate <url>`.
+    // Testa D1 write/read, KV, AI e retorna relatório estruturado.
+    // Protegido: só aceita requisições com header CDP-Validate: 1
+    if (request.method === 'GET' && url.pathname === '/validate-install') {
+      if (request.headers.get('CDP-Validate') !== '1') {
+        return new Response(JSON.stringify({ error: 'Unauthorized' }), { status: 401, headers });
+      }
+
+      const report: Record<string, { ok: boolean; detail: string }> = {};
+
+      // 1. D1 write + read
+      try {
+        const testId = `__cdp_validate_${Date.now()}__`;
+        await env.DB?.prepare(
+          `INSERT OR REPLACE INTO events (event_id, event_name, user_id, created_at)
+           VALUES (?, '__validate__', '__validate__', datetime('now'))`
+        ).bind(testId).run();
+        const row = await env.DB?.prepare(
+          `SELECT event_id FROM events WHERE event_id = ?`
+        ).bind(testId).first();
+        await env.DB?.prepare(`DELETE FROM events WHERE event_id = ?`).bind(testId).run();
+        report.d1 = { ok: !!row, detail: row ? 'write+read+delete OK' : 'row not found after insert' };
+      } catch (err: any) {
+        report.d1 = { ok: false, detail: err?.message || String(err) };
+      }
+
+      // 2. KV read/write
+      try {
+        await env.GEO_CACHE?.put('__cdp_validate__', '1', { expirationTtl: 60 });
+        const val = await env.GEO_CACHE?.get('__cdp_validate__');
+        report.kv = { ok: val === '1', detail: val === '1' ? 'write+read OK' : 'value mismatch' };
+      } catch (err: any) {
+        report.kv = { ok: false, detail: err?.message || String(err) };
+      }
+
+      // 3. Workers AI
+      try {
+        await env.AI?.run('@cf/ibm-granite/granite-4.0-h-micro', {
+          messages: [{ role: 'user', content: 'ping' }],
+          max_tokens: 1,
+        });
+        report.ai = { ok: true, detail: 'Granite 4.0 Micro respondeu' };
+      } catch (err: any) {
+        report.ai = { ok: false, detail: err?.message || String(err) };
+      }
+
+      // 4. Secrets críticos
+      const missing: string[] = [];
+      if (!env.META_PIXEL_ID)      missing.push('META_PIXEL_ID');
+      if (!env.META_ACCESS_TOKEN)  missing.push('META_ACCESS_TOKEN');
+      if (!env.SITE_DOMAIN)        missing.push('SITE_DOMAIN');
+      report.secrets = {
+        ok: missing.length === 0,
+        detail: missing.length === 0 ? 'todos os secrets críticos configurados' : `MISSING: ${missing.join(', ')}`,
+      };
+
+      // 5. /track endpoint (auto-teste)
+      const trackTest = { ok: false, detail: '' };
+      try {
+        const testPayload = {
+          eventName: 'PageView',
+          userId: '__cdp_validate__',
+          pageUrl: `https://${env.SITE_DOMAIN || 'validate.test'}/`,
+          userAgent: request.headers.get('User-Agent') || '',
+          ip: request.headers.get('CF-Connecting-IP') || '',
+          _validate: true,
+        };
+        const internalReq = new Request(`https://${env.SITE_DOMAIN || 'localhost'}/track`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json', 'CDP-Validate': '1' },
+          body: JSON.stringify(testPayload),
+        });
+        // Não chama fetch externo — apenas verifica que o payload seria aceito
+        const hasRequired = testPayload.eventName && testPayload.userId;
+        trackTest.ok = !!hasRequired;
+        trackTest.detail = hasRequired ? 'payload de teste válido (eventName + userId presentes)' : 'payload inválido';
+      } catch (err: any) {
+        trackTest.detail = err?.message || String(err);
+      }
+      report.track_endpoint = trackTest;
+
+      const allOk = Object.values(report).every(r => r.ok);
+      return new Response(JSON.stringify({
+        status: allOk ? 'ok' : 'degraded',
+        timestamp: new Date().toISOString(),
+        checks: report,
+      }, null, 2), {
+        status: allOk ? 200 : 207,
+        headers,
+      });
+    }
+
     // ── POST /track ───────────────────────────────────────────────────────────
     if (request.method === 'POST' && url.pathname === '/track') {
       // Reject oversized payloads before reading body (64 KB limit)
@@ -272,6 +374,27 @@ export default {
       const { eventName, behavioral_data, ...payload } = body as { eventName?: string; behavioral_data?: BehavioralData; [key: string]: any };
       const trackPayload: TrackPayload = payload;
 
+      // ── Extrair click_ids e utms de sub-objetos (formato cdpTrack.js) ────────
+      // cdpTrack.js envia fbp/fbc/fbclid dentro de click_ids{} e UTMs dentro de utms{}
+      // O Worker trabalha com campos no nível raiz — esta extração resolve o mismatch.
+      if (payload.click_ids && typeof payload.click_ids === 'object') {
+        const c = payload.click_ids as Record<string, string>;
+        if (!trackPayload.fbp    && c.fbp)    trackPayload.fbp    = c.fbp;
+        if (!trackPayload.fbc    && c.fbc)    trackPayload.fbc    = c.fbc;
+        if (!trackPayload.fbclid && c.fbclid) trackPayload.fbclid = c.fbclid;
+        if (!trackPayload.gclid  && c.gclid)  trackPayload.gclid  = c.gclid;
+        if (!trackPayload.ttclid && c.ttclid) trackPayload.ttclid = c.ttclid;
+        if (!trackPayload.ttp    && c.ttp)    trackPayload.ttp    = c.ttp;    // TikTok Pixel cookie
+      }
+      if (payload.utms && typeof payload.utms === 'object') {
+        const u = payload.utms as Record<string, string>;
+        if (!trackPayload.utmSource   && u.utm_source)   trackPayload.utmSource   = u.utm_source;
+        if (!trackPayload.utmMedium   && u.utm_medium)   trackPayload.utmMedium   = u.utm_medium;
+        if (!trackPayload.utmCampaign && u.utm_campaign) trackPayload.utmCampaign = u.utm_campaign;
+        if (!trackPayload.utmContent  && u.utm_content)  trackPayload.utmContent  = u.utm_content;
+        if (!trackPayload.utmTerm     && u.utm_term)     trackPayload.utmTerm     = u.utm_term;
+      }
+
       // ── Validação de eventName ────────────────────────────────────────
       if (!eventName) {
         return new Response(JSON.stringify({ error: 'eventName é obrigatório' }), { status: 400, headers });
@@ -286,7 +409,7 @@ export default {
 
       const SANITIZE_FIELDS: Record<string, (val: string) => SanitizeResult> = {
         email: (val: string) => {
-          if (!isValidEmail(val)) return { error: 'email inválido (formato incorreto)' };
+          if (!isValidEmail(val)) return { error: 'email inválido (formato incorreto)', sanitized: null };
           return { sanitized: val.toLowerCase().trim() };
         },
         firstName: (val: string) => ({ sanitized: sanitizeString(val, 100) }),
@@ -297,11 +420,11 @@ export default {
         dob: (val: string) => ({ sanitized: sanitizeString(val, 20) }),
         productName: (val: string) => ({ sanitized: sanitizeString(val, 200) }),
         pageUrl: (val: string) => {
-          if (!isValidUrl(val)) return { error: 'pageUrl inválido (formato incorreto)' };
+          if (!isValidUrl(val)) return { error: 'pageUrl inválido (formato incorreto)', sanitized: null };
           return { sanitized: val.trim() };
         },
         currency: (val: string) => {
-          if (!isValidCurrency(val)) return { error: 'currency inválido (deve ser código ISO 4217)' };
+          if (!isValidCurrency(val)) return { error: 'currency inválido (deve ser código ISO 4217)', sanitized: null };
           return { sanitized: val.trim().toUpperCase() };
         },
       };
@@ -360,6 +483,14 @@ export default {
         }
       }
 
+      // ── fbc derivado de fbclid ───────────────────────────────────────────
+      // Quando o usuário vem de um clique Meta, fbclid chega na URL e o cdpTrack.js
+      // o envia como campo. O CAPI espera fbc no formato fb.1.{ms}.{fbclid}.
+      // Sem essa conversão, o sinal de clique some — EMQ cai e deduplicação piora.
+      if (trackPayload.fbclid && !trackPayload.fbc) {
+        trackPayload.fbc = `fb.1.${Date.now()}.${trackPayload.fbclid}`;
+      }
+
       // ── Validação de Valor Numérico ───────────────────────────────────
       if (trackPayload.value !== undefined && trackPayload.value !== null) {
         if (!isValidValue(trackPayload.value)) {
@@ -519,8 +650,46 @@ export default {
                                        distKm < 60 ? 'moderate'   : 'far';
       }
 
+      // ── Quiz Scoring Engine (Fase 6) ─────────────────────────────────────
+      // Roda antes do LTV para que intentionLevel qualificado alimente a predição.
+      // O front envia quiz_answers: [{question, answer, step}] junto com QuizComplete.
+      if (eventName === 'QuizComplete' && Array.isArray(payload.quiz_answers) && payload.quiz_answers.length > 0) {
+        try {
+          const quizResult = await scoreQuizAnswers(env, payload.quiz_answers, payload.quiz_name ?? null);
+
+          // Injeta qualificação no payload — flui para LTV, Meta Signal, D1 e CAPI
+          payload.intentionLevel  = quizResult.qualification;
+          payload.intent_score    = quizResult.intent_score;
+          payload.intentScoreNum  = quizResult.intent_score;
+          payload.intent_bucket   = quizResult.intent_score >= 0.8 ? 'high'
+                                  : quizResult.intent_score >= 0.5 ? 'medium' : 'low';
+
+          // Campos extras para auditoria e dashboard
+          (payload as any).quiz_qualification      = quizResult.qualification;
+          (payload as any).quiz_confidence         = quizResult.confidence;
+          (payload as any).quiz_weighted_score     = quizResult.weighted_score;
+          (payload as any).quiz_dominant_dimension = quizResult.dominant_dimension;
+          (payload as any).quiz_signals            = quizResult.dimensions.map((d: any) => d.signal).filter(Boolean);
+          (payload as any).quiz_source             = quizResult.source;
+
+          // utm_term — injetado pelo Worker após qualificação (nunca configurado nos anúncios)
+          // Flui para Meta CAPI custom_data e D1 user_profiles para cruzar com ROAS Feedback
+          payload.utmTerm = quizResult.qualification;  // comprador | interessado | curioso | perdido
+
+          // Persiste sessão no D1 em background
+          if (env.DB) ctx.waitUntil(saveQuizSession(env, payload.userId, payload, quizResult));
+
+          // Agenda nurture sequence baseada na qualificação (background)
+          ctx.waitUntil(scheduleNurture(env, payload, quizResult.qualification));
+
+        } catch (err: any) {
+          console.error('[QuizScoring] erro ao qualificar respostas:', err?.message || String(err));
+          // Fail-safe: continua sem qualificação
+        }
+      }
+
       // ── LTV Prediction (+ A/B Testing de Prompts) ─────────────────────────
-      const LTV_EVENTS = ['Lead', 'Contact', 'Schedule', 'CompleteRegistration'];
+      const LTV_EVENTS = ['Lead', 'Contact', 'Schedule', 'CompleteRegistration', 'QuizComplete'];
       if (LTV_EVENTS.includes(eventName) && !payload.value) {
         const abVariation = await getLtvAbVariation(env);
         const ltv = await predictLtv(env, payload, request, abVariation?.system_prompt || null);
@@ -727,6 +896,7 @@ export default {
         return new Response(JSON.stringify({ skipped: `status ${wh.order_status}` }), { status: 200, headers });
       }
 
+      const customer = wh.Customer || {};
       const kwTxId = String(wh.order_id || '');
       const dupCheck = await processWebhookDuplicateCheck(env, 'kiwify', kwTxId, JSON.stringify(wh), {
         email: customer.email,
@@ -735,8 +905,6 @@ export default {
       if (dupCheck.duplicate) {
         return new Response(JSON.stringify({ ok: true, skipped: 'duplicate' }), { status: 200, headers });
       }
-
-      const customer = wh.Customer || {};
       const product  = wh.Product || {};
       const profile  = await getProfileByEmail(env, customer.email || '');