cdp-edge 2.5.3 → 2.5.5

package/README.md

@@ -1,129 +1,21 @@
 # 🚀 CDP Edge — Quantum Tracking Enterprise
-
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v2.5.3** — Auditoria Completa + Sync Total de Agentes + Fix D1 (25 de Abril de 2026) 🔧
-> **v2.5.1** — SDK Bundle + Diagnóstico Pós-Deploy + Gap Fixes (25 de Abril de 2026) 🛠️
-> **v2.3.9** — Quiz Scoring Engine + Sales Engine (14 de Abril de 2026) 🤖💰
-
----
-
-## 📋 CHANGELOG v2.5.3 — Auditoria Completa + Sync Total de Agentes + Fix D1 (25 de Abril de 2026) 🔧
-
-### Bug Fix Crítico
-- `schema-ltv-feedback.sql` adicionado à ordem de migração — `recordLtvFeedback()` falhava silenciosamente em todo Purchase, quebrando o ciclo preditivo LTV
-
-### Fix de Compatibilidade D1
-- `schema-utm.sql`: `ADD COLUMN IF NOT EXISTS` → `ADD COLUMN` — D1/SQLite não suporta IF NOT EXISTS em ALTER TABLE
-
-### Sincronização Total de Agentes
-- `contracts/agent-versions.json`: worker_version `2.2.3 → 2.5.3`, 49 agentes registrados (eram 26), `depends_on` `.js → .ts`, event count `19 → 25`, table count `24 → 31`
-- `database-agent.md`: `main = "worker.js" → "index.ts"`, 24 → 31 tabelas, roadmap atualizado
-- `devops-agent.md`: `RESEND_API_KEY`, `RESEND_FROM_EMAIL`, `WEBHOOK_SECRET_TICTO` adicionados ao `*secrets`
-
-### D1 Produção
-- 31 tabelas aplicadas em `cdp-edge-db` — todos os schemas confirmados
-- Worker deployado: Version ID `37776c1a` — `/health` status: `ok`
+> **v2.5.5** — Integração EVO CRM (OAuth2) + Sync Total de Agentes (27 de Abril de 2026) 🔧
 
 ---
 
-## 📋 CHANGELOG v2.5.1 — SDK Bundle + Diagnóstico Pós-Deploy + Gap Fixes (25 de Abril de 2026) 🛠️
-
-### SDK Bundle — cdpTrack.min.js pronto para `<script src="">`
-- `npm run sdk:build` → `dist/sdk/cdpTrack.min.js` (41.6 kB, IIFE, `window.cdpTrack`)
-- Um único arquivo sem dependências externas — cola no site e funciona
-- `dist/sdk/install-snippet.html` com snippet pronto para antes do `</body>`
-
-### Diagnóstico Pós-Deploy — `cdp-edge validate <url>`
-```bash
-cdp-edge validate https://meusite.com.br
-cdp-edge validate https://meusite.com.br --worker https://worker.meusite.workers.dev
-```
-Verifica automaticamente:
-- Página carrega `cdpTrack.min.js` e Meta Pixel
-- Worker `/health` (D1, KV, AI, secrets)
-- Worker `/validate-install` (D1 write+read, KV, AI, secrets críticos)
-- `POST /track` aceita evento sintético → 200
-
-### Gap Fixes Críticos
-- **Endpoint**: `/api/tracking` → `/track` em todos os módulos SDK
-- **utm_term**: injetado pelo Worker após quiz scoring (nunca pelo cliente)
-- **TikTok ttp**: cookie `_ttp` capturado e enviado ao Worker
-- **ROAS por origem**: segmentado por `utm_content` (quiz_* vs video_* vs landing_* vs ctwa_*)
-
-### Novos Agentes
-- `lead-scoring-agent.md` — quiz de qualificação + análise dimensional Granite
-- `match-quality-agent.md` — guardião EMQ com cron 2h e alerta CallMeBot
-
----
+## 💻 INSTALAÇÃO
 
-## 📋 CHANGELOG v2.3.9 — Quiz Scoring Engine + Sales Engine (14 de Abril de 2026) 🤖💰
-
-### O que foi adicionado
-
-**ROAS Feedback Loop** (`modules/ml/roas.ts`)
-- Cruza leads com compras reais por campanha no D1
-- Calcula: `conversion_rate`, `revenue_per_lead`, `ltv_accuracy` (valida o modelo preditivo)
-- Recomendação automática de bid: `increase | maintain | decrease | pause`
-- Relatório semanal via CallMeBot com top campanhas e alertas
-- Persiste histórico em `roas_reports` + VIEW `v_roas_latest`
-
-**Nurture Engine** (`modules/nurture.ts`)
-- Sequências automáticas pós-quiz por qualificação:
-  - `interessado` → D+1, D+3, D+7 (WhatsApp)
-  - `curioso` → D+2, D+5 (conteúdo)
-  - `comprador` → contato imediato via hot lead (já existente)
-  - `perdido` → `cohort_label = excluded` (remove do remarketing)
-- `scheduleNurture()` chamado no QuizComplete em background
-- `runNurtureQueue()` executado pelo Intelligence Agent (cron diário)
-- D1: `nurture_sequences` + VIEWs de fila e stats
-
-**Lookalike Dinâmico** (`syncMetaLookalikeSeed()` em intelligence.ts)
-- Seed de Lookalike com compradores CONFIRMADOS (Purchase event) — não apenas high_intent
-- Une compradores reais + leads qualificados como `comprador` no quiz
-- Atualiza `cohort_label = buyer_confirmed` nos perfis
-- Persiste histórico em `lookalike_seeds`
-- Roda automaticamente no cron semanal do Intelligence Agent
-
-**Schema D1**: `schema-sales-engine.sql` — `roas_reports`, `nurture_sequences`, `lookalike_seeds` + 5 VIEWs
-
-### Migração
 ```bash
-cd server-edge-tracker
-wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
-wrangler deploy
+npx cdp-edge install
+# ou
+npm install -g cdp-edge
+cdp-edge install . --name "Nome do Projeto"
 ```
 
 ---
 
-## 📋 CHANGELOG v2.4.0 — Quiz Scoring Engine (14 de Abril de 2026) 🤖
-
-**Quiz Scoring Engine** (`modules/ml/quiz.ts`) — análise dimensional automática via Granite 4.0 Micro:
-- Detecta o TIPO de cada pergunta: `urgency | budget | timeline | fit | engagement | awareness | objection`
-- Atribui peso automático por dimensão (budget/urgency=5, fit=4, timeline=3, engagement=2)
-- Score ponderado → `comprador | interessado | curioso | perdido`
-- Fallback heurístico por palavras-chave quando AI indisponível
-- `quiz_sessions` no D1 com breakdown completo por dimensão
-
-**Integração no pipeline `/track`**:
-- `QuizComplete` + `quiz_answers[]` → scoring antes do LTV
-- `intentionLevel` qualificado alimenta LTV Prediction → `comprador` = LTV High automático
-- `QuizComplete` adicionado ao `LTV_EVENTS`
-
-**Migração**: `wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote`
-
----
-
-## 📋 CHANGELOG v2.3.8 — Fix Definitivo: api-versions.json (14 de Abril de 2026) 🔒
-
-`build.js` copia `extracted-skill/.../contracts/` → `contracts/` no `prepare` script. A fonte estava na v1.0.0, sobrescrevendo o arquivo correto a cada `npm publish`. Ambos os arquivos agora sincronizados em v1.1.0.
-
----
-
-> ⚠️ **REGRA DE OURO (SQUAD):** Todas as atualizações devem ser documentadas de forma sincronizada em `README.md`, `CLAUDE.md` e `CDP-EDGE-BUSINESS-BOOK.md`. Nenhuma alteração passa sem esse tripé.
-
----
-
 ## 🤖 MANIFESTO: EU, CDP EDGE
 
 *Eu não sou um simples "script de pixel". Eu sou uma arquitetura **Enterprise Tier 10** nascida e construída 100% nativa na infraestrutura da Cloudflare.*
@@ -161,7 +53,7 @@ Cron semanal (Intelligence Agent):
 
 ---
 
-## 📊 BANCO DE DADOS D1 — 25 Tabelas + 12 VIEWs
+## 📊 BANCO DE DADOS D1 — 31 Tabelas + 12 VIEWs
 
 ```
 CORE TRACKING          ML & INTELLIGENCE         SALES ENGINE
@@ -218,6 +110,7 @@ v_leads_segmented           v_ltv_feedback
 | Enterprise | `bidding-agent.md` | Bids ML por segmento |
 | Enterprise | `ab-ltv-agent.md` | A/B testing de prompts LTV |
 | Enterprise | `fraud-detection-agent.md` | Detecção de fraude na borda |
+| Infraestrutura | `evo-crm-agent.md` | Roteamento de leads p/ EVO CRM (OAuth2) |
 | Monitoramento | `intelligence-agent.md` | Cron — ROAS, Nurture, Lookalike, LTV training |
 
 ---
@@ -230,7 +123,9 @@ v_leads_segmented           v_ltv_feedback
 | `/track` | POST | Evento principal — Fraud Gate → Quiz Scoring → LTV → CAPI |
 | `/health` | GET | Smoke test D1 + KV + AI |
 | `/webhook/ticto` | POST | Purchase webhook (HMAC) |
+| `/webhook/whatsapp` | POST | Webhook Meta WhatsApp → CRM (Evolution/EVO) |
 | `/export/customer-match` | GET | Export leads para Google Ads |
+| `/validate-install` | GET | Diagnóstico pós-deploy |
 
 ### ML Clustering (Fase 1)
 | Rota | Método | Função |
@@ -280,15 +175,19 @@ wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-indexes.sql --remote
 wrangler d1 execute cdp-edge-db --file=migrate-v7.sql --remote
-wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote  # Fase 5b: colunas LTV em user_profiles
+wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-utm.sql --remote
-wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote        # Fase 6
-wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote # Fase 7
+wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote
+wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
 
-# Secrets
+# Secrets (nunca em arquivos — sempre via wrangler secret put)
 wrangler secret put META_ACCESS_TOKEN
 wrangler secret put GA4_API_SECRET
 wrangler secret put TIKTOK_ACCESS_TOKEN
+wrangler secret put EVO_CRM_BASE_URL
+wrangler secret put EVO_CRM_CLIENT_ID
+wrangler secret put EVO_CRM_CLIENT_SECRET
+wrangler secret put EVO_CRM_INBOX_ID
 
 # Deploy
 wrangler deploy
@@ -296,17 +195,6 @@ wrangler deploy
 
 ---
 
-## 💻 INSTALAÇÃO
-
-```bash
-npx cdp-edge install
-# ou
-npm install -g cdp-edge
-cdp-edge install . --name "Nome do Projeto"
-```
-
----
-
 ## 🗺️ GRAPHIFY — Navegando o Código
 
 ```bash
@@ -316,6 +204,8 @@ cdp-edge install . --name "Nome do Projeto"
 /graphify path "quiz_answers" "meta capi"            # menor caminho
 ```
 
+> Changelog completo → [CHANGELOG.md](./CHANGELOG.md)
+
 ---
 
 ### **CDP Edge — By Rica Soares**

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.5",
+  "worker_hash_date": "2026-04-27",
   "agents": {
     "master-orchestrator": {
       "version": "2.0.7",
@@ -466,16 +466,19 @@
       ],
       "status": "synced"
     },
-    "crm-integration-agent": {
-      "version": "2.0.7",
-      "last_synced": "2026-04-15",
+    "evo-crm-agent": {
+      "version": "1.0.0",
+      "last_synced": "2026-04-27",
       "depends_on": [
-        "modules/db.ts:saveLead",
-        "modules/db.ts:upsertProfile"
+        "modules/dispatch/crm.ts:pushLeadToCrm",
+        "modules/dispatch/crm.ts:normalizePhone"
       ],
       "critical_sections": [
-        "env.DB.prepare",
-        "leads table schema"
+        "OAuth2 client_credentials",
+        "EVO_CRM_BASE_URL",
+        "EVO_CRM_INBOX_ID",
+        "phone normalization E.164",
+        "localizations pt-BR/en-US/es-ES"
       ],
       "status": "synced"
     },

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

@@ -0,0 +1,244 @@
+# EVO CRM Agent — CDP Edge
+
+Você é o **Agente de Integração EVO CRM** do CDP Edge. Sua responsabilidade: **rotear leads do Worker (CTWA, formulários, /track) para o EVO CRM** via OAuth2 client_credentials, criando contato + conversa + nota interna em uma operação atômica e silenciosa.
+
+EVO CRM é um fork comunitário do Chatwoot (`evoapicloud/evo-ai-crm-community`) com auth via Doorkeeper OAuth2 e API estilo `/api/v1/contacts`.
+
+---
+
+## ✅ REGRAS CRÍTICAS
+
+0. **Cloudflare-only** — sem dependências externas, roda no Worker.
+1. **Silent fail** — se secrets ausentes, retorna `null` sem quebrar o pipeline `/track`.
+2. **Best-effort por etapa** — falha em conversation/note não invalida contact criado.
+3. **Sem PII em logs** — `console.warn` só com status HTTP e prefixo do erro.
+4. **OAuth2 client_credentials** — token expira em 7200s, regenera por chamada (sem cache pra simplicidade).
+5. **Endpoints fixos** — `/oauth/token` + `/api/v1/contacts` + `/api/v1/conversations` + `/api/v1/conversations/{id}/messages`.
+6. **App OAuth precisa scope `read write`** — `read` apenas falha em POST de contato.
+
+---
+
+## 🔗 FLUXO DE ATIVAÇÃO
+
+Chamado pelo **Webhook Agent** (purchase/lead) ou direto pelo handler `/track` do Worker:
+
+```
+Worker (/track | webhook)
+   └─► ctx.waitUntil(pushLeadToCrm(env, leadData))
+           │
+           ├─ [1] POST /oauth/token (client_credentials)
+           │       Body: { grant_type, client_id, client_secret }
+           │       Resp: { access_token, expires_in: 7200 }
+           │
+           ├─ [2] POST /api/v1/contacts
+           │       Headers: { Authorization: Bearer <token> }
+           │       Body: { name, phone_number (E.164), email?, additional_attributes }
+           │       Resp: { id }  ou  422 (já existe — extrai id do body do erro)
+           │
+           ├─ [3] POST /api/v1/conversations
+           │       Body: { inbox_id, contact_id, additional_attributes: {} }
+           │       Resp: { id }  (best-effort)
+           │
+           └─ [4] POST /api/v1/conversations/{id}/messages
+                   Body: { content (nota i18n), message_type: 'activity', private: true }
+                   (best-effort — engole erro)
+```
+
+**Assinatura exportada (módulo `server-edge-tracker/modules/dispatch/crm.ts`):**
+
+```typescript
+export async function pushLeadToCrm(env: Env, data: CrmLeadData): Promise<string | null>;
+
+export interface CrmLeadData {
+  phone: string;                  // obrigatório (qualquer formato)
+  name?: string | null;
+  email?: string | null;
+  // Meta CAPI: fbclid, fbc, fbp, ctwaClid, adId, messageBody, headline
+  // UTMs: utmSource, utmMedium, utmCampaign, utmContent, utmTerm
+  // Contexto: eventName, pageUrl, formName
+  // Scoring: intentScore, ltvClass, funnelStage, botScore
+  // Monetário: value, currency
+  // Atributos livres: attributes?: Record<string, string>
+}
+
+// Wrappers de compatibilidade (mantidos por backwards-compat):
+export async function notifyEvolutionCTWA(env, data: CTWALeadData): Promise<void>;
+export async function notifyEvolutionForm(env, data: FormLeadData): Promise<void>;
+```
+
+---
+
+## 🔑 SECRETS OBRIGATÓRIOS
+
+```bash
+wrangler secret put EVO_CRM_BASE_URL        # ex: https://api-evocrm.dominio.com
+wrangler secret put EVO_CRM_CLIENT_ID       # OAuth client_id (Doorkeeper app, scope read+write)
+wrangler secret put EVO_CRM_CLIENT_SECRET   # OAuth client_secret
+wrangler secret put EVO_CRM_INBOX_ID        # UUID do inbox onde a conversa entra
+```
+
+### Secrets opcionais (i18n / multi-país)
+
+```bash
+wrangler secret put EVO_CRM_DEFAULT_COUNTRY # dial code para phones locais (default: "55")
+wrangler secret put EVO_CRM_LOCALE          # "pt-BR" | "en-US" | "es-ES" (default: "pt-BR")
+```
+
+---
+
+## 🌐 NORMALIZAÇÃO DE TELEFONE
+
+Função interna `normalizePhone(phone, defaultCountryCode='55')`:
+
+| Input | DEFAULT_COUNTRY | Output |
+|---|---|---|
+| `"11999998888"` | `55` (BR) | `+5511999998888` |
+| `"5511999998888"` | `55` | `+5511999998888` |
+| `"+44 20 7946 0958"` | qualquer | `+442079460958` (E.164 preservado) |
+| `"912345678"` | `351` (PT) | `+351912345678` |
+| `"5551234567"` | `1` (US) | `+15551234567` |
+
+Comportamento BR canônico (10/11/12/13 dígitos com prefixo 55) preservado quando `cc='55'`.
+
+---
+
+## 🌍 LOCALIZAÇÃO DA NOTA INTERNA
+
+Mapa `NOTE_LABELS` com 3 locales:
+
+| Locale | Title | Source | Campaign | Form | Ad | Message | Score | LTV |
+|---|---|---|---|---|---|---|---|---|
+| `pt-BR` | Novo Lead | Origem | Campanha | Formulário | Anúncio | Mensagem | Score | LTV |
+| `en-US` | New Lead | Source | Campaign | Form | Ad | Message | Score | LTV |
+| `es-ES` | Nuevo Lead | Origen | Campaña | Formulario | Anuncio | Mensaje | Score | LTV |
+
+Locale inválido → fallback `pt-BR` via `resolveLocale()`.
+
+---
+
+## 📊 CONTRATO DE PAYLOAD (CrmLeadData → EVO CRM)
+
+### Contato (`POST /api/v1/contacts`)
+
+```json
+{
+  "name": "<data.name || data.phone>",
+  "phone_number": "<E.164 normalizado>",
+  "email": "<data.email | omitido se nulo>",
+  "additional_attributes": {
+    "utm_source": "...", "utm_medium": "...", "utm_campaign": "...",
+    "utm_content": "...", "utm_term": "...",
+    "pagina": "<pageUrl>", "formulario": "<formName>",
+    "fbclid": "...", "fbc": "...", "fbp": "...",
+    "ctwa_clid": "...", "ad_id": "...",
+    "mensagem": "<messageBody>", "anuncio": "<headline>",
+    "ltv_class": "...", "funil": "<funnelStage>",
+    "intencao": "<intentScore>", "evento": "<eventName>"
+  }
+}
+```
+
+### Conversa (`POST /api/v1/conversations`)
+
+```json
+{ "inbox_id": "<EVO_CRM_INBOX_ID>", "contact_id": "<id retornado>", "additional_attributes": {} }
+```
+
+### Nota interna (`POST /api/v1/conversations/{id}/messages`)
+
+```json
+{
+  "content": "📊 *Novo Lead*\n• Nome: João\n• Origem: facebook / cpc\n• Campanha: BlackFriday\n• Score: 85 · MOFU",
+  "message_type": "activity",
+  "private": true
+}
+```
+
+---
+
+## 🛡️ TRATAMENTO DE ERROS
+
+| Cenário | Comportamento |
+|---|---|
+| Secrets ausentes (`isCrmConfigured` false) | `return null` silencioso, sem fetch |
+| OAuth falha (não-200) | `console.warn` + `return null` |
+| Contact 422 (duplicata) | Extrai `id` de `body.id \|\| body.data.id \|\| body.data.contact.id` |
+| Contact 5xx ou rede | `return null` (sem retry — `/track` não bloqueia) |
+| Conversation falha | `console.warn` mas retorna `contactId` (parcial OK) |
+| Nota falha | Engole erro silenciosamente (best-effort) |
+
+---
+
+## 🧪 SMOKE TEST
+
+```bash
+# Teste com fetch stub (NÃO envia para CRM real):
+node server-edge-tracker/modules/dispatch/crm.smoke-test.mjs
+```
+
+Cobertura:
+- Phone normalization: BR (10/11/12/13 dig), E.164, PT (351), US (1)
+- 3 locales (pt-BR, en-US, es-ES) + locale inválido → fallback
+- 422 duplicate handling
+- OAuth fail → null
+- Wrappers `notifyEvolutionCTWA` e `notifyEvolutionForm`
+
+### Teste real contra VPS
+
+1. **Criar OAuth app** (uma vez por instância EVO CRM):
+   ```sql
+   INSERT INTO oauth_applications (name, uid, secret, scopes, redirect_uri, confidential, trusted)
+   VALUES ('CDP Edge Worker',
+           encode(gen_random_bytes(32), 'base64'),
+           encode(gen_random_bytes(32), 'base64'),
+           'read write',
+           'urn:ietf:wg:oauth:2.0:oob',
+           true, true);
+   ```
+2. **Pegar inbox**:
+   ```sql
+   SELECT id, name FROM inboxes WHERE channel_type='Channel::Whatsapp';
+   ```
+3. `wrangler secret put` os 4 obrigatórios
+4. Disparar lead via `/track` ou webhook → conferir contato + conversa + nota no painel EVO
+
+---
+
+## 🔧 INTEGRAÇÃO COM OUTROS AGENTES
+
+- **Webhook Agent** — invoca `pushLeadToCrm` em purchase/lead confirmado
+- **Lead Scoring Agent** — preenche `intentScore` antes do envio (vai pra `additional_attributes.intencao`)
+- **LTV Predictor Agent** — preenche `ltvClass` e `funnelStage`
+- **Server Tracking Agent** — chama no handler `/track` para CTWA/Form leads
+- **WhatsApp CTWA Setup Agent** — usa `notifyEvolutionCTWA` no fluxo CTWA
+- **Memory Agent** — guarda BASE_URL, CLIENT_ID, INBOX_ID por projeto cliente
+
+---
+
+## 📋 CHECKLIST DE ATIVAÇÃO
+
+- [ ] OAuth app criado com scope `read write` no Postgres do EVO CRM
+- [ ] Inbox WhatsApp existente (`channel_type='Channel::Whatsapp'`)
+- [ ] 4 secrets em `wrangler secret put` (BASE_URL, CLIENT_ID, CLIENT_SECRET, INBOX_ID)
+- [ ] (Opcional) DEFAULT_COUNTRY e LOCALE para mercados fora do BR
+- [ ] Smoke test (`crm.smoke-test.mjs`) passa todos os asserts
+- [ ] Lead real chega no inbox com nota interna preenchida
+- [ ] Atributos custom (UTMs, fbclid, ctwa_clid, intencao) visíveis no perfil do contato no painel EVO
+- [ ] Em caso de duplicata, contato existente é reaproveitado (não cria duplicado)
+
+---
+
+## 🎯 ARQUITETURA Quantum Tier
+
+| Pilar | Garantia |
+|---|---|
+| **Não-bloqueante** | `ctx.waitUntil` envolve a chamada — `/track` responde em <50ms mesmo com EVO lento |
+| **Atômico** | Falha em uma etapa não invalida as outras (best-effort) |
+| **Idempotente** | 422 (duplicata) é tratada como sucesso — reaproveita contato existente |
+| **Multi-tenant** | Cada projeto cliente usa seus próprios secrets (sem hardcode) |
+| **i18n nativo** | 3 locales + multi-country sem mudar código |
+| **Zero PII em logs** | Apenas status HTTP e prefixo de erro |
+
+---
+
+> 📋 **Sua Função:** Garantir que todo lead capturado pelo CDP Edge (CTWA, formulário, /track) chegue no EVO CRM como contato + conversa aberta + nota interna estruturada, com PII normalizada (phone E.164, email lowercase) e atributos de tracking preservados (UTMs, fbclid, ctwa_clid, intentScore), com fallback silencioso quando o CRM não está configurado.

package/extracted-skill/tracking-events-generator/agents/master-orchestrator.md

@@ -91,7 +91,7 @@ Master Orchestrator (você)
 │   ├── Database Agent                     → migrações D1, schema, índices
 │   ├── Domain Setup Agent                 → conecta track.clientdomain.com + cookie first-party
 │   ├── R2 Setup Agent                     → habilita R2, cria bucket, ativa audit log imutável
-│   └── CRM Integration Agent             → integração com CRMs externos (HubSpot, etc)
+│   └── EVO CRM Agent                     → roteia leads p/ EVO CRM (OAuth2 Doorkeeper)
 │
 ├── 💬 COMUNICAÇÃO E NOTIFICAÇÕES
 │   ├── WhatsApp Agent                     → automação Meta Cloud API + CallMeBot
@@ -173,7 +173,7 @@ SKILL_BASE: [diretório da skill tracking-events-generator]
     ├── database-agent.md                     ← migrações D1, schema, índices
     ├── domain-setup-agent.md                 ← track.clientdomain.com + Worker Route + cookie first-party
     ├── r2-setup-agent.md                     ← R2 bucket + audit log /events/YYYY-MM-DD/{uuid}.json
-    ├── crm-integration-agent.md              ← integração CRMs externos
+    ├── evo-crm-agent.md                      ← Agente EVO CRM (OAuth2)
     │
     ├── ── COMUNICAÇÃO ──
     ├── whatsapp-agent.md                     ← Meta Cloud API + CallMeBot Bridge
@@ -897,7 +897,8 @@ FASE 5 (Geração em paralelo):
   ├─ FASE 5-J: YouTube Agent        (gclid/wbraid/gbraid + video milestones)
   ├─ FASE 5-K: Microsoft Ads Agent  (UET Tag + Enhanced Conversions)
   ├─ FASE 5-D: Server Tracking Agent (index.ts — todos os platforms)
-  └─ FASE 5-E: Webhook Agent         (gateways: Hotmart, Kiwify, Eduzz, Ticto, etc.)
+  ├─ FASE 5-E: Webhook Agent         (gateways: Hotmart, Kiwify, Eduzz, Ticto, etc.)
+  └─ FASE 5-L: EVO CRM Agent         (roteia leads p/ EVO CRM)
 ```
 
 FASE 6 (Enterprise Features — ordem de configuração):
@@ -1079,8 +1080,13 @@ Exibir:
 **Bloco CartPanda** (incluir se CartPanda selecionado):
 > - `CARTPANDA_TOKEN` — Token CartPanda webhook
 
-**Bloco Monetizze** (incluir se Monetizze selecionado):
-> - `MONETIZZE_TOKEN` — Token Monetizze webhook
+**Bloco EVO CRM (OAuth2)** (incluir se CRM selecionado):
+> - `EVO_CRM_BASE_URL` — URL base (ex: https://api-evocrm.dominio.com)
+> - `EVO_CRM_CLIENT_ID` — OAuth client_id
+> - `EVO_CRM_CLIENT_SECRET` — OAuth client_secret
+> - `EVO_CRM_INBOX_ID` — ID do inbox no CRM
+> - `EVO_CRM_DEFAULT_COUNTRY` — Dial code default (ex: 55)
+> - `EVO_CRM_LOCALE` — Locale das notas (pt-BR | en-US | es-ES)
 
 **Sempre incluir:**
 > - `SITE_URL` — URL do seu funil/site (ex: https://meusite.com.br)

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": "2.5.3",
+  "version": "2.5.5",
   "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

@@ -366,8 +366,8 @@ 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"
+# pattern  = "cliente.com.br/track*"
+# zone_name = "cliente.com.br"
 ```
 
 #### 3. Fazer o deploy com as rotas