Actividades comerciales

Las actividades son el registro de todas las interacciones del equipo comercial con leads y clientes. Permiten llevar un seguimiento detallado y garantizar que ninguna oportunidad quede sin atención.

Tipos de actividades

Tipo	Icono	Descripción
Llamada	Teléfono	Llamada telefónica realizada o recibida
Email	Sobre	Correo electrónico enviado o recibido
Reunión	Calendario	Reunión presencial o virtual
Seguimiento	Reloj	Recordatorio de contactar al cliente
Demo	Pantalla	Demostración de producto o servicio
Nota	Documento	Nota interna sobre el lead/cliente

Registrar una actividad

1. Desde el detalle del lead u oportunidad, clic en + Actividad.
2. Seleccionar el tipo de actividad.
3. Completar:
   • Fecha y hora: cuándo ocurrió o está programada.
   • Duración: tiempo empleado (para llamadas y reuniones).
   • Resumen: descripción breve del contenido.
   • Resultado: exitoso, sin respuesta, reprogramar, etc.
   • Próximo paso: acción siguiente acordada.

Actividades programadas

Las actividades futuras aparecen en el calendario del vendedor y generan recordatorios automáticos. El vendedor puede ver:

• Hoy: actividades pendientes para el día.
• Esta semana: vista semanal del calendario.
• Vencidas: actividades programadas que no se completaron.

Completar una actividad

Al completar una actividad programada:

1. Marcar como completada con un clic.
2. Registrar el resultado de la interacción.
3. Opcionalmente programar la siguiente actividad de seguimiento.
4. La actividad queda en el historial del lead/oportunidad.

Vista del supervisor

El supervisor tiene acceso a métricas de actividad del equipo:

Métrica	Descripción
Actividades por vendedor	Cantidad de interacciones por persona
Actividades por tipo	Distribución de llamadas, emails, reuniones
Tasa de completitud	Porcentaje de actividades programadas que se cumplen
Actividades vencidas	Seguimientos pendientes sin atender
Promedio diario	Actividades promedio por vendedor por día

Alertas automáticas

El sistema genera alertas cuando:

• Un lead no tiene actividad en X días (configurable).
• Una actividad programada está vencida.
• Una oportunidad de alto valor no tiene seguimiento reciente.
• Un vendedor tiene actividades acumuladas sin completar.

Historial

Todas las actividades se almacenan en el historial del lead/cliente, creando una línea temporal completa de la relación comercial. Este historial es visible para cualquier vendedor autorizado, facilitando la continuidad cuando se reasignan cuentas.

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
GET /v1/crm/activities	Route Express	web/api/src/routes/crm/activities
POST /v1/crm/activities	Route Express	web/api/src/routes/crm/activities
PATCH /v1/crm/activities/:id	Route Express	web/api/src/routes/crm/activities
usp_CRM_Activity_List	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_CRM_Activity_Insert	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_CRM_Activity_Complete	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_CRM_Activity_Metrics	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
crm.Activity	Tabla operativa	web/api/migrations/postgres/
crm.ActivityReminder	Tabla recordatorios	web/api/migrations/postgres/
crm.Timeline	Tabla auditoría	web/api/migrations/postgres/
ActividadesListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-crm/src/

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