Visión general
El módulo de Ventas de Conversa Labs tiene superficies de consumo (donde lees los números) y una superficie en vivo (el telón/wallboard). Las de consumo son tres:
- Panel del Vendedor — la lectura individual: tus monedas, badges, nivel, puntos del mes y el progreso de tus metas.
- Panel del Gestor — la vista agregada del equipo, armada a partir del ranking (leaderboard), los Informes y el telón.
- Informes de ventas — el panel analítico de cumplimiento, historial de comisiones (payout) e historial de ranking (leaderboard), con exportación en CSV.
Por encima de todo esto, el telón (wallboard) muestra el ranking en vivo en un TV de la oficina. En todas las superficies, los números derivan de eventos reales del producto — negocios ganados en el CRM, pagos confirmados, agendamientos, follow-ups que convierten. No hay carga manual: lo que lees es lo que la operación realmente produjo.
Requisitos previos
- Módulo Ventas y Gamificación habilitado en la cuenta.
- Eventos reales fluyendo por la plataforma (negocios en el CRM, pagos, agendamientos) para que haya algo que puntuar e informar.
- Metas activas en el período vigente, para que el cumplimiento tenga referencia.
- Para abrir los Informes de ventas y las exportaciones CSV (incluido el libro de un vendedor
específico) se necesita el permiso de gestión de ventas (
sales_manage) — o ser administrador. El Panel del Vendedor no lo exige.
Paso a paso
- Abre el Panel del Vendedor. De un vistazo, revisa saldo de monedas, badges, nivel, puntos del mes y el progreso de hasta 5 metas activas.
- Sigue el ranking. Mira tu posición en el leaderboard (por métrica, período y alcance) y en el telón en vivo.
- Gestor: abre los Informes de ventas. Lee las tres secciones — cumplimiento, historial de payout e historial de leaderboard.
- Aplica filtros. Acota por período, vendedor, métrica y alcance para responder una pregunta concreta.
- Exporta a CSV. Descarga el extracto de comisiones o el historial de ranking para conciliar o analizar fuera de la plataforma.
Configuración y opciones
Panel del Vendedor
La lectura individual es siempre de tu propia cartera. Los widgets:
| Widget | Qué muestra | De dónde viene |
|---|---|---|
| Saldo de monedas | Monedas disponibles para canjear | Suma del extracto de monedas (créditos menos débitos) |
| Badges conseguidos | Cuántas medallas has ganado | Premios de badge otorgados a ti |
| Nivel actual | Tu nivel y los puntos acumulados que lo sostienen | El mayor nivel cuyo umbral de puntos superaste |
| Puntos del mes | Puntos sumados en el mes corriente | Eventos de puntos del mes vigente |
| Metas activas | Hasta 5 metas (la tuya, la de tu equipo y la de la cuenta) con % de cumplimiento | Metas vigentes más el cumplimiento calculado |
Panel del Gestor
El gestor consolida al equipo a partir de tres fuentes: el leaderboard (ranking por métrica × período × alcance), los Informes de ventas (cumplimiento, payout e historial de ranking) y el telón en vivo. Aquí es donde cartera, metas y ranking se conectan: la cartera define el dueño de cada negocio, las metas definen el objetivo y el ranking ordena quién está más cerca de cumplir. El Panel del Vendedor sigue siendo individual incluso para el gestor — la vista de equipo viene del ranking y de los Informes.
Informes de ventas
El overview analítico trae tres secciones:
| Sección | Qué trae |
|---|---|
| Cumplimiento (attainment) | % de cumplimiento por meta vigente, con el valor actual y la fecha del cálculo (hasta 50 metas, de mayor a menor) |
| Historial de payout | Totales de comisión por período: acumulado, aprobado y pagado |
| Historial de leaderboard | El ganador (1er lugar) por período y métrica |
Filtros disponibles:
| Filtro | Efecto |
|---|---|
Período (period_start) |
Considera registros a partir de la fecha indicada |
Vendedor (payee_id) |
Restringe al extracto de un vendedor (libro individual) |
Métrica (metric) |
Filtra el historial de ranking por la métrica |
Alcance (scope_type) |
Filtra el historial de ranking por tipo de alcance (cuenta/equipo/vendedor) |
Exportación CSV
La exportación acepta ?kind=commissions o ?kind=leaderboard (sin el parámetro, el valor por
defecto es comisiones):
| Exportación | Cuándo usar | Columnas |
|---|---|---|
Comisiones (?kind=commissions) |
Conciliar payout y contabilidad | payee_id, period_start, period_end, status, total_accrued, total_approved, total_paid |
Leaderboard (?kind=leaderboard) |
Analizar el historial del ranking | rank, user_id, team_id, scope_type, period_type, period_start, metric, value, trend |
Permisos y privacidad
- El Panel del Vendedor está aislado por vendedor: cada métrica (monedas, badges, nivel, puntos) se filtra por tu usuario. Un vendedor no ve los números de otro.
- El ranking (leaderboard/telón) es la vista compartida de la competencia.
- Los Informes de ventas y las exportaciones CSV exigen el permiso de gestión de ventas. Traer el libro de un vendedor específico (filtro por vendedor) también es una acción de gestión.
Casos de uso
- El vendedor abre el panel por la mañana y ve, en segundos, qué tan cerca está de la meta del mes.
- El gestor usa los Informes para detectar quién está por encima y por debajo del cumplimiento por meta.
- Finanzas exporta el CSV de comisiones para conciliar el payout del período.
- La dirección exporta el historial de leaderboard para analizar cómo evolucionó el ranking a lo largo de los períodos.
Consejos, límites y buenas prácticas
- Trata el Panel del Vendedor como un ritual diario — es la forma más rápida de ver el progreso de la meta.
- En los Informes, empieza sin filtros y acota de a poco; filtros demasiado estrictos pueden vaciar el resultado.
- El cumplimiento lista las metas vigentes de mayor a menor — úsalo para priorizar a quien necesita apoyo.
- La exportación de comisiones refleja el extracto (payout); la de leaderboard refleja los snapshots del ranking. Elige la que responde tu pregunta.
Solución de problemas
- Panel en cero: probablemente no hay eventos puntuables en el período (negocios, pagos, agendamientos) o no hay metas activas. Confirma el uso de CRM/Pagos/Agenda y la existencia de metas vigentes.
- Informe vacío: los filtros pueden estar demasiado estrictos o el alcance equivocado. Amplía el período, limpia el filtro de vendedor/métrica y revisa el tipo de alcance.
- Exportación bloqueada: no tienes el permiso de gestión de ventas. Pide a un administrador que conceda el perfil adecuado.