cdp-edge 1.0.3 → 1.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v2.5.3** — Auditoria de Dependências + Sync de Agentes + Fix D1 (25 de Abril de 2026) 🔧
+> **v2.5.4** — Auditoria de Dependências + Sync de Agentes + Fix D1 (25 de Abril de 2026) 🔧
 
 ---
 

package/contracts/agent-versions.json

@@ -1,7 +1,7 @@
 {
   "_comment": "Fonte de verdade para versões dos agent files. Atualizar quando modules/ ou index.ts mudarem. Use scripts/validate-agents.js para detectar drifts.",
-  "worker_version": "2.5.3",
-  "worker_hash_date": "2026-04-15",
+  "worker_version": "2.5.4",
+  "worker_hash_date": "2026-04-25",
   "agents": {
     "master-orchestrator": {
       "version": "2.0.7",

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

@@ -140,7 +140,8 @@ const _wbraid = _urlParams.get('wbraid') || ''; // Google Ads (iOS, web-to-app,
 const _gbraid = _urlParams.get('gbraid') || ''; // Google Ads (app campaigns, privacy preserving)
 
 // TikTok
-const _ttclid = _urlParams.get('ttclid') || ''; // TikTok Ads click ID → complementa cookie _ttp
+const _ttclid  = _urlParams.get('ttclid')  || ''; // TikTok Ads click ID → complementa cookie _ttp
+const _msclkid = _urlParams.get('msclkid') || ''; // Microsoft Ads click ID
 
 // UTMs — rastreamento interno de origem de tráfego (independente da atribuição das plataformas)
 const _utms = {
@@ -217,7 +218,8 @@ const _getClickIDs = () => {
     wbraid: _wbraid || undefined,
     ttclid: _ttclid || undefined,
     ttp:    document.cookie.match(/_ttp=([^;]+)/)?.[1] || undefined,  // TikTok Pixel cookie — EMQ TikTok
-    rclid:  _urlParams.get('rclid') || undefined,
+    rclid:   _urlParams.get('rclid') || undefined,
+    msclkid: _msclkid || undefined,
   };
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.0.3",
+  "version": "1.1.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/index.ts

@@ -63,6 +63,9 @@ import {
   processWhatsAppWebhook,
   verifyHmac,
 } from './modules/dispatch/whatsapp';
+import {
+  notifyEvolutionForm,
+} from './modules/dispatch/crm';
 
 // ── ML — LTV + A/B Testing ────────────────────────────────────────────────────
 import {
@@ -239,6 +242,9 @@ export default {
         WA_NOTIFY_NUMBER:         env.WA_NOTIFY_NUMBER         ? 'set' : 'not set (optional - only for auto-reply)',
         TIKTOK_ACCESS_TOKEN:      env.TIKTOK_ACCESS_TOKEN      ? 'set' : 'not set (optional)',
         CALLMEBOT_PHONE:          env.CALLMEBOT_PHONE          ? 'set' : 'not set (optional)',
+        EVOLUTION_BASE_URL:       env.EVOLUTION_BASE_URL       ? 'set' : 'not set (optional - CRM Evolution)',
+        EVOLUTION_INSTANCE:       env.EVOLUTION_INSTANCE       ? 'set' : 'not set (optional - CRM Evolution)',
+        EVOLUTION_API_KEY:        env.EVOLUTION_API_KEY        ? 'set' : 'not set (optional - CRM Evolution)',
       };
 
       const hasMissing =
@@ -389,7 +395,8 @@ export default {
         if (!trackPayload.wbraid && c.wbraid) trackPayload.wbraid = c.wbraid;
         if (!trackPayload.gbraid && c.gbraid) trackPayload.gbraid = c.gbraid;
         if (!trackPayload.ttclid && c.ttclid) trackPayload.ttclid = c.ttclid;
-        if (!trackPayload.ttp    && c.ttp)    trackPayload.ttp    = c.ttp;
+        if (!trackPayload.ttp     && c.ttp)     trackPayload.ttp     = c.ttp;
+        if (!trackPayload.msclkid && c.msclkid) trackPayload.msclkid = c.msclkid;
       }
       if (payload.utms && typeof payload.utms === 'object') {
         const u = payload.utms as Record<string, string>;
@@ -761,15 +768,19 @@ export default {
         ctx.waitUntil(resolveDeviceGraph(env.DB, payload.userId, payload.email, payload.phone));
       }
 
-      // Registrar em events — deduplicação + label ML (INSERT OR IGNORE descarta duplicatas)
+      // Deduplicação server-side — INSERT OR IGNORE retorna changes=0 para duplicatas
       if (env.DB && payload.eventId) {
-        ctx.waitUntil(
-          env.DB.prepare(
+        try {
+          const dedup = await env.DB.prepare(
             `INSERT OR IGNORE INTO events (event_id, event_name, user_id, created_at)
              VALUES (?, ?, ?, datetime('now'))`
-          ).bind(payload.eventId, eventName, payload.userId || null).run()
-            .catch(() => { /* silencioso — não bloqueia o pipeline */ })
-        );
+          ).bind(payload.eventId, eventName, payload.userId || null).run();
+          if (dedup.meta.changes === 0) {
+            return new Response(JSON.stringify({ ok: true, skipped: 'duplicate' }), { status: 200, headers });
+          }
+        } catch {
+          // Tabela ausente ou erro de DB — não bloqueia o pipeline
+        }
       }
 
       // R2 Audit Log — background
@@ -788,6 +799,25 @@ export default {
           : []),
       ]);
 
+      // ── Notifica o Evolution CRM (formulários de cadastro) ────────────────
+      // Ativo para Lead e Contact vindos de formulários (quando tem telefone).
+      // Silencioso se EVOLUTION_BASE_URL / EVOLUTION_INSTANCE / EVOLUTION_API_KEY
+      // não estiverem configurados — zero impacto no pipeline principal.
+      const EVOLUTION_FORM_EVENTS = ['Lead', 'Contact', 'CompleteRegistration'];
+      if (EVOLUTION_FORM_EVENTS.includes(eventName) && trackPayload.phone) {
+        ctx.waitUntil(
+          notifyEvolutionForm(env, {
+            phone:       trackPayload.phone,
+            name:        [trackPayload.firstName, trackPayload.lastName].filter(Boolean).join(' ') || null,
+            email:       trackPayload.email || null,
+            formName:    trackPayload.contentName || trackPayload.productName || eventName,
+            utmSource:   trackPayload.utmSource   || null,
+            utmCampaign: trackPayload.utmCampaign || null,
+            pageUrl:     trackPayload.pageUrl     || null,
+          })
+        );
+      }
+
       // Automação de mensagens
       const AUTOMATION_EVENTS = ['Lead', 'Purchase', 'InitiateCheckout'];
       if (AUTOMATION_EVENTS.includes(eventName) && env.DB) {

package/server-edge-tracker/modules/db.ts

@@ -115,6 +115,7 @@ export async function upsertProfile(env: Env, eventName: string, payload: TrackP
     const {
       userId, email, phone,
       fbp, fbc, ttp, gclid, ttclid, gaClientId,
+      wbraid, gbraid, msclkid,
       city, state, country,
       engagementScore, userScore,
     } = payload;
@@ -131,8 +132,9 @@ export async function upsertProfile(env: Env, eventName: string, payload: TrackP
     await env.DB.prepare(`
       INSERT INTO user_profiles
         (user_id, email, phone, fbp, fbc, ttp, gclid, ttclid, ga_client_id,
+         wbraid, gbraid, msclkid,
          city, state, country, score, cohort_label, created_at, updated_at)
-      VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,datetime('now'),datetime('now'))
+      VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,datetime('now'),datetime('now'))
       ON CONFLICT(user_id) DO UPDATE SET
         email        = COALESCE(excluded.email,        user_profiles.email),
         phone        = COALESCE(excluded.phone,        user_profiles.phone),
@@ -142,6 +144,9 @@ export async function upsertProfile(env: Env, eventName: string, payload: TrackP
         gclid        = COALESCE(excluded.gclid,        user_profiles.gclid),
         ttclid       = COALESCE(excluded.ttclid,       user_profiles.ttclid),
         ga_client_id = COALESCE(excluded.ga_client_id, user_profiles.ga_client_id),
+        wbraid       = COALESCE(excluded.wbraid,       user_profiles.wbraid),
+        gbraid       = COALESCE(excluded.gbraid,       user_profiles.gbraid),
+        msclkid      = COALESCE(excluded.msclkid,      user_profiles.msclkid),
         city         = COALESCE(excluded.city,         user_profiles.city),
         state        = COALESCE(excluded.state,        user_profiles.state),
         country      = COALESCE(excluded.country,      user_profiles.country),
@@ -158,6 +163,9 @@ export async function upsertProfile(env: Env, eventName: string, payload: TrackP
       gclid              || null,
       ttclid             || null,
       gaClientId         || null,
+      wbraid             || null,
+      gbraid             || null,
+      msclkid            || null,
       city               || null,
       state              || null,
       (country           || (request as any).cf?.country || null),

package/server-edge-tracker/modules/dispatch/crm.ts

@@ -0,0 +1,116 @@
+/**
+ * CDP Edge — Evolution GO Integration
+ * Encaminha leads para o Evolution GO, que dispara o webhook para o EVO CRM.
+ *
+ * Secrets necessários (wrangler secret put):
+ *   EVOLUTION_BASE_URL   → URL base (ex: https://go.arkitekt.space)
+ *   EVOLUTION_INSTANCE   → Nome da instância (ex: Ramon)
+ *   EVOLUTION_API_KEY    → API Key do Evolution GO
+ */
+
+import { Env } from '../../types.js';
+
+export interface CTWALeadData {
+  phone: string;
+  messageBody?: string;
+  ctwaClid?: string | null;
+  adId?: string | null;
+  sourceUrl?: string | null;
+  headline?: string | null;
+  wamid?: string | null;
+}
+
+export interface FormLeadData {
+  phone: string;
+  name?: string | null;
+  email?: string | null;
+  formName?: string | null;
+  utmSource?: string | null;
+  utmCampaign?: string | null;
+  pageUrl?: string | null;
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function isEvolutionConfigured(env: Env): boolean {
+  return !!(env.EVOLUTION_BASE_URL && env.EVOLUTION_INSTANCE && env.EVOLUTION_API_KEY);
+}
+
+function evolutionHeaders(env: Env): Record<string, string> {
+  return {
+    'Content-Type': 'application/json',
+    'apikey': env.EVOLUTION_API_KEY!,
+  };
+}
+
+function normalizePhone(phone: string): string {
+  const digits = phone.replace(/\D/g, '');
+  if (digits.startsWith('55') && (digits.length === 12 || digits.length === 13)) return digits;
+  if (digits.length === 10 || digits.length === 11) return `55${digits}`;
+  return digits;
+}
+
+// ── Envio via Evolution GO /send/text ────────────────────────────────────────
+// POST {EVOLUTION_BASE_URL}/send/text
+// Body: { id: instanceName, number, text, delay }
+
+async function sendEvolutionText(env: Env, phone: string, text: string): Promise<void> {
+  const number = normalizePhone(phone);
+  try {
+    const res = await fetch(`${env.EVOLUTION_BASE_URL}/send/text`, {
+      method: 'POST',
+      headers: evolutionHeaders(env),
+      body: JSON.stringify({
+        id: env.EVOLUTION_INSTANCE,
+        number,
+        text,
+        delay: 0,
+      }),
+    });
+    if (!res.ok) {
+      const err = await res.text();
+      console.warn('[Evolution] sendText non-ok:', res.status, err.slice(0, 200));
+    }
+  } catch (err: any) {
+    console.warn('[Evolution] sendText failed (non-critical):', err?.message || String(err));
+  }
+}
+
+// ── API Pública — CTWA ────────────────────────────────────────────────────────
+
+export async function notifyEvolutionCTWA(env: Env, data: CTWALeadData): Promise<void> {
+  if (!isEvolutionConfigured(env)) return;
+
+  const { phone, messageBody, ctwaClid, adId, sourceUrl, headline } = data;
+
+  const linhas: string[] = [`🔔 *Novo Lead via WhatsApp (CTWA)*`, ``];
+  linhas.push(`📱 *Número:* ${phone}`);
+  if (messageBody) linhas.push(`💬 *Mensagem:* ${messageBody}`);
+  if (headline)    linhas.push(`📢 *Anúncio:* ${headline}`);
+  if (sourceUrl)   linhas.push(`🔗 *URL:* ${sourceUrl}`);
+  if (adId)        linhas.push(`🆔 *Ad ID:* ${adId}`);
+  if (ctwaClid)    linhas.push(`🧩 *CTWA ID:* ${ctwaClid}`);
+  linhas.push(``, `🕐 ${new Date().toLocaleString('pt-BR', { timeZone: 'America/Sao_Paulo' })}`);
+
+  await sendEvolutionText(env, phone, linhas.join('\n'));
+}
+
+// ── API Pública — Formulário ──────────────────────────────────────────────────
+
+export async function notifyEvolutionForm(env: Env, data: FormLeadData): Promise<void> {
+  if (!isEvolutionConfigured(env)) return;
+
+  const { phone, name, email, formName, utmSource, utmCampaign, pageUrl } = data;
+
+  const linhas: string[] = [`📋 *Novo Lead via Formulário*`, ``];
+  if (name)        linhas.push(`👤 *Nome:* ${name}`);
+  if (email)       linhas.push(`📧 *E-mail:* ${email}`);
+  linhas.push(     `📱 *Telefone:* ${phone}`);
+  if (formName)    linhas.push(`📝 *Formulário:* ${formName}`);
+  if (utmSource)   linhas.push(`🔗 *Fonte:* ${utmSource}`);
+  if (utmCampaign) linhas.push(`📣 *Campanha:* ${utmCampaign}`);
+  if (pageUrl)     linhas.push(`🌐 *Página:* ${pageUrl}`);
+  linhas.push(``, `🕐 ${new Date().toLocaleString('pt-BR', { timeZone: 'America/Sao_Paulo' })}`);
+
+  await sendEvolutionText(env, phone, linhas.join('\n'));
+}

package/server-edge-tracker/modules/dispatch/whatsapp.ts

@@ -7,6 +7,7 @@ import { sha256, normalizePhone } from '../utils.js';
 import { saveLead, logApiFailure } from '../db.js';
 import { Env, TrackPayload } from '../../types.js';
 import { ExecutionContext } from '@cloudflare/workers-types';
+import { notifyEvolutionCTWA } from './crm.js';
 
 // ── Tipos ───────────────────────────────────────────────────────────────────────
 interface WhatsAppOptions {
@@ -248,6 +249,22 @@ export async function processWhatsAppWebhook(env: Env, body: any, request: Reque
       }, request, 'whatsapp')
     );
 
+    // ── Notifica o Evolution CRM sobre o novo lead CTWA ──────────────────────
+    // Cria/atualiza o contato no Evolution e abre a conversa para o vendedor.
+    // Silencioso se EVOLUTION_BASE_URL / EVOLUTION_INSTANCE / EVOLUTION_API_KEY
+    // não estiverem configurados.
+    ctx.waitUntil(
+      notifyEvolutionCTWA(env, {
+        phone:       phoneNorm,
+        messageBody: messageBody || undefined,
+        ctwaClid,
+        adId,
+        sourceUrl,
+        headline,
+        wamid,
+      })
+    );
+
     results.push({ ok: true, phone: phoneNorm.slice(0, 4) + '****', ctwa_clid: ctwaClid ? 'present' : 'absent', event_id: eventId });
   }
 

package/server-edge-tracker/types.ts

@@ -64,6 +64,11 @@ export interface Env {
   RESEND_API_KEY?: string;
   RESEND_FROM_EMAIL?: string;
   CALLMEBOT_APIKEY?: string;
+
+  // Evolution API CRM
+  EVOLUTION_BASE_URL?: string;   // URL base do servidor Evolution (ex: https://evolution.suaempresa.com)
+  EVOLUTION_INSTANCE?: string;   // Nome da instância WhatsApp no Evolution
+  EVOLUTION_API_KEY?: string;    // Chave de autenticação da API Evolution
 }
 
 // ── Event Payload Types ───────────────────────────────────────────────────────

package/server-edge-tracker/wrangler.toml

@@ -16,13 +16,13 @@ workers_dev = true
 # pattern  = "*.SEU_DOMINIO/track*"
 # zone_name = "SEU_DOMINIO"
 
-[[routes]]
-pattern  = "SEU_DOMINIO/track*"
-zone_name = "SEU_DOMINIO"
-
-[[routes]]
-pattern  = "*.SEU_DOMINIO/track*"
-zone_name = "SEU_DOMINIO"
+# [[routes]]
+# pattern  = "lancamentosabc.com.br/track*"
+# zone_name = "lancamentosabc.com.br"
+#
+# [[routes]]
+# pattern  = "*.lancamentosabc.com.br/track*"
+# zone_name = "lancamentosabc.com.br"
 
 # ── Variáveis públicas (não são segredos) ─────────────────────────────────────
 [vars]
@@ -134,3 +134,6 @@ head_sampling_rate = 1
 # wrangler secret put LINKEDIN_AD_ACCOUNT_ID    ← ID da conta de anúncios LinkedIn
 # wrangler secret put SPOTIFY_ACCESS_TOKEN      ← Bearer token Spotify Advertising API
 # wrangler secret put SPOTIFY_AD_ACCOUNT_ID     ← ID da conta de anúncios Spotify Ads
+# wrangler secret put EVOLUTION_BASE_URL        ← URL base do Evolution API (ex: https://evolution.suaempresa.com)
+# wrangler secret put EVOLUTION_INSTANCE        ← Nome da instância WhatsApp no Evolution
+# wrangler secret put EVOLUTION_API_KEY         ← Chave de autenticação do Evolution API