Reportes de marketing (gerente): embudo social, tarjeta por agente y atribución

Esta página es para gerentes. Los reportes de ingresos de esta sección exponen datos de toda la organización (revenue, desempeño por agente), así que están restringidos a gerentes. Un usuario no gerente que abra los reportes generales solo ve sus propios datos, nunca los de otros ni los agregados de la empresa.

Nota — de dónde salen los números. La atribución se arma sobre CRM Touchpoint (los "toques" que va dejando cada interacción). El "ROI" que verás es ingreso, no ganancia: el sistema no tiene datos de gasto publicitario, así que ROI = pesos generados. Interpreta esa columna como revenue atribuido, no como retorno neto.

Embudo social → pesos

Es el reporte que junta lo que antes vivía disperso: cuánto dinero te trajo cada origen social. Muestra, por origen, la cadena Prospectos → Tratos → Ganados → pesos.

Los tres orígenes:

Importante — atribución exclusiva, sin doble conteo. Un mismo Prospecto/Trato puede ser alcanzable desde dos orígenes (comentó y te escribió por DM). Para que los pesos no se cuenten dos veces, la atribución es exclusiva y por primer match, con esta prioridad: Comentario > Lead Ad > DM. Cada trato se cuenta en un solo origen (el primero que lo reclama). Por eso los renglones suman exacto al Total social de abajo — sin pesos inflados por origen.

Cómo leerlo:

1. Abre el reporte y elige el rango de fechas.
2. Compara orígenes: no solo cuántos prospectos, sino cuántos cerraron y cuántos pesos dejó cada uno.
3. Usa el Total social como el agregado limpio (ya viene deduplicado).

Nota — cohorte. Cada renglón se cohorta por la fecha del registro de origen (cuándo llegó el comentario/DM/prospecto); el trato ganado se cuenta cuando cerró.

Tarjeta por agente y por territorio/sucursal

El reporte de desempeño que nada mostraba, aunque el dato ya se registraba. Por defecto va del inicio del mes a hoy. Por cada agente:

• Mensajes humanos enviados (WhatsApp; se lee de la provenance doco_actor_user, solo mensajes marcados como Humanos),
• Latencia promedio de primera respuesta (su respuesta menos el último entrante que la precede en la misma conversación dentro de 24h — así una respuesta a un mensaje de ayer no cuenta como "lenta"),
• Tratos que posee, Ganados, pesos ganados, % de conversión,
• Llamadas (CRM Call Log) y, en tenants de taller, reparaciones entregadas por técnico,
• % de SLA cumplido y tiempo de primera respuesta nativo (de los campos sla_status / first_response_time del Trato).

La tabla se ordena por pesos ganados (y volumen enviado como desempate).

Además, dos desgloses de contexto:

• Por territorio: agrupa Tratos por CRM Deal.territory. Es un proxy de sucursal (es el único eje a nivel trato que existía antes). Solo métricas de tratos; los mensajes no cargan territorio.
• Por sucursal (doco_shop): cuando el tenant tiene la dimensión de sucursal instalada, este desglose real por doco_shop supera al proxy de territorio. Se devuelven ambos por compatibilidad.

Advertencia — Messenger no atribuye agente. La latencia y el volumen de mensajes son solo de WhatsApp: el doctype Messenger Message no tiene columna de agente. No interpretes "0 mensajes" de un agente que solo atiende por Messenger como que no trabajó.

Atribución y ROI de campañas

Dos reportes, ambos solo gerente, ambos sobre CRM Touchpoint:

• Atribución de campañas: por campaña, contactos tocados + tratos ganados tocados + su ingreso. Atribución "último toque".
• ROI de campañas: el embudo completo por campaña — enrolados → enviados por estado (Sent/Failed/Skipped/Pending) → contactos tocados → tratos ganados → pesos. Las campañas nunca usadas no aparecen (no rellenan el reporte). Se ordena por ingreso desc.

Nota. "ROI" en ambos es ingreso, no retorno (no hay datos de gasto). Úsalo para comparar campañas entre sí, no como rentabilidad absoluta.

Otros tableros útiles

• Distribución de puntaje: dona de prospectos no convertidos por grado A/B/C/D + Ungraded. Salud del embudo de un vistazo. (Ver la página de Puntaje y auto-asignación.)
• Embudo de conversión y embudo por etapa del pipeline: el primero es la conversión Prospecto→Trato en barras horizontales; el segundo es la distribución real por estado del Trato (no mezcla la conversión y no rebasa 100%). Ambos respetan la jerarquía organizacional del usuario.
• Desglose por origen: prospectos y tratos por fuente.
• KPIs del reporte (solo gerente): total de prospectos, tratos ganados, distribución de puntaje y grado promedio. Si no pasas fechas, usa del inicio del mes a hoy.

Diagnóstico de envíos: ¿por qué no se mandó?

Cuando una campaña "no llegó", este reporte te lo explica en una sola vista (por defecto, últimos 7 días). Cuenta los renglones de Marketing Send Log por estado y:

• separa los Pending en vivos vs. Diferidos con su motivo (kill-switch, tope diario, canal no configurado — estampados por el motor de envío), y
• lista los motivos más comunes de Skipped/Failed (suprimido/opt-out, ventana de 24h vencida, plantilla faltante, fallas de entrega de Meta).

Importante — cómo usarlo. Si un cliente reclama que no le llegó algo, empieza aquí: un Diferido te dice que fue una decisión del sistema (p. ej. tope diario), mientras que un Failed con motivo de Meta apunta a un problema de plantilla o de la cuenta. El tope de frecuencia por contacto vive en Configuración de Marketing → Max Marketing Messages per Contact per Day (max_marketing_messages_per_day, por defecto 1; 0 = sin tope).

Auditoría de higiene de tratos

Lista tratos abiertos con problemas: sin dueño, sin sucursal, sin contacto, sin documentos, con SLA vencido o que se quedaron callados.

Nota — alcance por rol. Un gerente ve todo (y puede filtrar por sucursal/dueño); un representante solo ve los problemas de sus propios tratos. Úsalo como checklist semanal para que ningún trato abierto quede a medio capturar.

[VERIFICAR: nombres exactos de los reportes/tarjetas en la SPA en español (títulos de "Embudo social", "Tarjeta por agente", "Atribución de campañas", "Diagnóstico de envíos", "Higiene de tratos") y las etiquetas de columnas visibles.]