Inicio

Closevibe Wiki — Documentación Interna

AI Sales Infrastructure for eCommerce — Documentación técnica completa del monorepo Closevibe.

¿Qué es Closevibe?

Closevibe es una infraestructura de ventas con IA para eCommerce — no un chatbot, no un CRM, sino una capa de revenue que conecta conversaciones con resultados de negocio (ventas reales).

Tesis central: Cada conversación es una oportunidad de venta. Closevibe convierte cada interacción en un lead estructurado dentro de un pipeline visual, automatiza el follow-up con IA bajo reglas de confianza configurables, y hace visible el ROI dentro del producto.

Estructura del Monorepo

PaquetePuertoStackDescripción
closevibe-backend/3000Express + TypeScript + Prisma + PostgreSQL + RedisAPI REST principal, 125+ endpoints
closevibe-frontend/5174React 18 + Vite + Tailwind + MantineSPA legacy + Backoffice admin
closevibe-dash/3000Next.js + TypeScriptDashboard nuevo (reemplaza legacy)
closevibe-videos/3200Express + Remotion + Playwright + FFmpegMicroservicio de generación de video
closevibe-site-template/3180Next.js 15 + React 19 + Tailwind v4Template de marketing site
closevibe-wiki/3300Next.js 14 + Nextra 2Esta documentación

Las 7 Capas Funcionales

┌─────────────────────────────────────────────────────┐
│  7. Analytics & Reporting Layer                     │
├─────────────────────────────────────────────────────┤
│  6. Lifecycle & Recovery Engine                     │
├─────────────────────────────────────────────────────┤
│  5. CRM Layer (eCommerce only)                      │
├─────────────────────────────────────────────────────┤
│  4. Chatbot Response Engine                         │
├─────────────────────────────────────────────────────┤
│  3. AI Sales Brain (Intent + Retrieval + Scoring)   │
├─────────────────────────────────────────────────────┤
│  2. Commerce Knowledge Layer (Scraping / API Sync)  │
├─────────────────────────────────────────────────────┤
│  1. Conversation & Channel Layer (Multi-channel)    │
└─────────────────────────────────────────────────────┘
  1. Conversation & Channel — Unifica Web widget, WhatsApp, Instagram, Messenger, Email, SMS. Normaliza payloads, persiste conversaciones, resuelve identidad de lead.
  2. Commerce Knowledge — MVP 1: scraping estructurado (PDP detection, extracción de productos). MVP 2: sync vía APIs de plataforma.
  3. AI Sales Brain — Clasificación de intent, retrieval jerárquico (datos estructurados → RAG → fallback seguro), scoring de confianza.
  4. Chatbot Response Engine — Formatea y envía respuestas por canal, registra links con link_id para tracking, soporta human handoff.
  5. CRM Layer — Pipeline Kanban (New → Engaged → High Intent → Link Sent → Follow-up Pending → Re-engage → Converted → Lost), lead cards, timeline completo.
  6. Lifecycle & Recovery — Follow-ups autónomos basados en inactividad + alto intent. MVP 1: follow-up por señales. MVP 2: cart recovery real.
  7. Analytics & Reporting — Leads, links enviados, follow-ups, movimientos de pipeline, conversiones marcadas.

Dos Tipos de Cliente

Tipo A — Custom Sites (MVP 1)Tipo B — Plataformas (MVP 2)
TargetWordPress/WooCommerce sin API, Webflow, CMS customShopify, PrestaShop (con APIs)
DataScraping commerce-gradeSync vía API/webhooks
RecoveryPurchase follow-up por señales conversacionalesCart recovery real con eventos
LinksConfidence media (scraped)Confidence alta (API)

Modo B2B (Feature Flags)

Para tenants B2B: Solo capa de chatbot. IA responde y dirige hacia una acción (ej. booking Calendly). CRM pipeline, recovery y dashboards de revenue se ocultan via feature flags.

Navegación Rápida

Glosario Interno

TérminoDefinición
Purchase follow-upFollow-up basado en intent/señales conversacionales, sin evento real de carrito (MVP 1)
Cart recoveryRecovery disparado por evento real de checkout/abandono con links dinámicos (MVP 2)
Intent scoreIntent de compra derivado del contenido de la conversación
Conversion probability %Probabilidad estimada de compra mostrada en CRM
Link confidenceConfianza interna en la validez/estabilidad de un link (alta para plataformas, media para scraped)
Commerce-grade scrapingScraping que detecta PDPs con alta precisión, extrae datos estructurados de producto
TenantNegocio (business) en el sistema multi-tenant
Business contextMiddleware que resuelve el tenant actual en cada request