cdp-edge 1.0.4 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.0.4",
+  "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 =
@@ -793,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/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