cdp-edge 1.13.0 → 1.14.0

package/extracted-skill/tracking-events-generator/agents/page-analyzer.md

@@ -24,6 +24,10 @@ Toda a sua análise deve ser baseada na infraestrutura nativa da Cloudflare.
 | Botão WhatsApp | `Contact` | 🔴 crítico |
 | Botão "Comprar" → Hotmart/Kiwify/Ticto | `InitiateCheckout` (Trafego Direto) | 🔴 crítico |
 | Página de obrigado | `Purchase_Success` | 🔴 crítico |
+| **Preço Formatado (R$, $, €)** | `value_extraction` (Atrelado ao CTA) | 🔴 crítico |
+| **Campo de Formulário Oculto (CSS hide/opacity 0)** | `honeypot_field` | 🔴 crítico |
+| **Aparecimento de Botão Atrasado (Timer)** | `pitch_seen` | 🟡 essencial |
+| **Classe de Erro CSS (.error, .invalid)** | `form_error_detected` | 🟡 essencial |
 | **Micro-Evento: Rage Click** | `rage_click` | 🟡 essencial |
 | **Micro-Evento: Heatmap** | `click_heatmap` (x,y) | 🟡 essencial |
 | **Micro-Evento: Visibility** | `tab_visibility_change` | 🟡 essencial |
@@ -84,7 +88,9 @@ Retorne APENAS este JSON (sem texto antes ou depois):
             "email": "email",
             "nome": "nome-completo",
             "telefone": "telefone",
-            "form": "#form-lead"
+            "form": "#form-lead",
+            "honeypot_detectado": "input[name='website_url_hp']",
+            "seletor_erros": ".input-error"
           },
           "evento_sugerido": "Lead",
           "evento_ga4": "generate_lead",
@@ -99,6 +105,7 @@ Retorne APENAS este JSON (sem texto antes ou depois):
           "integracao_externa": "hotmart",
           "evento_sugerido": "InitiateCheckout",
           "seletor_sugerido": "a[href*='hotmart']",
+          "valor_extraido": { "seletor": ".price-tag", "moeda": "BRL" },
           "prioridade": "critico"
         },
         {
@@ -115,7 +122,8 @@ Retorne APENAS este JSON (sem texto antes ou depois):
           "tipo": "youtube",
           "id": "dQw4w9WgXcQ",
           "posicao": "hero",
-          "evento_sugerido": "ViewContent"
+          "evento_sugerido": "ViewContent",
+          "pitch_timer_cta": "#btn-compra-atrasado"
         }
       ],
       "tem_secao_preco": true,
@@ -175,6 +183,10 @@ Retorne APENAS este JSON (sem texto antes ou depois):
 - Se um arquivo é muito grande (>500 linhas), focar nos primeiros e últimos 100 e nas funções com `submit`, `click`, `form`
 - Se não encontrar nenhum formulário nem CTA relevante em uma página, registrar `tipo_pagina: "generica"` e pular
 - `precisa_server_side: true` quando encontrar integração com Hotmart, Kiwify, Eduzz, Ticto, Stripe, MercadoPago — pois o webhook de compra confirmada precisa do servidor para rastrear Purchase com fbp/fbc
+- **Value Scraping:** Se existir botão de InitiateCheckout/Comprar, busque ativamente por seletor de preço próximo (`.price`, `h2 strong`) para incluir em `valor_extraido`. O Edge precisa do valor exato sem hardcode.
+- **Form Error Tracking:** Mapeie classes CSS de erro (ex: `.error`, `.text-red-500`) em `seletor_erros` para nosso rastreador Edge capturar "taxas de frustração de conversão" orgânicas.
+- **Fraude/Honeypot:** Se houver campos de input ocultos (`display: none`, `opacity: 0`) perto de formulários, marque como `honeypot_detectado`. Robôs preenchem isso; o Fraud Gate Edge usará esse seletor para bloqueio imediato.
+- **Pitch Seen (VSLs):** Procure por botões (CTAs) que iniciam como ocultos (`display: none`) ou são ativados via `setTimeout` em páginas com VSL. Informe em `pitch_timer_cta` para criarmos o evento ultra-qualificado de View Pitch.
 - **A/B test:** quando detectado, `gerar_tracking: true` instrui os agentes de tracking a incluir captura da variante ativa no momento do evento de conversão (Lead, Purchase). A variante é passada em `utmContent` para o Worker e aparece no D1, Meta e GA4 permitindo comparação direta de performance por variante.
 - **Se não houver teste A/B detectado:** omitir o campo `ab_tests` do JSON (não retornar array vazio)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",

package/server-edge-tracker/INSTALAR.md

@@ -118,21 +118,30 @@ wrangler secret put META_TEST_CODE
 > Encontrar no Gerenciador de Eventos Meta → Testar Eventos → copie o código "TEST12345"
 > **Lembrar de remover esse secret em produção** (veja PASSO 10)
 
-### WhatsApp — Meta Cloud API v22.0 (notificações de venda/lead):
+### WhatsApp — Webhook Verification (CTWA Tracking):
 ```bash
-wrangler secret put WA_PHONE_ID
+wrangler secret put WA_WEBHOOK_VERIFY_TOKEN
 ```
-> Phone Number ID do WhatsApp Business. Encontrar em: developers.facebook.com → App → WhatsApp → Configuração da API.
+> Token de verificação do webhook WhatsApp (obrigatório para CTWA). Meta exige este token para registrar o webhook.
+> Defina qualquer string segura, ex: `cdp-edge-webhook-2026-secret-xyz`.
+
+### WhatsApp — Meta Cloud API v22.0 (mensagens automáticas - OPCIONAL):
+> ⚠️  Estes secrets são **OPCIONAIS**. Se você precisa apenas de tracking de dados (ctwaclid), não configure-os.
 
 ```bash
-wrangler secret put WA_ACCESS_TOKEN
+wrangler secret put WHATSAPP_PHONE_NUMBER_ID
 ```
-> Token de acesso permanente do WhatsApp Business (Meta Developers → Token de acesso).
+> Meta: "Phone Number ID" — ID do número WhatsApp Business. Necessário apenas para enviar mensagens automáticas.
+
+```bash
+wrangler secret put WHATSAPP_ACCESS_TOKEN
+```
+> Meta: "Access Token" — Token de acesso do WhatsApp Business. Necessário apenas para enviar mensagens automáticas.
 
 ```bash
 wrangler secret put WA_NOTIFY_NUMBER
 ```
-> Número que vai receber as notificações de venda/lead. Ex: `5511999998888` (com código do país, sem `+`).
+> Número que vai receber as notificações de venda/lead. Necessário apenas para enviar mensagens automáticas.
 
 ### WhatsApp — CallMeBot (alertas internos do sistema):
 ```bash
@@ -210,7 +219,97 @@ Verificar no Meta: Gerenciador de Eventos → Testar Eventos → deve aparecer "
 
 ---
 
-## PASSO 10 — Remover o Test Code antes de ir ao ar
+## PASSO 10 — Verificar Plano Workers ($5) e Dados Geográficos
+
+### IMPORTANTE: Plano Workers Paid ($5/mês)
+
+O CDP Edge foi desenvolvido para aproveitar todos os recursos do **Cloudflare Workers Paid ($5/mês)**, especialmente os dados geográficos avançados.
+
+**O que você ganha com o plano $5:**
+- **Cidade exata:** Ex: "São Paulo" (plano free: NULL)
+- **Estado completo:** Ex: "São Paulo" (plano free: NULL)  
+- **Estado (sigla):** Ex: "SP" (plano free: NULL)
+- **CEP:** Ex: "01310-100" (plano free: NULL)
+- **Latitude/Longitude:** Ex: "-23.5505", "-46.6333" (plano free: NULL)
+- **Timezone:** Ex: "America/Sao_Paulo" (plano free: NULL)
+
+**Como verificar se está funcionando:**
+
+1. **Enviar evento de teste:**
+```bash
+curl -X POST "https://SEU_DOMINIO/track" \
+  -H "Content-Type: application/json" \
+  -H "Origin: https://SEU_DOMINIO" \
+  -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
+  -d '{"eventName":"TestGeo","pageUrl":"https://SEU_DOMINIO/teste","email":"teste@exemplo.com","firstName":"Teste","lastName":"Geo"}'
+```
+
+2. **Verificar no banco D1 se os dados geográficos foram capturados:**
+```bash
+wrangler d1 execute cdp-edge-db --remote --command="SELECT event_name, email, city, state, country FROM leads WHERE email = 'teste@exemplo.com' ORDER BY created_at DESC LIMIT 1"
+```
+
+**Resultado esperado (com plano $5):**
+```json
+{
+  "event_name": "TestGeo",
+  "email": "teste@exemplo.com",
+  "city": "São Bernardo do Campo",    // ← Plano $5: nome da cidade
+  "state": "SP",                       // ← Plano $5: sigla do estado
+  "country": "BR"                      // ← Plano free: país
+}
+```
+
+**Se `city` e `state` aparecem como `NULL`:**
+- O plano $5 não está ativo
+- Verifique no painel Cloudflare se Workers está contratado
+- Contrate o plano em: https://dash.cloudflare.com/[ID_DA_CONTA]/workers/plans
+
+---
+
+## PASSO 11.1 — Solução de Conflitos de Rotas
+
+### ⚠️ Se aparecer erro no deploy:
+
+```
+ERROR: Can't deploy routes that are assigned to another worker.
+"server-edge-tracker" is already assigned to routes:
+  - lancamentosabc.com.br/track*
+```
+
+### SOLUÇÃO 1 — Via Painel Cloudflare (RECOMENDADO):
+
+1. Acesse: https://dash.cloudflare.com/[ID_DA_CONTA]/workers/overview
+2. Clique no worker que está usando as rotas do seu domínio
+3. Vá em Settings → Triggers → Routes
+4. Clique "Delete" nas rotas do domínio `lancamentosabc.com.br`
+5. Repita o `wrangler deploy`
+
+### SOLUÇÃO 2 — Via Wrangler CLI:
+
+```bash
+# Listar workers para encontrar o deployment conflitante
+wrangler deployments list
+
+# Remover deployment conflitante (substituir pelo ID correto)
+wrangler deployment delete --id <ID_DO_DEPLOYMENT_CONFLITANTE>
+```
+
+### SOLUÇÃO 3 — Usar Sufixo nas Rotas:
+
+Se não quiser remover rotas existentes, use sufixo:
+
+```toml
+[[routes]]
+pattern = "lancamentosabc.com.br/track-worker-novo*"
+zone_name = "lancamentosabc.com.br"
+```
+
+**URL do tracking:** `https://lancamentosabc.com.br/track-worker-novo`
+
+---
+
+## PASSO 11.2 — Remover o Test Code antes de ir ao ar
 
 ```bash
 wrangler secret delete META_TEST_CODE
@@ -219,18 +318,94 @@ wrangler deploy
 
 ---
 
-## PASSO 11 — Configurar domínio personalizado (opcional)
+## PASSO 12 — Configurar domínio personalizado (OBRIGATÓRIO para produção)
+
+### ⚠️ ATENÇÃO: Domínio OBRIGATÓRIO
+
+Para o tracking funcionar corretamente em produção, você **PRECISA** configurar um domínio personalizado. **NÃO** use o domínio `.workers.dev` em produção.
+
+### INSTRUÇÕES EXATAS:
+
+#### 1. Verificar se o domínio está na Cloudflare
+```bash
+# No painel Cloudflare: https://dash.cloudflare.com
+# Verifique se o domínio está listado em "Websites"
+# Se não estiver, adicione o domínio antes de continuar
+```
+
+#### 2. Configurar rotas no wrangler.toml
+
+Edite o arquivo `wrangler.toml` e substitua:
+```toml
+# SUBSTITUIR estes valores:
+pattern  = "SEU_DOMINIO/track*"      # ← Substituir pelo domínio real
+zone_name = "SEU_DOMINIO"            # ← Substituir pelo domínio real
+
+# Exemplo real:
+# pattern  = "lancamentosabc.com.br/track*"
+# zone_name = "lancamentosabc.com.br"
+```
+
+#### 3. Fazer o deploy com as rotas
+```bash
+wrangler deploy
+```
+
+#### 4. Resolver conflitos de rotas (se ocorrer erro)
+
+Se aparecer erro: `Can't deploy routes that are assigned to another worker`:
+
+**SOLUÇÃO A - Via painel Cloudflare:**
+1. Acesse: https://dash.cloudflare.com/[ID_DA_CONTA]/workers/overview
+2. Clique no worker que está usando as rotas do seu domínio
+3. Vá em Settings → Triggers → Routes
+4. Clique "Delete" nas rotas do domínio
+5. Repita o `wrangler deploy`
+
+**SOLUÇÃO B - Via API (rápido):**
+```bash
+# Listar workers para encontrar o ID
+wrangler deployments list
+
+# Remover rotas do worker conflitante (substituir pelo ID correto)
+wrangler deployment delete --id <ID_DO_DEPLOYMENT>
+```
+
+#### 5. Verificar se funcionou
+```bash
+# Testar endpoint de health
+curl "https://SEU_DOMINIO/track/health"
+
+# Deve retornar:
+# {"status": "ok", "bindings": {...}}
+```
+
+#### 6. Testar endpoint de tracking
+```bash
+curl -X POST "https://SEU_DOMINIO/track" \
+  -H "Content-Type: application/json" \
+  -H "Origin: https://SEU_DOMINIO" \
+  -d '{"eventName":"Test","pageUrl":"https://SEU_DOMINIO/teste"}'
+```
+
+**URL FINAL DO TRACKING:**
+- ✅ `https://SEU_DOMINIO/track` (CORRETO - produção)
+- ❌ `https://seu-worker.workers.dev/track` (ERRADO - teste apenas)
+
+---
+
+### DOMÍNIOS SUPOSTOS (.workers.dev) — Apenas para testes locais:
 
-Se quiser usar `track.SEU_DOMINIO` em vez do domínio `.workers.dev`:
+```bash
+# Para testar localmente sem domínio real:
+wrangler dev
 
-1. No painel da Cloudflare → Workers & Pages → seu Worker → Settings → Domains & Routes
-2. Clique "Add Custom Domain"
-3. Digite: `track.SEU_DOMINIO`
-4. Cloudflare configura o DNS automaticamente (como o domínio já está na Cloudflare)
+# Acesso temporário: http://localhost:8787/track
+```
 
 ---
 
-## PASSO 12 — Configurar webhooks nas plataformas
+## PASSO 13 — Configurar webhooks nas plataformas
 
 ### Ticto (plataforma principal):