cdp-edge 2.0.1 → 2.0.2

package/extracted-skill/tracking-events-generator/agents/tiktok-agent.md

@@ -73,6 +73,69 @@ Gere payloads para o Worker seguir a API oficial:
 
 ---
 
+## ⏱️ RATE LIMITS — TikTok Events API v1.3
+
+Conforme `contracts/api-versions.json`, a TikTok Events API tem limites estritos:
+
+| Limite | Valor | Ação se excedido |
+|--------|-------|-----------------|
+| Requisições por minuto (por pixel) | 10 req/min | Implementar throttling |
+| Eventos por batch | 5 events/batch | Agrupar eventos em batches |
+| Retries máximos | 3 tentativas | Backoff exponencial |
+
+### Implementação de Throttling no Worker
+
+```javascript
+// Rate limit KV key: 'tiktok_rate_{pixel_id}_{minute}'
+async function dispatchTikTokWithRateLimit(env, events, pixelId, accessToken) {
+  const now = new Date();
+  const minuteKey = `tiktok_rate_${pixelId}_${now.getUTCFullYear()}${now.getUTCMonth()}${now.getUTCDate()}${now.getUTCHours()}${now.getUTCMinutes()}`;
+
+  // Verificar rate limit no KV
+  const currentCount = parseInt(await env.GEO_CACHE.get(minuteKey) || '0');
+
+  if (currentCount >= 10) {
+    // Rate limit atingido — encaminhar para RETRY_QUEUE
+    await env.RETRY_QUEUE.send({ platform: 'tiktok', events, pixelId });
+    return { queued: true, reason: 'rate_limit' };
+  }
+
+  // Agrupar eventos em batches de 5
+  const batches = [];
+  for (let i = 0; i < events.length; i += 5) {
+    batches.push(events.slice(i, i + 5));
+  }
+
+  const results = [];
+  for (const batch of batches) {
+    const result = await fetch('https://business-api.tiktok.com/open_api/v1.3/event/track/', {
+      method: 'POST',
+      headers: {
+        'Content-Type':  'application/json',
+        'Access-Token':  accessToken
+      },
+      body: JSON.stringify({
+        pixel_code: pixelId,
+        event_source: 'web',
+        event_source_id: pixelId,
+        data: batch
+      })
+    });
+
+    // Incrementar contador no KV (TTL de 60s = 1 minuto)
+    await env.GEO_CACHE.put(minuteKey, String(currentCount + 1), { expirationTtl: 60 });
+
+    results.push(result);
+  }
+
+  return { sent: results.length, batches: batches.length };
+}
+```
+
+> **Regra:** Se `HTTP 429` for recebido da TikTok API, encaminhar eventos para `RETRY_QUEUE` com backoff de 1min, 2min, 4min (máximo 3 tentativas).
+
+---
+
 ## INPUTS RECEBIDOS
 
 - JSON do Page Analyzer Agent (eventos mapeados, seletores, tipo de página)

package/extracted-skill/tracking-events-generator/agents/tracking-plan-agent.md

@@ -59,19 +59,30 @@ function validateEventCoverage(pageAnalysis, agentOutputs) {
     });
   });
 
-  // Encontrar eventos faltantes (no plano mas implementados)
-  const missingEvents = [];
+  // Encontrar eventos do Page Analyzer NÃO implementados por nenhum agente
+  const unimplementedEvents = [];
+  pageEvents.forEach(eventKey => {
+    if (!agentEvents.has(eventKey)) {
+      unimplementedEvents.push(eventKey);
+    }
+  });
+
+  // Encontrar eventos implementados pelos agentes mas SEM correspondência no Page Analyzer
+  const orphanEvents = [];
   agentEvents.forEach(eventKey => {
     if (!pageEvents.has(eventKey)) {
-      missingEvents.push(eventKey);
+      orphanEvents.push(eventKey);
     }
   });
 
   return {
     total_page_events: pageEvents.size,
     total_implemented_events: agentEvents.size,
-    missing_events,
-    coverage_percentage: Math.round((agentEvents.size / pageEvents.size) * 100)
+    unimplemented_events: unimplementedEvents,  // ← Eventos do plano sem código
+    orphan_events: orphanEvents,                // ← Código sem evento no plano
+    coverage_percentage: Math.round(
+      ((pageEvents.size - unimplementedEvents.length) / Math.max(pageEvents.size, 1)) * 100
+    )
   };
 }
 ```
@@ -187,6 +198,90 @@ async function validateApiVersions(trackingPlan) {
 }
 ```
 
+### 1.5 Validação Cruzada Completa (runFullValidation)
+
+```javascript
+/**
+ * Ponto de entrada principal — executa TODAS as validações em sequência
+ * e retorna um relatório consolidado com status PASS | WARN | BLOCK
+ *
+ * @param {Object} pageAnalysis - Output do Page Analyzer Agent
+ * @param {Object} agentOutputs - Código gerado por todos os agentes
+ * @param {Object} apiVersions  - Conteúdo de contracts/api-versions.json
+ * @returns {Object} Relatório consolidado de validação
+ */
+async function runFullValidation(pageAnalysis, agentOutputs, apiVersions) {
+  const report = {
+    status: 'PASS',   // PASS | WARN | BLOCK
+    timestamp: new Date().toISOString(),
+    checks: {}
+  };
+
+  // CHECK 1: Cobertura de eventos
+  const coverage = validateEventCoverage(pageAnalysis, agentOutputs);
+  report.checks.event_coverage = coverage;
+  if (coverage.coverage_percentage < 100) {
+    report.status = coverage.coverage_percentage < 80 ? 'BLOCK' : 'WARN';
+  }
+
+  // CHECK 2: Parâmetros de conversão
+  const allEvents = Object.values(agentOutputs).flatMap(o => o.events || []);
+  const paramIssues = validateConversionParameters(allEvents, apiVersions);
+  report.checks.conversion_params = paramIssues;
+  if (paramIssues.filter(i => i.severity === 'HIGH').length > 0) {
+    report.status = 'BLOCK';
+  }
+
+  // CHECK 3: Seletores existentes no código
+  const missingSelectors = validateSelectorsExist({}, pageAnalysis);
+  report.checks.selectors = { missing: missingSelectors };
+  if (missingSelectors.length > 0) {
+    if (report.status === 'PASS') report.status = 'WARN';
+  }
+
+  // CHECK 4: Versões de API consistentes com api-versions.json
+  const trackingPlan = { events: {} };
+  Object.entries(agentOutputs).forEach(([agent, output]) => {
+    if (output.events) trackingPlan.events[agent] = output.events;
+  });
+  await validateApiVersions(trackingPlan);
+  const apiIssues = Object.values(trackingPlan.events)
+    .flatMap(events => events.filter(e => e.api_version_issue || e.api_deprecated));
+  report.checks.api_versions = apiIssues;
+  if (apiIssues.some(e => e.api_deprecated)) {
+    report.status = 'BLOCK';  // API depreciada = bloquear deploy
+  }
+
+  // CHECK 5: Regras de ouro — deduplicação event_id
+  const missingEventId = allEvents.filter(e => !e.event_id && !e.params?.event_id);
+  report.checks.deduplication = {
+    events_missing_event_id: missingEventId.map(e => `${e.platform}:${e.name}`)
+  };
+  if (missingEventId.length > 0) report.status = 'WARN';
+
+  // CHECK 6: SHA-256 em campos PII
+  const piiFields = ['em', 'ph', 'fn', 'ln'];
+  const unhashed = allEvents.filter(e =>
+    piiFields.some(field => e.user_data?.[field] && !e.user_data[field].match(/^[a-f0-9]{64}$/))
+  );
+  report.checks.pii_hashing = {
+    events_with_unhashed_pii: unhashed.map(e => `${e.platform}:${e.name}`)
+  };
+  if (unhashed.length > 0) {
+    report.status = 'BLOCK';  // PII sem hash = bloquear imediatamente
+  }
+
+  // Determinar mensagem de status
+  report.summary = {
+    PASS:  '✅ Tracking Plan validado — pode fazer deploy',
+    WARN:  '⚠️ Tracking Plan com alertas — revisar antes do deploy',
+    BLOCK: '❌ BLOQUEADO — corrigir itens críticos antes do deploy'
+  }[report.status];
+
+  return report;
+}
+```
+
 ---
 
 ## PASSO 2 — GERAR O TRACKING PLAN COM VALIDAÇÃO

package/extracted-skill/tracking-events-generator/agents/webhook-agent.md

@@ -71,6 +71,64 @@ async function hashWebhookUserData(webhookPayload) {
 
 ---
 
+## 🔗 INTEGRAÇÃO COM OUTROS AGENTES (Fluxo Pós-Compra)
+
+Após processar um webhook de compra com sucesso, o Webhook Agent DEVE disparar:
+
+```
+Webhook (Hotmart/Kiwify/Ticto/Stripe)
+    │
+    ├─► [1] Validar HMAC → rejeitar 401 se inválido
+    ├─► [2] Dedup D1 por transaction_id
+    ├─► [3] Cross-check D1 por email → fbp/fbc/ttp/gclid
+    ├─► [4] Hashear PII (SHA-256) — ver seção acima
+    │
+    ├─► [5] CAPI Dispatch (ctx.waitUntil) — paralelo:
+    │         → Meta CAPI v22.0 (Purchase)
+    │         → GA4 MP (purchase)
+    │         → TikTok Events API v1.3 (CompletePayment)
+    │
+    ├─► [6] Email Agent (ctx.waitUntil) — enviar confirmação de compra:
+    │         → Chamar sendEmail(env, 'purchase_confirmation', { email, nome, produto, valor })
+    │         → Ver email-agent.md para implementação completa
+    │
+    └─► [7] CRM Sync (ctx.waitUntil) — sincronizar comprador:
+              → Chamar syncToCRM(env, 'purchase', { email, nome, produto, valor, order_id })
+              → Ver crm-integration-agent.md para implementação completa
+```
+
+### Código de Integração (webhook handler)
+
+```javascript
+// No handler de webhook, após validação e dedup:
+ctx.waitUntil(Promise.allSettled([
+  // [5] CAPI dispatch
+  dispatchToCAPI(env, hashedUserData, purchaseData),
+
+  // [6] Email Agent — confirmação de compra
+  sendEmail(env, 'purchase_confirmation', {
+    to:      buyerEmail,
+    name:    buyerName,
+    product: productName,
+    value:   purchaseValue
+  }),
+
+  // [7] CRM Sync — criar/atualizar contato como comprador
+  syncToCRM(env, 'purchase', {
+    email:    buyerEmail,
+    name:     buyerName,
+    product:  productName,
+    value:    purchaseValue,
+    order_id: transactionId
+  })
+]));
+```
+
+> **Nota:** `sendEmail()` é implementada pelo Email Agent em `cloudflare/email-service.js`.
+> `syncToCRM()` é implementada pelo CRM Integration Agent em `cloudflare/crm-service.js`.
+
+---
+
 ## INPUTS RECEBIDOS
 
 - Payload JSON do webhook da plataforma de vendas (Hotmart, Kiwify, Ticto, Stripe)

package/extracted-skill/tracking-events-generator/agents/whatsapp-agent.md

@@ -9,8 +9,8 @@ Você é o **Especialista em Mensageria WhatsApp (Quantum Tier)** do CDP Edge. S
 1. **Meta Cloud API v22.0 (Eixo Vendas/Notificações ao dono)**:
    - **Público**: O dono do sistema — notificações de Nova Venda e Novo Lead em tempo real.
    - **Objetivo**: Avisar o dono quando chegar uma venda ou lead via webhook.
-   - **Padrão**: API oficial Meta v22.0 — `POST /v22.0/{WA_PHONE_ID}/messages`.
-   - **Secrets**: `WA_PHONE_ID`, `WA_ACCESS_TOKEN`, `WA_NOTIFY_NUMBER`.
+   - **Padrão**: API oficial Meta v22.0 — `POST /v22.0/{WHATSAPP_PHONE_NUMBER_ID}/messages`.
+   - **Secrets**: `WHATSAPP_PHONE_NUMBER_ID`, `WHATSAPP_ACCESS_TOKEN`, `WA_NOTIFY_NUMBER`.
 2. **CallMeBot (Eixo Guardião/Alertas de Sistema)**:
    - **Público**: O dono do sistema (admin).
    - **Objetivo**: Alertas internos do Cloudflare — Worker com erro, API falhando, token expirado, D1 com problema. **NÃO usado para mensagens a clientes.**
@@ -29,11 +29,64 @@ Sempre que o usuário desejar robustez na mensageria:
 
 ---
 
+## 🔗 INTEGRAÇÃO COM WHATSAPP CTWA SETUP AGENT
+
+O **WhatsApp CTWA Setup Agent** (`whatsapp-ctwa-setup-agent.md`) é o parceiro deste agente para rastreamento de anúncios Click-to-WhatsApp. A divisão de responsabilidades é clara:
+
+| Este agente (whatsapp-agent) | CTWA Setup Agent |
+|---|---|
+| Notificações de venda/lead ao dono (Meta API) | Webhook `/webhook/whatsapp` — recebe mensagens da Meta |
+| Alertas de sistema ao admin (CallMeBot) | Extração de `ctwa_clid` e disparo à Meta CAPI |
+| Tracking de clique em botão WhatsApp (browser) | Setup do webhook de verificação (GET + POST) |
+
+### Fluxo CTWA → Meta CAPI (implementado pelo CTWA Setup Agent)
+
+```
+Usuário clica anúncio CTWA no Facebook/Instagram
+    ↓
+WhatsApp abre com mensagem pré-preenchida
+    ↓
+Meta faz POST ao Worker: /webhook/whatsapp
+    ↓ (CTWA Setup Agent processa)
+Worker extrai ctwa_clid + phone do payload
+    ↓
+Worker envia evento 'Contact' à Meta CAPI:
+    {
+      event_name: 'Contact',
+      action_source: 'chat',           ← obrigatório para CTWA
+      event_source_url: ad_source_url,
+      user_data: { ph: sha256(phone) },
+      custom_data: { ctwa_clid: '...' } ← identifica o anúncio
+    }
+    ↓
+Worker salva no D1: tabela whatsapp_contacts
+    ↓
+WhatsApp Agent dispara notificação ao dono via Meta Cloud API v22.0
+```
+
+### O que este agente gera para o fluxo CTWA
+
+```javascript
+// sendWhatsApp() — notificação ao dono quando chega lead CTWA
+async function notifyOwnerNewCtwaLead(env, contactData) {
+  const message = `📲 Novo Lead CTWA!\n\nNome: ${contactData.name || 'Desconhecido'}\nTelefone: ${contactData.phone}\nAnúncio: ${contactData.headline || '-'}\nMensagem: "${contactData.messageBody?.slice(0, 80) || '-'}"`;
+
+  await sendWhatsApp(env, 'system', {
+    to: env.WA_NOTIFY_NUMBER,
+    message
+  });
+}
+```
+
+> **Regra de coordenação:** O CTWA Setup Agent processa o webhook e extrai ctwa_clid. Após salvar no D1 com `capi_sent = 0`, ele chama `notifyOwnerNewCtwaLead()` deste agente para notificar o dono. Manter esta divisão — nunca misturar as responsabilidades.
+
+---
+
 ## INPUTS RECEBIDOS
 
 - Tipo de disparo: `Purchase` | `Lead` (Meta Cloud API) ou falha de sistema (CallMeBot)
 - Dados do comprador/lead: `name`, `email`, `phone`, `product_name`, `value` (via webhook ou D1)
-- Secrets Meta: `WA_PHONE_ID`, `WA_ACCESS_TOKEN`, `WA_NOTIFY_NUMBER`
+- Secrets Meta: `WHATSAPP_PHONE_NUMBER_ID`, `WHATSAPP_ACCESS_TOKEN`, `WA_NOTIFY_NUMBER`
 - Secrets CallMeBot: `CALLMEBOT_PHONE`, `CALLMEBOT_APIKEY`
 - Contexto de erro (para alertas CallMeBot): plataforma afetada, mensagem de erro, timestamp
 
@@ -58,9 +111,9 @@ Sempre que o usuário desejar robustez na mensageria:
   "eixos": {
     "notificacoes": {
       "api": "Meta Cloud API v22.0",
-      "endpoint": "POST /v22.0/{WA_PHONE_ID}/messages",
+      "endpoint": "POST /v22.0/{WHATSAPP_PHONE_NUMBER_ID}/messages",
       "tipos": ["Purchase", "Lead"],
-      "secrets": ["WA_PHONE_ID", "WA_ACCESS_TOKEN", "WA_NOTIFY_NUMBER"]
+      "secrets": ["WHATSAPP_PHONE_NUMBER_ID", "WHATSAPP_ACCESS_TOKEN", "WA_NOTIFY_NUMBER"]
     },
     "alertas_sistema": {
       "api": "CallMeBot",

package/extracted-skill/tracking-events-generator/agents/whatsapp-ctwa-setup-agent.md

@@ -7,7 +7,7 @@ Sua missão: configurar o rastreamento completo de anúncios Click to WhatsApp d
 
 ## ✅ REGRAS CRÍTICAS
 
-0. **CONSULTA OBRIGATÓRIA À MEMÓRIA**: Extraia o ID de Número WhatsApp, Token de API e Token de Verificação (`WA_PHONE_NUMBER_ID`, `WA_TOKEN`, `WA_WEBHOOK_VERIFY_TOKEN`) consultando ativamente o "memory-agent.json". Solicite ao Orquestrador tudo o que faltar. Execute configurações de WhatsApp exclusivamente com os dados oficiais guardados na Memória para garantir alinhamento sistêmico.
+0. **CONSULTA OBRIGATÓRIA À MEMÓRIA**: Extraia o ID de Número WhatsApp, Token de API e Token de Verificação (`WHATSAPP_PHONE_NUMBER_ID`, `WHATSAPP_ACCESS_TOKEN`, `WA_WEBHOOK_VERIFY_TOKEN`) consultando ativamente o "memory-agent.json". Solicite ao Orquestrador tudo o que faltar. Execute configurações de WhatsApp exclusivamente com os dados oficiais guardados na Memória para garantir alinhamento sistêmico.
 1. Cloudflare-Only: Sem dependências externas.
 2. Same-Domain: Worker no domínio do site (anti-adblock).
 
@@ -172,8 +172,8 @@ message_body | Olá, vi o anúncio e tenho interesse
 [ ] META_APP_ID             — ID do app no Meta for Developers                ← usuário fornece
 [ ] META_APP_SECRET         — App Secret (developers.facebook.com → Básico)   ← usuário fornece
 [ ] WA_WEBHOOK_VERIFY_TOKEN — gerado pelo agente (crypto.randomUUID)           ← agente cria
-[ ] WA_PHONE_ID             — descoberto automaticamente via API               ← agente descobre
-[ ] WA_ACCESS_TOKEN         — mesmo que META_ACCESS_TOKEN                      ← agente reutiliza
+[ ] WHATSAPP_PHONE_NUMBER_ID             — descoberto automaticamente via API               ← agente descobre
+[ ] WHATSAPP_ACCESS_TOKEN         — mesmo que META_ACCESS_TOKEN                      ← agente reutiliza
 [ ] WHATSAPP_BUSINESS_ACCOUNT_ID — descoberto automaticamente via API          ← agente descobre
 ```
 
@@ -498,16 +498,16 @@ Deve mostrar o app com `override_callback_uri` (se não-SMB) ou apenas o app sub
 
 ```bash
 echo "{WABA_ID}"           | wrangler secret put WHATSAPP_BUSINESS_ACCOUNT_ID
-echo "{PHONE_ID}"          | wrangler secret put WA_PHONE_ID
-echo "{META_ACCESS_TOKEN}" | wrangler secret put WA_ACCESS_TOKEN
+echo "{PHONE_ID}"          | wrangler secret put WHATSAPP_PHONE_NUMBER_ID
+echo "{META_ACCESS_TOKEN}" | wrangler secret put WHATSAPP_ACCESS_TOKEN
 echo "{META_APP_SECRET}"   | wrangler secret put META_APP_SECRET
 echo "{META_ACCESS_TOKEN}" | wrangler secret put META_ACCESS_TOKEN
 
 # ── Secrets para Auto-Resposta WhatsApp (enviar mensagens de saída) ─────────
 # Necessários para: worker.js → auto-resposta após Lead/Purchase
-# WHATSAPP_TOKEN      = mesmo token Meta (Cloud API) — pode reutilizar META_ACCESS_TOKEN
+# WHATSAPP_ACCESS_TOKEN      = mesmo token Meta (Cloud API) — pode reutilizar META_ACCESS_TOKEN
 # WHATSAPP_PHONE_NUMBER_ID = mesmo {PHONE_ID} descoberto acima
-echo "{META_ACCESS_TOKEN}" | wrangler secret put WHATSAPP_TOKEN
+echo "{META_ACCESS_TOKEN}" | wrangler secret put WHATSAPP_ACCESS_TOKEN
 echo "{PHONE_ID}"          | wrangler secret put WHATSAPP_PHONE_NUMBER_ID
 
 # Confirmar todos
@@ -518,15 +518,15 @@ Secrets esperados no worker ao final:
 ```
 META_ACCESS_TOKEN
 META_APP_SECRET
-WA_ACCESS_TOKEN
-WA_PHONE_ID
+WHATSAPP_ACCESS_TOKEN
+WHATSAPP_PHONE_NUMBER_ID
 WA_WEBHOOK_VERIFY_TOKEN
 WHATSAPP_BUSINESS_ACCOUNT_ID
-WHATSAPP_TOKEN              ← auto-resposta outbound (mesmo valor de META_ACCESS_TOKEN)
-WHATSAPP_PHONE_NUMBER_ID    ← auto-resposta outbound (mesmo valor de WA_PHONE_ID)
+WHATSAPP_ACCESS_TOKEN              ← auto-resposta outbound (mesmo valor de META_ACCESS_TOKEN)
+WHATSAPP_PHONE_NUMBER_ID    ← auto-resposta outbound (mesmo valor de WHATSAPP_PHONE_NUMBER_ID)
 ```
 
-> **Nota:** `WHATSAPP_TOKEN` e `WHATSAPP_PHONE_NUMBER_ID` são usados pela função de auto-resposta no worker (envio de mensagens de saída para o lead após eventos de conversão). São o mesmo token/phone_id da CTWA — apenas referenciados por nomes distintos no código.
+> **Nota:** `WHATSAPP_ACCESS_TOKEN` e `WHATSAPP_PHONE_NUMBER_ID` são usados pela função de auto-resposta no worker (envio de mensagens de saída para o lead após eventos de conversão). São o mesmo token/phone_id da CTWA — apenas referenciados por nomes distintos no código.
 
 ---
 
@@ -611,13 +611,13 @@ App:     {META_APP_ID} — subscriptions: messages ✅
 
 SECRETS NO WORKER:
   ✅ META_ACCESS_TOKEN
-  ✅ WA_ACCESS_TOKEN
-  ✅ WA_PHONE_ID             → {PHONE_ID}
+  ✅ WHATSAPP_ACCESS_TOKEN
+  ✅ WHATSAPP_PHONE_NUMBER_ID             → {PHONE_ID}
   ✅ WA_WEBHOOK_VERIFY_TOKEN
   ✅ WHATSAPP_BUSINESS_ACCOUNT_ID → {WABA_ID}
   ✅ META_APP_SECRET
-  ✅ WHATSAPP_TOKEN          → mesmo valor de META_ACCESS_TOKEN (auto-resposta)
-  ✅ WHATSAPP_PHONE_NUMBER_ID → mesmo valor de WA_PHONE_ID (auto-resposta)
+  ✅ WHATSAPP_ACCESS_TOKEN          → mesmo valor de META_ACCESS_TOKEN (auto-resposta)
+  ✅ WHATSAPP_PHONE_NUMBER_ID → mesmo valor de WHATSAPP_PHONE_NUMBER_ID (auto-resposta)
 
 TESTE E2E:
   ✅ GET verificação → challenge retornado

package/extracted-skill/tracking-events-generator/agents/youtube-agent.md

@@ -89,39 +89,152 @@ const _gbraid = _urlParams.get('gbraid') || '';  // App campaigns (privacy)
 **ATENÇÃO wbraid/gbraid**: São os click IDs para campanhas YouTube em iOS (pós ATT).
 Nunca hashear — enviar como texto plano para Google Ads API.
 
-### 2. Rastreamento de vídeo YouTube na página
+### 2. Rastreamento de vídeo YouTube na página — YouTube IFrame API
 
-O `behavior-engine.js` já implementa rastreamento de vídeos via YouTube IFrame API.
 Para usar, o iframe deve ter `enablejsapi=1`:
 
 ```html
-<!-- Embed YouTube com JS API habilitada -->
+<!-- Embed YouTube com JS API habilitada (obrigatório) -->
 <iframe
   id="video-tour-imovel"
-  src="https://www.youtube.com/embed/VIDEO_ID?enablejsapi=1"
+  src="https://www.youtube.com/embed/VIDEO_ID?enablejsapi=1&origin=https://seudominio.com.br"
   allow="autoplay"
 ></iframe>
 ```
 
-O BehaviorEngine detecta automaticamente e dispara via `cdpTrack.track()`:
-- `video_milestone` com `percent: 25, 50, 75, 100`
-- Score: +10 (25%), +15 (50%), +25 (75%/100%)
+#### Implementação real do YouTube IFrame API listener
+
+```javascript
+/**
+ * YouTube IFrame API Listener — injeta no behavior-engine.js ou tracking.js
+ * Rastreia: video_start, video_25, video_50, video_75, video_complete
+ * Dispara via cdpTrack.track() para o Worker → GA4 MP + demais plataformas
+ */
+
+// Carregar YouTube IFrame API (uma vez por página)
+(function initYouTubeTracking() {
+  if (window._ytTrackingInitialized) return;
+  window._ytTrackingInitialized = true;
+
+  // Mapa de iframes já trackeados
+  const trackedPlayers = new Map();
+
+  // Injetar API script do YouTube (não carrega 2x se já existe)
+  if (!document.getElementById('youtube-iframe-api')) {
+    const tag = document.createElement('script');
+    tag.id  = 'youtube-iframe-api';
+    tag.src = 'https://www.youtube.com/iframe_api';
+    document.head.appendChild(tag);
+  }
+
+  // Callback global chamado pelo YouTube quando API estiver pronta
+  window.onYouTubeIframeAPIReady = function() {
+    // Auto-detectar todos os iframes com enablejsapi=1
+    document.querySelectorAll('iframe[src*="youtube.com/embed"]').forEach(iframe => {
+      if (trackedPlayers.has(iframe.id)) return;
+
+      const videoTitle = iframe.title || iframe.id || 'YouTube Video';
+
+      const player = new YT.Player(iframe.id, {
+        events: {
+          onStateChange: (event) => handlePlayerStateChange(event, player, videoTitle),
+          onReady:       (event) => handlePlayerReady(event, player, videoTitle)
+        }
+      });
+
+      trackedPlayers.set(iframe.id, { player, milestone: new Set() });
+    });
+  };
+
+  // Se API já carregada (SPA reload), inicializar diretamente
+  if (typeof YT !== 'undefined' && YT.Player) {
+    window.onYouTubeIframeAPIReady();
+  }
+
+  function handlePlayerReady(event, player, videoTitle) {
+    // Iniciar polling de progresso
+    const iframeId = player.getIframe().id;
+    const state = trackedPlayers.get(iframeId);
+
+    const interval = setInterval(() => {
+      if (!player.getDuration) return;
+      const duration = player.getDuration();
+      const current  = player.getCurrentTime();
+      if (duration <= 0) return;
+
+      const percent = Math.floor((current / duration) * 100);
+
+      // Disparar milestones: 25, 50, 75 (100% é coberto pelo estado ENDED)
+      const milestoneEvents = { 25: 'video_25', 50: 'video_50', 75: 'video_75' };
+      [25, 50, 75].forEach(milestone => {
+        if (percent >= milestone && !state.milestone.has(milestone)) {
+          state.milestone.add(milestone);
+
+          window.cdpTrack?.track(milestoneEvents[milestone], {
+            content_name:   videoTitle,
+            video_percent:  milestone,
+            video_duration: Math.round(duration),
+            video_provider: 'youtube',
+            value:          0,
+            currency:       'BRL'
+          });
+        }
+      });
+    }, 1000); // checar a cada 1s
+
+    state.progressInterval = interval;
+  }
+
+  function handlePlayerStateChange(event, player, videoTitle) {
+    const iframeId = player.getIframe().id;
+    const state    = trackedPlayers.get(iframeId);
+
+    // YT.PlayerState: PLAYING=1, PAUSED=2, ENDED=0, BUFFERING=3
+    switch (event.data) {
+      case YT.PlayerState.PLAYING:
+        if (!state.started) {
+          state.started = true;
+          window.cdpTrack?.track('video_start', {
+            content_name:   videoTitle,
+            video_duration: Math.round(player.getDuration() || 0),
+            video_provider: 'youtube'
+          });
+        }
+        break;
+
+      case YT.PlayerState.ENDED:
+        clearInterval(state.progressInterval);
+        window.cdpTrack?.track('video_complete', {
+          content_name:   videoTitle,
+          video_duration: Math.round(player.getDuration() || 0),
+          video_provider: 'youtube'
+        });
+        break;
+    }
+  }
+})();
+```
+
+O listener dispara via `cdpTrack.track()`:
+- `video_start` — primeiros 2s de play
+- `video_25`, `video_50`, `video_75` — marcos de progresso (25/50/75%)
+- `video_complete` — 100% assistido
 
 ### 3. Evento de Lead após assistir vídeo (imóveis)
 
 ```javascript
 // Disparar Lead qualificado quando usuário assiste 75%+ do tour
-document.addEventListener('pb:video_milestone', (e) => {
-  if (e.detail.percent >= 75) {
-    cdpTrack.track('InitiateCheckout', {
-      content_name: 'Tour_Virtual_Empreendimento',
-      value: 0,
-      currency: 'BRL',
-      // Sinaliza alta intenção para Meta + Google
-      meta_intensity: 'high',
-    });
-  }
-});
+// Adicionar dentro do callback de milestoneEvents no IFrame API listener:
+// milestoneEvents[75] → 'video_75' — adicionar lógica abaixo no bloco forEach
+if (milestone === 75) {
+  window.cdpTrack?.track('InitiateCheckout', {
+    content_name: 'Tour_Virtual_Empreendimento',
+    value: 0,
+    currency: 'BRL',
+    // Sinaliza alta intenção para Meta + Google
+    meta_intensity: 'high',
+  });
+}
 ```
 
 ### 4. Consent Mode v2 — OBRIGATÓRIO para YouTube/Google Ads
@@ -161,9 +274,11 @@ Para verificar persistência correta:
 ```javascript
 // No sendGA4Mp() — adicionar mapeamento de eventos YouTube
 const VIDEO_GA4_MAP = {
-  video_start:     'video_start',
-  video_milestone: 'video_progress',   // GA4 usa video_progress com percent
-  video_complete:  'video_complete',
+  video_start:    'video_start',
+  video_25:       'video_progress',   // GA4 usa video_progress com percent
+  video_50:       'video_progress',
+  video_75:       'video_progress',
+  video_complete: 'video_complete',
 };
 
 // Params obrigatórios para video_progress (GA4)
@@ -228,9 +343,9 @@ if (!payload.gclid && payload.utmSource === 'youtube') {
 | Evento cdpTrack | Mapeamento GA4 | Mapeamento Google Ads | Quando Disparar |
 |---|---|---|---|
 | `video_start` | `video_start` | — | Primeiros 2s de reprodução |
-| `video_milestone` (25%) | `video_progress` | — | 25% assistido |
-| `video_milestone` (50%) | `video_progress` | `engaged_view` candidate | 50% assistido |
-| `video_milestone` (75%) | `video_progress` | `engaged_view` | 75% assistido — alta intenção |
+| `video_25` | `video_progress` | — | 25% assistido |
+| `video_50` | `video_progress` | `engaged_view` candidate | 50% assistido |
+| `video_75` | `video_progress` | `engaged_view` | 75% assistido — alta intenção |
 | `video_complete` | `video_complete` | `video_view_complete` | 100% assistido |
 | `Lead` (após vídeo) | `generate_lead` | Conversão primária | Formulário submetido |
 | `InitiateCheckout` | `begin_checkout` | Conversão micro | Clique em "Quero saber mais" |
@@ -244,7 +359,7 @@ if (!payload.gclid && payload.utmSource === 'youtube') {
 ```
 FASE 1: AWARENESS (YouTube TrueView 30s)
   ↓ Tour aéreo do empreendimento / lifestyle do bairro
-  ↓ Rastrear: video_milestone 50% + 75% → score alto no LTV
+  ↓ Rastrear: video_50 + video_75 → score alto no LTV
   ↓ Remarketing: quem assistiu 50%+ vira audiência no Google Ads
 
 FASE 2: CONSIDERAÇÃO (YouTube Non-skip 15s + Display)

package/extracted-skill/tracking-events-generator/contracts/api-versions.json

@@ -212,10 +212,14 @@
         ]
       },
       "conversions_api": {
-        "current": "v2",
-        "minimum_supported": "v1",
-        "recommended": "v2",
-        "endpoint_pattern": "https://api.linkedin.com/rest/attributionConversions/{VERSION}",
+        "current": "202401",
+        "minimum_supported": "202401",
+        "recommended": "202401",
+        "endpoint_pattern": "https://api.linkedin.com/rest/conversionEvents",
+        "required_headers": {
+          "LinkedIn-Version": "202401",
+          "X-Restli-Protocol-Version": "2.0.0"
+        },
         "authentication": "Bearer token (LINKEDIN_ACCESS_TOKEN)",
         "rate_limits": {
           "requests_per_second": 10,
@@ -359,10 +363,10 @@
   },
 
   "last_updated_by": {
-    "agent": "Intelligence Agent",
-    "session_id": "CDP_2026-03-28_sync",
-    "timestamp": "2026-03-28T00:00:00.000Z"
+    "agent": "Audit — CDP Edge v2.0",
+    "session_id": "CDP_2026-04-10_audit",
+    "timestamp": "2026-04-10T00:00:00.000Z"
   },
 
-  "next_review_date": "2026-04-27T00:00:00.000Z"
+  "next_review_date": "2026-05-10T00:00:00.000Z"
 }