Puntaje de prospectos y auto-asignación (reparto de prospectos)

Dos automatismos trabajan juntos para que ningún prospecto tibio se enfríe:

1. Puntaje (lead scoring): le pone una calificación de 0 a 100 y una letra A/B/C/D a cada Prospecto, según reglas que tú defines. Así sabes a quién marcarle primero.
2. Auto-asignación: le pone dueño a cada prospecto nuevo automáticamente, repartiendo la carga entre tu equipo, para que un prospecto de Facebook o WhatsApp nunca aterrice sin responsable.

Parte 1 — Puntaje de prospectos

Cómo se calcula

El puntaje es la suma de los puntos de todas las reglas habilitadas que el prospecto cumple, recortada al rango 0 a 100. No hay machine learning: son reglas explícitas que tú controlas (en el arranque no hay datos históricos de conversión, así que las reglas mandan).

La letra sale del puntaje:

Nota. El puntaje solo corre si Configuración de Marketing → Enable Lead Scoring (enable_scoring) está prendido (viene prendido por defecto).

Crear una regla de puntaje (Lead Scoring Rule)

1. Entra a Reglas de puntaje y toca Nueva. [captura: lista de Lead Scoring Rule]
2. Llena la regla:
   • Rule Name (obligatorio, único): un nombre claro, ej. "Origen Facebook".
   • Enabled: prendida para que cuente.
   • Lead Field (field): el fieldname del campo en CRM Lead que quieres evaluar, ej. source, territory, industry, email.
   • Operator: cómo comparar. Opciones:
     • equals / not equals (igual / distinto),
     • is set / is not set (tiene valor / está vacío),
     • contains (contiene el texto),
     • greater than / less than (mayor / menor, numérico),
     • in (está en una lista separada por comas).
   • Value: el valor a comparar. Para in, sepáralos por comas.
   • Points: cuántos puntos suma cuando la regla se cumple. Puede ser negativo (para castigar señales malas).
3. Guarda.

Ejemplo: regla "Origen Facebook" → campo source, operador equals, valor Facebook, puntos +20. Otra: "Sin correo" → campo email, operador is not set, puntos -10.

Cuándo se recalcula el puntaje

• Al crear el prospecto: se puntúa de inmediato (registro con trigger Activity) y se estampa un touchpoint de origen.
• Al reevaluar reglas (trigger Rule Evaluation): cuando editas el conjunto de reglas y corres un recálculo masivo.
• Decaimiento diario (Decay): un prospecto sin actividad por 30 días pierde 5 puntos. Cualquier actividad vuelve a aplicar el puntaje completo de las reglas.

Cada cambio queda registrado en CRM Lead Score Log, con: prospecto, puntaje nuevo, puntaje previo, delta, trigger (Rule Evaluation / Decay / Manual / Activity) y hora. Así puedes auditar por qué un prospecto subió o bajó.

Importante — cruces de umbral disparan campañas. Cuando el puntaje cruza un umbral, el sistema puede enrolar al prospecto en una campaña (motor de campañas). O sea: subir de C a B no es cosmético; puede activar seguimiento automático.

Probar reglas antes de aplicarlas (preview)

Antes de guardar cambios grandes, previsualiza el efecto sin persistir nada.

1. En el editor de reglas, usa Vista previa.
2. El sistema recalcula el puntaje de una muestra de prospectos no convertidos y te muestra, por cada uno: puntaje/grado viejo vs. nuevo. Nada se guarda.

Nota — distribución. El tablero de reportes trae una dona de distribución de grados (cuántos prospectos no convertidos hay en A, B, C, D y Ungraded — sin calificar). Úsala para ver la salud de tu embudo de un vistazo.

Parte 2 — Auto-asignación (reparto de prospectos)

Cómo reparte

Cada Prospecto nuevo se asigna a un dueño con balanceo por menor carga: entre los usuarios elegibles, el que tiene menos prospectos propios se lleva el siguiente. Es un reparto tipo round-robin pero autoequilibrante, sin contadores que se puedan corromper.

Nota. El sistema nunca pisa un dueño existente: si el prospecto ya llega con lead_owner (por ejemplo, porque se ligó a un Contacto con trato previo), la auto-asignación no hace nada.

Prenderla y configurar el equipo

1. Ve a Configuración de Marketing → Auto-assign new leads (auto_assign_enabled) y préndela (viene apagada por defecto).
2. Define el Assign pool (users) (auto_assign_users): correos de los usuarios, uno por línea (o separados por comas).
   • Si lo dejas en blanco, el pool son todos los Sales User habilitados (menos Administrator y Guest).
3. Guarda.

Reparto por sucursal

Si el prospecto trae sucursal (doco_shop), el sistema prefiere su propia sucursal: reparte solo entre los miembros del pool que estén asignados a esa sucursal (por User Permission usuario↔Social Shop).

Importante. Si el prospecto no trae sucursal, o ningún miembro del pool pertenece a esa sucursal, cae de vuelta al pool completo. Un prospecto jamás debe quedarse sin asignar solo porque su sucursal no tiene a nadie en la rotación.

Qué pasa al asignar

El sistema pone el lead_owner (la fuente de verdad) y además crea un ToDo (la asignación visible en la agenda del usuario). Si el ToDo falla por alguna razón, no importa: el lead_owner ya quedó puesto.

Advertencia. La auto-asignación está diseñada para nunca romper la creación del prospecto. Si algo falla en el reparto, registra el error internamente y deja el prospecto creado (aunque sea sin dueño), en vez de tumbar el alta. Si notas prospectos sin dueño con la función prendida, revisa que el pool tenga usuarios habilitados y que existan Sales Users.

[VERIFICAR: nombres exactos de los botones "Nueva", "Vista previa" y las etiquetas en español de los campos de Configuración de Marketing (auto_assign_enabled, auto_assign_users, enable_scoring).]