Gestión de leads

Los Leads representan prospects fríos que aún no son clientes ni oportunidades abiertas. Tras el rediseño CRM 2026-Q2, un Lead es una entidad de prospecting puro: al calificarse, se convierte en un Deal (oportunidad) vinculado a un Contact y, opcionalmente, a una Company.

Cambio de modelo (2026-Q2): antes del rediseño, el Lead mezclaba prospect frío y oportunidad en pipeline. Ahora Lead solo representa el prospect; la oportunidad con stage/valor/cierre vive en la entidad separada Deal. Ver Resumen CRM.

Crear un lead

Un lead puede crearse de varias formas:

• Manual: desde CRM → Leads → Nuevo lead (C desde la lista).
• Formulario web: formulario embebido en el sitio web o Zentto Store.
• Landing: formularios de Zentto Landings con X-Tenant-Key.
• Importación: carga masiva desde archivo CSV.
• API: integración con fuentes externas (redes sociales, landing pages).

Al ingresar un lead, el sistema busca o crea automáticamente el Contact (por email/teléfono) y la Company (por dominio del email).

Campos del lead

Campo	Obligatorio	Descripción
Contact (Nombre + Email)	Sí	Se busca o crea automáticamente
Teléfono	No	Número de contacto
Empresa (Company)	No	Se matchea por dominio del email
Fuente	Sí	De dónde proviene el lead
Estado	Sí	NEW / CONTACTED / QUALIFIED / DISQUALIFIED / CONVERTED
Vendedor asignado (SDR)	No	Responsable del seguimiento
Notas	No	Observaciones iniciales

Fuentes de leads

Las fuentes se configuran en CRM → Configuración → Fuentes:

• WEBSITE — Sitio web corporativo
• LANDING — Zentto Landings (paid-ads)
• FORM — Formulario embebido Zentto Store
• REFERRAL — Referido por cliente/partner
• IMPORT — Importación CSV
• API — API pública (integración externa)
• Manual: llamada entrante, evento/feria, publicidad offline

Estados del lead (ciclo de vida)

Estado	Descripción
NEW	Recién capturado, sin evaluar
CONTACTED	Se ha establecido primer contacto (llamada/email/reunión)
QUALIFIED	Tiene potencial real, listo para convertir a Deal
DISQUALIFIED	No cumple criterios mínimos (archivado)
CONVERTED	Convertido a Deal (no editable, trazabilidad via ConvertedToDealId)

Asignación

Los leads se asignan a vendedores SDR:

• Round-robin: distribución automática equitativa entre SDRs activos (default).
• Manual: el supervisor asigna individualmente.
• Por territorio: asignación según ubicación geográfica del lead.
• Bulk reassign: seleccionar múltiples leads → BulkActionBar → Reasignar.

Conversión a Deal

Solo los leads en estado QUALIFIED pueden convertirse:

1. Abrir el drawer del lead (Enter en la lista o click).
2. Clic en Convert to Deal (o tecla rápida en el drawer).
3. Se abre FormDialog con datos prefijados (Contact, Company, pipeline default).
4. Ajustar valor estimado, fecha de cierre y stage inicial.
5. Guardar (Cmd-Enter):
   • Se crea el Deal con Status = OPEN.
   • El lead pasa a CONVERTED, se popula ConvertedToDealId.
   • El Contact ya existía (no se duplica).
   • Toast de éxito + deep-link al drawer del Deal.

Importante: el Contact NO se promociona a master.Customer en este momento. Esa promoción ocurre solo cuando el Deal gana (WON) y se emite una factura.

Métricas de leads

• Leads por fuente: qué canales generan más leads.
• Tasa de calificación: QUALIFIED / total.
• Tasa de conversión: CONVERTED / QUALIFIED.
• Tiempo de respuesta: desde la captación hasta CONTACTED.
• Velocity: tiempo promedio NEW → QUALIFIED y QUALIFIED → CONVERTED.
• Leads por vendedor: distribución de carga del equipo.

Atajos (desde la lista)

Atajo	Acción
C	Nuevo lead
J / K	Navegar filas
Enter	Abrir drawer
/	Focus en quick search
G + D	Ir a Deals (para ver conversiones)

Lista completa: ver Resumen CRM — Atajos.

Flujo del usuario

Vista no técnica del proceso. Pensada para personal de operación, contabilidad, ventas o administración.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo técnico

Vista técnica para desarrolladores: endpoints, stored procedures/funciones, tablas y servicios involucrados.

Componente	Tipo	Ubicación
POST /v1/crm/leads	Route Express	web/api/src/routes/crm/leads
PATCH /v1/crm/leads/:id/qualify	Route Express	web/api/src/routes/crm/leads
POST /v1/crm/leads/:id/convert	Route Express	web/api/src/routes/crm/leads
POST /v1/crm/leads/public	Route Express (pública)	web/api/src/routes/crm/leads
usp_CRM_Lead_Insert	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_CRM_Lead_Qualify	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_CRM_Lead_Convert	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_CRM_Lead_List	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
crm.Lead	Tabla operativa	web/api/migrations/postgres/
crm.Contact	Tabla FK	web/api/migrations/postgres/
LeadsListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-crm/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.