## Visión general

**Engagement y Lead Score** mide qué tan comprometido está cada **contacto** y calcula una
**puntuación de lead** configurable. Cada interacción relevante se convierte en un evento en una
**línea de tiempo** (timeline) vinculada al contacto — y esa línea **sobrevive** aunque se elimine la
conversación o el negocio de origen, porque los eventos se guardan de forma independiente.

Defines un **catálogo de eventos** (una especie de "pixel" de comportamiento), organizas los eventos
en **grupos de puntos** y asignas **pesos** a cada uno. Eventos reales del producto — mensajes,
negocios, follow-ups, pagos, citas, ventas del catálogo, correos — se mapean a ese catálogo y suman (o
no) puntos según el peso. Con esto, tu equipo prioriza los leads más calientes.

Este módulo es el **eje del lead** (el contacto), complementario al módulo de Ventas, que es el **eje
del actor** (el vendedor). Cuando tiene sentido, un mismo evento puede dar **crédito doble**: puntos de
engagement para el contacto y, si el actor es un vendedor, XP para el vendedor en el módulo de Ventas.

## Requisitos previos

- El módulo **Engagement y Lead Score** habilitado en la cuenta (función opcional, activada por un
  administrador/operador).
- El permiso de **gestión de engagement** para configurar el catálogo de eventos, los grupos y los
  pesos.
- Eventos reales fluyendo en la plataforma (conversaciones, mensajes, CRM, pagos, agenda, follow-ups,
  catálogo) para alimentar la puntuación.
- Para el crédito doble de XP del vendedor, el módulo de **Ventas y Gamificación** también debe estar
  habilitado.

## Paso a paso

1. **Arma el catálogo de eventos.** Registra los eventos que quieres seguir (cada uno con nombre,
   grupo, ícono y puntos por defecto).
2. **Define los grupos de puntos.** Agrupa eventos por tema (por ejemplo, atención, compra,
   marketing).
3. **Ajusta los pesos.** Da más puntos a los eventos más importantes; usa **peso 0** para solo
   registrar (seguir) sin puntuar.
4. **Elige la política de deduplicación** por evento: contar siempre, una vez por contacto, o con
   intervalo (cooldown).
5. **Sigue la línea de tiempo.** En el panel del contacto, ve la línea de tiempo de engagement y el
   **lead score**.
6. **Prioriza y segmenta.** Ordena listas por la puntuación y crea segmentos de los leads más
   calientes.
7. **(Opcional) Rastrea eventos externos.** Usa el rastreador (pixel) con token para registrar eventos
   fuera de la plataforma.

## Configuración y opciones

- **Catálogo de eventos (definiciones)**: clave, nombre, grupo, ícono, puntos por defecto y si está
  activo.
- **Grupos de puntos**: contadores nombrados que suman puntos por tema.
- **Pesos**: puntuación por evento (incluyendo **0** para registrar sin puntuar).
- **Deduplicación**: contar siempre, una vez por contacto, o con cooldown (intervalo configurable).
- **Lead score**: puntuación general y por grupo, mostrada en el contacto y usable para
  ordenar/segmentar.
- **Crédito doble**: el mismo evento puede puntuar al contacto (engagement) y al vendedor (XP en
  Ventas).
- **Rastreador (pixel)**: un endpoint público verificado por token para eventos externos.
- **Retención**: un período opcional de retención de los eventos de la línea de tiempo (sin
  decaimiento de puntos en la v1).

## Casos de uso

- Priorizar la fila de leads por los contactos con mayor puntuación.
- Crear un segmento de "leads calientes" para una acción de ventas dirigida.
- Seguir el recorrido de un contacto en una única línea de tiempo, incluso tras archivar
  conversaciones.
- Registrar comportamientos fuera de la plataforma (visita a una página, apertura de correo) vía el
  pixel.

## Consejos, límites y buenas prácticas

- Empieza con pocos eventos de alto valor; refina los pesos con el tiempo.
- Usa peso 0 para probar un evento nuevo antes de decidir cuánto vale.
- Elige la política de deduplicación adecuada para no inflar la puntuación (ej.: "una vez por
  contacto" para registros).
- Recuerda: en la v1 no hay decaimiento de puntos — la puntuación es acumulativa.

## Solución de problemas

- **El lead score no cambia**: confirma que el evento está activo en el catálogo, con peso mayor que
  0, y que los eventos reales están ocurriendo.
- **Un evento contó de más**: revisa la política de deduplicación (quizá necesites "una vez por
  contacto" o un cooldown).
- **La línea de tiempo desapareció tras eliminar una conversación**: no desaparece — los eventos de
  engagement se preservan de forma independiente del origen.
- **El pixel externo no registra**: verifica el token del rastreador y los límites de solicitud.

## Ver también

- [Visión general de Ventas y Gamificación](/hc/ajuda/articles/sales-gamification-overview-es)
- [Gestión de ventas: cartera, aislamiento por vendedor y metas](/hc/ajuda/articles/sales-gamification-gestao-de-vendas-carteira-metas-es)
- [Gamificación, leaderboard, recompensas y comisiones](/hc/ajuda/articles/sales-gamification-gamificacao-leaderboard-recompensas-comissoes-es)
- [TELÓN (wallboard) en tiempo real](/hc/ajuda/articles/sales-gamification-telao-wallboard-es)