Ventas y Gamificación
Por Conversa Labs
Por Conversa Labs
Gestión de ventas, cartera, metas, meta-sobre-meta, gamificación, leaderboard, recompensas, comisiones, TELÓN y lead score.
Visión general de Ventas y Gamificación
Visión general El módulo Ventas y Gamificación de Conversa Labs convierte tu operación de atención en una máquina de ventas medible y motivada. Reúne, en un solo lugar, la gestión de ventas (cartera de clientes por vendedor, metas y distribución), la gamificación (leaderboard, puntos, niveles, ligas, insignias y trofeos), la economía de recompensas (monedas y catálogo de premios), las comisiones y un TELÓN (wallboard) en tiempo real para mostrar el ranking en vivo. El gran diferencial: los números provienen de eventos reales del producto. Cuando se gana un negocio en el CRM, se confirma un pago, ocurre una venta del catálogo, se agenda una cita o un follow-up convierte, el módulo registra puntos automáticamente — sin digitación manual de planilla. La plataforma también incluye Engagement y Lead Score, que mide el engagement de cada contacto y calcula una puntuación de lead configurable. Requisitos previos - Una cuenta Conversa Labs activa con el módulo Ventas y Gamificación habilitado (función opcional, activada por un administrador/operador). - Para las funciones de engagement y puntuación de leads, el módulo Engagement y Lead Score también debe estar habilitado. - Un rol de acceso con el permiso de gestión de ventas para configurar metas, recompensas y comisiones. Los vendedores suelen recibir un rol con acceso a su propia cartera y ranking. - Eventos reales fluyendo en la plataforma (negocios en el CRM, pagos, citas, etc.) para que el marcador tenga qué puntuar. Paso a paso 1. Pide a un administrador que habilite el módulo en tu cuenta. 2. Define los roles de acceso de ventas (por ejemplo, vendedor y gerente de ventas) y asígnalos al equipo. 3. Organiza la cartera de clientes: cada vendedor pasa a tener sus contactos, conversaciones y negocios. 4. Crea las primeras metas (y, si quieres, los niveles de meta-sobre-meta) por período. 5. Activa la gamificación: confirma las fuentes de puntos, las insignias y el leaderboard. 6. Arma la economía de recompensas (monedas y catálogo) y/o los planes de comisión. 7. Abre el TELÓN en un televisor de la oficina o comparte el enlace de exhibición. 8. Sigue los Informes para medir el cumplimiento, el payout y la evolución. Configuración y opciones - Gestión de ventas: cartera, aislamiento por vendedor, transferencia, distribución y metas. - Gamificación: leaderboard, puntos, niveles, ligas, concursos, insignias y reconocimiento. - Recompensas: monedas, catálogo de premios y cola de canjes. - Comisiones: planes con tramos, aceleradores, SPIF, reverso (clawback) y extractos. - TELÓN: escenas, animaciones, token de exhibición de solo lectura y personalización visual. - Engagement y Lead Score: catálogo de eventos, grupos de puntos, pesos y línea de tiempo. Casos de uso - Dar a cada vendedor una cartera privada y medir el resultado individual con precisión. - Crear una competencia sana con ranking en vivo en el TELÓN y premios de equipo. - Recompensar comportamientos (no solo ventas) con monedas canjeables por premios. - Pagar comisiones de forma transparente, con extractos auditables. - Priorizar los leads más calientes por su puntuación de engagement. Consejos, límites y buenas prácticas - Empieza por las metas y una o dos fuentes de puntos; añade complejidad poco a poco. - Mantén las reglas visibles para el equipo — la gamificación funciona cuando es transparente. - Usa el TELÓN como ritual diario (mañana/tarde) para mantener el engagement alto. - Recuerda que los puntos derivan de eventos reales: asegúrate de que el CRM, Pagos y Agenda se estén usando correctamente. Solución de problemas - No veo el módulo: puede que no esté habilitado para tu cuenta o tu rol de acceso — habla con un administrador. - El marcador está en cero: confirma que existen metas activas en el período y que los eventos (negocios, pagos) están ocurriendo en la plataforma. - Un vendedor no ve la cartera de otro: es lo esperado — el aislamiento por vendedor es intencional. Ver también - Gestión de ventas: cartera, aislamiento por vendedor y metas - Meta-sobre-meta y recompensas colectivas de equipo - Gamificación, leaderboard, recompensas y comisiones - TELÓN (wallboard) en tiempo real - Engagement y Lead Score: engagement y puntuación de leads
Gestión de ventas: cartera, aislamiento por vendedor y metas
Visión general La gestión de ventas le da a cada vendedor su propia cartera de clientes — sus contactos, conversaciones y negocios — con aislamiento por vendedor, es decir, un vendedor no ve la cartera del otro. Sobre esa base defines metas (cuotas) por período y distribuyes nuevos contactos de forma justa. El dueño de cada registro (el owner) acompaña al cliente de forma duradera: aunque la conversación se archive, el vínculo de propiedad permanece. La propiedad es la columna vertebral del módulo: es la que alimenta los rankings, las metas individuales y las comisiones. Por eso el módulo gestiona la cartera de punta a punta — asignación, transferencia (con carry-over del historial) y distribución automática (round-robin). Requisitos previos - El módulo Ventas y Gamificación habilitado en la cuenta. - Un rol de acceso con el permiso de gestión de ventas para configurar la cartera, las reglas de transferencia/distribución y las metas. - Vendedores registrados como agentes y asignados a los roles de ventas adecuados (por ejemplo, vendedor y gerente de ventas). - Para la privacidad total entre vendedores, la función de permisos granulares debe estar disponible en tu plan; sin ella, la visibilidad recae en las reglas de equipo/bandeja de entrada. Paso a paso 1. Define los roles de ventas. Crea/ajusta los roles (vendedor, gerente de ventas) y el alcance de visibilidad (cuenta, equipos o bandejas de entrada). 2. Asigna dueños. Cada contacto, conversación y negocio pasa a tener un vendedor responsable (owner). 3. Configura la distribución. Activa el round-robin para que los nuevos contactos se repartan automáticamente entre el equipo. 4. Transfiere cuando sea necesario. Mueve la cartera (o registros específicos) de un vendedor a otro; el historial va junto (carry-over). 5. Crea las metas. Define la cuota de cada vendedor por período (semana/mes/trimestre) y la métrica (por ejemplo, Ingresos ganados para negocios ganados o Ingresos liquidados para pedidos pagados). Los ingresos liquidados leen el ledger de pedidos, incluyen ventas externas registradas y no cuentan un cobro bruto por separado. 6. Sigue el cumplimiento. Usa el panel/informes para ver quién está cerca o por encima de la meta. Quién es vendedor, y quién es el vendedor de cada registro En Ventas → Cartera hay cuatro pestañas: - Mi cartera — los registros que son tuyos. - Todos los vendedores — la vista consolidada: cada vendedor con el tamaño de su cartera (contactos, conversaciones abiertas, negocios abiertos) y los ingresos atribuidos a él. Es donde el gerente compara al equipo en un solo lugar. - Vendedores — el registro de quién vende en esta cuenta. - Sin asignar — las ventas pagadas que no se acreditaron a nadie. El registro de vendedores no es un permiso: el permiso de gestión sigue significando "administra el módulo"; estar en el registro significa "es vendedor". Mientras el registro esté vacío, todos los agentes se siguen ofreciendo en los selectores y en la distribución — exactamente como antes. Para definir el vendedor de un registro: - Contacto — en el panel del contacto. - Conversación — en el panel lateral de Ventas, en Vendedor (cartera), junto a Atendiendo ahora. Son cosas distintas: el responsable cambia con cada traspaso; el vendedor es quien tiene la relación y recibe los puntos, la meta y la comisión. - Negocio — en el detalle del negocio, junto al responsable. - Varios contactos a la vez — con la acción masiva de la lista de contactos. Quién puede cambiarlo: un administrador, quien tenga gestión de ventas, o el propio dueño pasando su cliente. Un vendedor no se queda con el cliente de otro. Todo cambio queda registrado en el historial de transferencias de cartera. Atención al aislamiento. El aislamiento por vendedor (un vendedor no ve la cartera del otro) solo entra en vigor con permisos granulares disponibles y el modo de aislamiento configurado. Sin eso, la gestión es por administrador y la visibilidad sigue las reglas de equipo/bandeja. Configuración y opciones - Owner (dueño del registro): vínculo duradero en contactos, conversaciones y negocios. - Aislamiento por vendedor: cada vendedor ve solo su propia cartera; los gerentes tienen una visión ampliada según el rol. - Transferencia: manual (uno a uno o en lote) o automatizada por regla, con carry-over del historial. - Distribución (round-robin): reparte los nuevos contactos automáticamente. - Metas: por vendedor y por período, con la métrica que tenga sentido para el negocio. - Modo de aislamiento: ajusta cuán privada es la cartera según la madurez del equipo. Casos de uso - Equipo de ventas inbound: cada lead nuevo cae automáticamente al siguiente vendedor de la fila. - Reorganización de territorio: transferir la cartera de un vendedor que se fue a otro, sin perder el historial. - Operación con gerentes: el gerente sigue la cartera de todos; cada vendedor ve solo la suya. - Metas mensuales con seguimiento diario en el panel y en el TELÓN. Consejos, límites y buenas prácticas - Define el owner desde el inicio — los rankings, las metas y las comisiones dependen de él. - Prefiere la distribución automática para evitar disputas por leads. - Al transferir carteras, comunica al equipo para mantener la relación con el cliente. - Empieza con una métrica de meta clara (ej.: negocios ganados) antes de combinar varias. Solución de problemas - Un vendedor no ve un contacto que debería: confirma que es el owner y que el rol/alcance de acceso es correcto. - Los leads no se están distribuyendo: verifica que la distribución automática (round-robin) esté activa y que haya vendedores elegibles. - La meta no aparece para el vendedor: comprueba que haya una meta activa en el período vigente y que el vendedor esté en el alcance correcto. Ver también - Visión general de Ventas y Gamificación - Meta-sobre-meta y recompensas colectivas de equipo - Gamificación, leaderboard, recompensas y comisiones - TELÓN (wallboard) en tiempo real
Registro de vendedores: quién vende, quién recibe cartera
Visión general El registro de vendedores responde una pregunta que la plataforma no podía responder: ¿quién vende en esta cuenta? Hasta ahora, el dueño de un contacto, de una conversación o de un negocio era simplemente algún usuario de la cuenta — el selector de transferencia ofrecía todos los agentes, la distribución podía entregar un cliente a cualquiera, y quien dejaba el equipo comercial seguía apareciendo como si nada hubiera cambiado. Con el registro, el equipo comercial se vuelve explícito: quien está en él se ofrece en los selectores y recibe clientes de la distribución automática; quien sale deja de recibirlos sin perder nada de lo que ya es suyo. El registro no es un permiso. El permiso de gestión de ventas sigue significando "administra el módulo" (metas, recompensas, comisiones, reglas). Estar en el registro significa "es vendedor". Son independientes — es común que un gerente administre el módulo sin ser vendedor. Requisitos previos - El módulo Ventas y Gamificación habilitado en la cuenta. - El permiso de gestión de ventas (o administrador) para agregar, sacar y traer vendedores de vuelta. Ver la lista está abierto a cualquier participante del módulo. - Los vendedores deben ser miembros de esta cuenta (agentes). Un usuario de otra cuenta nunca puede ser registrado ni recibir cartera. Paso a paso 1. Abre Ventas → Cartera y ve a la pestaña Vendedores. 2. En Agregar vendedor, elige un agente y confirma. Solo aparecen agentes que aún no están en el registro. 3. Para sacar a alguien del equipo, usa Sacar del equipo y confirma. Deja de recibir clientes nuevos. 4. Para traerlo de vuelta, usa Traer de vuelta en su fila. 5. Usa los filtros de búsqueda y situación para revisar vendedores activos o quienes salieron. 6. En un registro inactivo sin cartera, objetivos, transferencias o historial financiero, usa Eliminar definitivamente y confirma. El usuario de la cuenta nunca se elimina. Configuración y opciones - Situación — Activo (recibe clientes nuevos) o Salió del equipo (ya no). - Ingresó el — la fecha en que se registró al vendedor, guardada automáticamente. - El registro es un conjunto: cada agente aparece una sola vez. Agregar de nuevo a un vendedor inactivo reactiva el registro existente en lugar de crear un duplicado. Casos de uso - Equipo comercial separado del de soporte. Solo los comerciales entran en el registro, así la distribución automática nunca manda un lead a quien hace soporte. - Vendedor de vacaciones o desvinculado. Sácalo del equipo: deja de recibir clientes nuevos, mientras su cartera, comisiones y metas quedan intactas para cerrar el período. - Cuenta que todavía no organizó el equipo. Deja el registro vacío: todo funciona como antes, con todos los agentes disponibles. Lo organizas cuando quieras. Consejos, límites y buenas prácticas - Mientras el registro esté vacío, los selectores y la distribución siguen ofreciendo todos los agentes. Es a propósito: completarlo es una decisión tuya, no una obligación. - Sacar a alguien no redistribuye su cartera. Usa Transferir cartera (en la misma página) para pasarle los clientes a otro vendedor — el historial va con ellos. - La salida se registra, no se borra. La persona sigue en el ranking histórico, en las comisiones ya provisionadas y en los ingresos ya atribuidos. - Un vendedor sacado del equipo que todavía tenga clientes sigue apareciendo en la pestaña Todos los vendedores, marcado como Fuera del equipo — para que su cartera nunca quede invisible. Solución de problemas - El agente no aparece en la lista para agregar: ya está en el registro (revisa la tabla debajo del selector) o no es miembro de esta cuenta. - "No se pudo guardar la lista de vendedores": tu perfil no tiene gestión de ventas, o el usuario elegido no es miembro de la cuenta. - La pestaña Vendedores no aparece: el módulo está apagado en la cuenta, o tu perfil no tiene gestión de ventas (las pestañas de gestión solo aparecen para quien puede usarlas). - La distribución dejó de asignar: con el registro completo, solo entrega a vendedores activos. Si una regla apunta a alguien que salió del equipo, ya no asigna — actualiza la regla o trae de vuelta a la persona. - Se rechazó la eliminación definitiva: el vendedor tiene cartera, objetivo, transferencia o historial financiero. Mantén el registro inactivo para que ese historial siga siendo auditable. Ver también - Gestión de ventas: cartera, aislamiento por vendedor y metas - Ventas sin vendedor: ingresos que no se acreditaron a nadie - Visión general de Ventas y Gamificación
Ventas sin vendedor: ingresos que no se acreditaron a nadie
Visión general Una venta pagada suma a los ingresos de la cuenta incluso cuando no se acredita a nadie. Cuando eso pasa, el dinero aparece en el total y desaparece de todo desglose por vendedor: nadie gana puntos, ninguna meta avanza y ninguna comisión se provisiona. La pantalla Ventas → Cartera → Sin asignar existe para que esa diferencia no quede escondida. Lista las ventas pagadas sin vendedor y te deja atribuir el responsable allí mismo. Por qué una venta queda sin vendedor El vendedor de un pedido se hereda en cascada cuando el pedido se registra: 1. el negocio vinculado al pedido, si lo hay; 2. si no, el contacto del pedido; 3. si no, la atribución externa — que viene apagada por defecto. Es decir: un pedido de e-commerce (Kiwify, Hotmart, Nuvemshop…) de un contacto que todavía no tiene vendedor, sin negocio en el CRM, queda sin dueño — y sigue así hasta que alguien lo atribuya. Requisitos previos - El módulo Ventas y Gamificación habilitado. - El libro de ingresos unificado habilitado (es el que consolida las ventas pagadas). - El permiso de gestión de ventas (o administrador) para atribuir. Paso a paso 1. Abre Ventas → Cartera y ve a la pestaña Sin asignar. 2. Revisa la lista: cliente, origen, fecha de pago e importe. 3. Haz clic en Atribuir vendedor en la fila y elige quién debe recibir el crédito. 4. Confirma. Los puntos, el avance de meta y la comisión pasan a contar para esa persona, y la fila sale de la lista. Configuración y opciones - La lista muestra por defecto solo las ventas sin vendedor — es la fila que hay que dejar en cero. - Atribuir una venta que ya tenía vendedor revierte el crédito anterior y acredita al nuevo; dejarlo en blanco devuelve la venta a la fila de no atribuidas. - La página de Ingresos también muestra el grupo Sin atribución en el desglose por vendedor, con el importe exacto que aún no se acreditó. Casos de uso - Venta de checkout externo sin CRM. El cliente compró por el enlace, sin conversación y sin negocio. Atribúyela al vendedor que trabajó el lead. - Cierre de mes. Antes de aprobar las comisiones, deja la fila en cero para que el estado de cada vendedor refleje la realidad. - Conciliación de ingresos. Si el total de ingresos no coincide con la suma por vendedor, la diferencia está aquí. Consejos, límites y buenas prácticas - Atribuye cuanto antes. Los puntos y las metas se calculan por período; atribuir después del cierre corrige la comisión pero no devuelve el efecto motivador del ranking a tiempo. - Mejor dale dueño al contacto. Si el cliente suele volver a comprar, define el vendedor en el contacto: las próximas ventas ya nacen atribuidas y la fila deja de crecer. - No atribuyas "solo para vaciar la lista". El crédito mueve dinero de comisión; atribuir a la persona equivocada es peor que dejarlo en blanco. Solución de problemas - La pestaña no aparece: falta el libro de ingresos unificado, o tu perfil no tiene gestión de ventas. - "Vendedor inválido": la persona elegida no es miembro de esta cuenta. - La lista está vacía pero los ingresos no cuadran: las ventas pueden estar atribuidas a alguien que salió del equipo — revisa la pestaña Todos los vendedores, donde aparece marcado como Fuera del equipo. - La venta vuelve a la lista después de atribuirla: el pedido se reprocesó por el webhook del gateway sin vendedor en el origen. Define el vendedor en el contacto para cortar el ciclo. Ver también - Registro de vendedores: quién vende, quién recibe cartera - Gestión de ventas: cartera, aislamiento por vendedor y metas - Libro de ingresos unificado
Meta-sobre-meta y recompensas colectivas de equipo
Visión general La meta-sobre-meta permite apilar objetivos en capas: además de la meta base, creas una meta super y una meta mega. Quien supera un nivel desbloquea el siguiente, con aceleradores de superación (recompensas crecientes para quien va más allá) y encadenamiento de metas (una meta que libera la siguiente). Esto mantiene al equipo motivado incluso después de alcanzar el objetivo inicial. En paralelo, las recompensas colectivas de equipo premian a todo el equipo cuando alcanza (o supera) una meta acordada. La liberación es idempotente por meta, nivel y período — es decir, el premio se concede una sola vez para cada combinación, sin riesgo de duplicados. Requisitos previos - El módulo Ventas y Gamificación habilitado. - El permiso de gestión de ventas para crear metas, niveles y recompensas. - Metas individuales y/o de equipo ya estructuradas (ver el artículo de gestión de ventas). - Recompensas configuradas (puntos, insignias, monedas o premios) para vincular a los niveles. Paso a paso 1. Crea la meta base del período (por vendedor o por equipo). 2. Añade los niveles super y mega sobre la base, definiendo el disparador de cada uno (por ejemplo, 110% y 130% de la base). 3. Configura los aceleradores de superación: define qué crece a medida que avanza el cumplimiento. 4. Encadena metas, si lo deseas: al completar una meta, la siguiente se libera automáticamente. 5. Define la recompensa colectiva: elige lo que gana el equipo cuando alcanza la meta acordada. 6. Sigue la liberación: cuando se alcanza el disparador, el premio colectivo se concede una sola vez (idempotente) para ese período/nivel. Configuración y opciones - Capas de meta: base, super y mega, cada una con su disparador. - Aceleradores de superación: recompensas que aumentan a medida que el vendedor supera la meta. - Encadenamiento (goal-chaining): completar una meta libera la siguiente. - Recompensa colectiva: premio concedido al equipo cuando el objetivo acordado se alcanza o supera. - Idempotencia: cada combinación (meta + nivel + período) genera como máximo una concesión. Casos de uso - Campaña de fin de mes con base, super y mega para estirar el resultado. - Bono de equipo cuando todos juntos alcanzan el número acordado (no solo los top performers). - Una secuencia de desafíos encadenados a lo largo de un trimestre. - Un acelerador para quien supera el 100% — cuanto más vende, más gana. Consejos, límites y buenas prácticas - Calibra los disparadores para que super y mega sean ambiciosos pero alcanzables. - Combina la recompensa individual (acelerador) con la colectiva para equilibrar competencia y colaboración. - Comunica claramente los niveles y premios — la transparencia multiplica el efecto. - Confía en la idempotencia: el premio colectivo no se concede por duplicado, incluso con reprocesamientos. Solución de problemas - El premio colectivo no se liberó: confirma que el equipo alcanzó el disparador en el período y que la recompensa colectiva está vinculada a ese nivel. - Un nivel super/mega no se desbloqueó: verifica que el disparador esté por encima del nivel anterior y dentro del período correcto. - El acelerador no se aplicó: comprueba que el vendedor realmente superó el umbral configurado. Ver también - Gestión de ventas: cartera, aislamiento por vendedor y metas - Gamificación, leaderboard, recompensas y comisiones - TELÓN (wallboard) en tiempo real - Visión general de Ventas y Gamificación
Gamificación, leaderboard, recompensas y comisiones
Visión general La gamificación da vida al desempeño del equipo. Los puntos se derivan de eventos reales del producto — negocio ganado en el CRM, pago confirmado, venta del catálogo, cita o conversión de follow-up — y alimentan un leaderboard en vivo con podio, niveles, ligas, concursos (individuales y de equipo), insignias/medallas (de Bronce a Diamante), certificaciones, reconocimiento público y el análisis de Pareto. Sobre esa capa, la plataforma trae una economía de recompensas (monedas canjeables por premios en un catálogo) y los módulos de comisión, con planes por tramos, aceleradores, SPIF, reverso (clawback) y extractos auditables. Las comisiones se calculan a partir de eventos reales — por defecto en el pago confirmado, con la opción de calcular en el negocio ganado. Requisitos previos - El módulo Ventas y Gamificación habilitado. - El permiso de gestión de ventas para configurar puntos, recompensas y comisiones. - Eventos reales fluyendo (CRM, Pagos, Catálogo, Agenda, Follow-ups) para generar puntos y calcular comisiones. - Un catálogo de premios y/o un plan de comisión definidos, según lo que vayas a usar. Paso a paso 1. Confirma las fuentes de puntos. Decide qué eventos puntúan y con qué peso. 2. Configura niveles y ligas. Define la progresión (niveles) y los grupos de competencia (ligas). 3. Crea concursos. Lanza desafíos por período, individuales o de equipo. 4. Activa insignias y reconocimiento. Elige los trofeos (Bronce→Diamante) y cómo celebrar los logros. 5. Arma la economía de monedas. Define cómo gana monedas el equipo y registra el catálogo de premios. 6. Gestiona los canjes. Aprueba y sigue la cola de canjes de los premios. 7. Crea el plan de comisión. Define tramos, aceleradores, SPIF y reglas de reverso. 8. Sigue los extractos. Verifica el cálculo (accrued → aprobado → pagado) y usa el simulador. Configuración y opciones - Leaderboard: ranking en vivo con podio y actualización en tiempo real. - Puntos: derivados de eventos reales, con pesos configurables. - Niveles y ligas: progresión individual y grupos de competencia. - Concursos: desafíos por período, individuales y de equipo. - Insignias/medallas y reconocimiento: trofeos de Bronce a Diamante, certificaciones y broadcast. - Monedas y catálogo: ganancia de monedas + premios canjeables + cola de canjes. - Comisiones: planes por tramo, aceleradores, SPIF, clawback, extractos y simulador (cálculo en el pago confirmado por defecto; negocio ganado como opción). - Paquetes por nicho (Program Packs): plantillas listas para empezar rápido (SaaS, retail, inmobiliaria, infoproducto, agencia y B2B). Casos de uso - Un ranking diario en el TELÓN con podio de los tres primeros. - Un concurso relámpago (SPIF) de fin de semana para un producto específico. - Una tienda de premios donde el equipo cambia monedas por beneficios. - Comisión transparente, con extracto que el vendedor consulta en cualquier momento. Consejos, límites y buenas prácticas - Empieza con pocas fuentes de puntos y un catálogo reducido; crece con el tiempo. - Usa los paquetes por nicho para acelerar la configuración inicial. - Ten en cuenta que acreditar una comisión (calcularla) es distinto de rankear: define cada regla con claridad. - Revisa los canjes con frecuencia para mantener la confianza en la economía de monedas. Solución de problemas - Los puntos no aparecen: confirma que los eventos reales están ocurriendo y que la fuente de puntos está activa. - El saldo de monedas parece incorrecto: recuerda que el saldo es la suma del historial de movimientos (créditos y canjes). - La comisión no se calculó: verifica la regla de disparador (pago confirmado o negocio ganado) y el período del plan. - Un canje quedó atascado: revisa la cola de canjes y las aprobaciones pendientes. Ver también - TELÓN (wallboard) en tiempo real - Meta-sobre-meta y recompensas colectivas de equipo - Gestión de ventas: cartera, aislamiento por vendedor y metas - Visión general de Ventas y Gamificación
TELÓN (wallboard) en tiempo real
Visión general El TELÓN (wallboard) es la vitrina en vivo de la operación de ventas. En una pantalla grande — un televisor en la oficina o un navegador en pantalla completa — muestra el ranking en tiempo real con reordenación animada, podio con movimiento, termómetro de equipo (progreso hacia la meta) y celebraciones cuando alguien alcanza la meta base, super o mega. Es la herramienta perfecta para crear energía y foco en el equipo. El TELÓN admite múltiples escenas (alternando, por ejemplo, entre ranking individual, ranking de equipo y concursos), puede abrirse con un token de exhibición de solo lectura (sin exponer la cuenta) y acepta personalización visual (whitelabel) para combinar con tu marca. Requisitos previos - El módulo Ventas y Gamificación habilitado, con la gamificación configurada (puntos/leaderboard). - El permiso de gestión de ventas para generar el enlace/token de exhibición y ajustar las escenas. - Metas activas en el período para alimentar el termómetro y las celebraciones. - Una pantalla para exhibición (televisor, monitor o navegador en pantalla completa) con acceso a internet. Paso a paso 1. Abre la configuración del TELÓN en el módulo de Ventas y Gamificación. 2. Elige las escenas que deseas exhibir (ranking individual, equipo, concursos) y el orden de rotación. 3. Ajusta la apariencia (colores, logo e identidad visual) según tu marca. 4. Genera el token de exhibición de solo lectura para abrir el TELÓN en pantallas públicas con seguridad. 5. Abre en pantalla completa en el televisor/monitor de la oficina usando el enlace de exhibición. 6. Sigue en vivo: el ranking se reordena, el podio se anima y las metas alcanzadas se celebran automáticamente. Configuración y opciones - Escenas (multi-scene): alterna entre diferentes paneles en rotación. - Reordenación animada: el ranking se reorganiza en tiempo real con cada nueva puntuación. - Podio con movimiento: destaque animado para los primeros lugares. - Termómetro de equipo: barra de progreso colectiva hacia la meta del período. - Celebraciones: efectos visuales al alcanzar las metas base, super y mega. - Token de exhibición (solo lectura): enlace seguro para pantallas públicas, sin iniciar sesión en la cuenta. - Personalización visual (whitelabel): colores, logo y tema propios. Casos de uso - Un televisor en la sala de ventas mostrando el ranking del día todo el tiempo. - Una escena dedicada a un concurso relámpago durante una campaña. - Una celebración inmediata cuando un vendedor cierra un negocio (efecto en el telón). - Un telón en eventos/kickoffs para reconocer al equipo públicamente. Consejos, límites y buenas prácticas - Usa el token de solo lectura para pantallas públicas — evita dejar una sesión con sesión iniciada expuesta. - Rota las escenas para mantener el telón interesante a lo largo del día. - Combina el TELÓN con rituales (apertura/cierre del día) para reforzar el hábito. - En pantallas de larga exposición, prefiere el modo pantalla completa y mantén el navegador actualizado. Solución de problemas - El telón no se actualiza en tiempo real: verifica la conexión a internet y recarga la página de exhibición. - El enlace de exhibición no abre: confirma que el token de exhibición fue generado y sigue válido. - Las celebraciones no aparecen: comprueba que haya metas activas en el período y que la gamificación esté configurada. - La marca no aparece personalizada: revisa las opciones de personalización visual del TELÓN. Ver también - Gamificación, leaderboard, recompensas y comisiones - Meta-sobre-meta y recompensas colectivas de equipo - Gestión de ventas: cartera, aislamiento por vendedor y metas - Visión general de Ventas y Gamificación
Engagement y Lead Score: línea de tiempo de engagement y puntuación configurable
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 - Gestión de ventas: cartera, aislamiento por vendedor y metas - Gamificación, leaderboard, recompensas y comisiones - TELÓN (wallboard) en tiempo real
Paneles e informes de ventas: lectura de desempeño, cumplimiento y payout
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 1. 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. 2. Sigue el ranking. Mira tu posición en el leaderboard (por métrica, período y alcance) y en el telón en vivo. 3. Gestor: abre los Informes de ventas. Lee las tres secciones — cumplimiento, historial de payout e historial de leaderboard. 4. Aplica filtros. Acota por período, vendedor, métrica y alcance para responder una pregunta concreta. 5. 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. Ver también - Visión general de Ventas y Gamificación - Gestión de ventas: cartera, aislamiento por vendedor y metas - Gamificación, leaderboard, recompensas y comisiones - TELÓN (wallboard) en tiempo real
Ledger unificado de ingresos: conteo único de ventas por origen, gateway, vendedor y afiliado
Visión general El ledger unificado de ingresos es el registro nativo, en R$, de toda venta pagada — sin importar el origen. Un cobro pagado en la conversación, un pedido de catálogo de WhatsApp, una venta de Hotmart, un pedido manual o un pedido vía API convergen a un único pedido canónico (el registro de pedidos del CRM). En el momento en que ese pedido se paga, Conversa Labs acredita al vendedor (dueño del pedido) una sola vez: puntos de gamificación, comisión y los ingresos que aparecen en el informe. Antes de esto, cada camino de dinero acreditaba distinto (o no acreditaba): una venta de catálogo o de Hotmart podía no dar puntos ni comisión a nadie, mientras que un cobro acreditaba a su autor. El ledger unificado lo resuelve con un único eje de ingresos y conteo exactamente una vez — la misma venta nunca se cuenta dos veces. Requisitos previos - Módulo Ventas y Gamificación habilitado en la cuenta. - Recurso unified_revenue_ledger activado en la cuenta (es dark-ship, por defecto apagado — el operador lo activa). Con él apagado, el comportamiento es idéntico al anterior. - Registro de pedidos del CRM (orders_registry) activado para que cobros y pedidos de comercio también converjan al pedido único — es lo que suprime la acreditación heredada y garantiza un conteo único. - Permiso de gestión de ventas (sales_manage) — o administrador — para leer el ledger y exportar. - Ventas pagadas reales fluyendo (cobros, catálogo, Hotmart, pedidos manuales) para que haya algo que contar. Paso a paso 1. Activa el recurso unified_revenue_ledger (y orders_registry) en la cuenta. 2. Asegura ventas fluyendo por cualquier origen — la convergencia es automática por los alimentadores de pedido. 3. Abre la vista de Ingresos en el panel/telón de Ventas. 4. Elige el período (por defecto, los últimos 30 días). 5. Lee los agrupamientos — total por moneda, por origen, por gateway, por vendedor y por afiliado. 6. Exporta a CSV para conciliar los ingresos fuera de la plataforma. Configuración y opciones Qué agrupa el ledger Sobre los pedidos pagados del período (por paid_at), los ingresos se suman y se agrupan: | Agrupamiento | Qué trae | |---|---| | Total por moneda | Ingresos totales por moneda — nunca suma monedas distintas | | Por origen | Ingresos por source del pedido: manual, webhook, api, payments, commerce | | Por gateway | Ingresos por gateway de dinero (asaas, mercado_pago, hotmart, nativo, catálogo…) | | Por vendedor | Ingresos por dueño del pedido (el vendedor acreditado) | | Por afiliado | Ingresos por afiliado atribuido (atribución dual) | Conteo exactamente una vez (sin duplicidad) La acreditación ocurre en el eje del pedido cuando existe un pedido, y en el camino heredado solo cuando no se produce ningún pedido: | unified_revenue_ledger | orders_registry | Quién acredita | Resultado | |---|---|---|---| | Apagado | cualquiera | Camino heredado (cobro/comercio) | idéntico al anterior | | Encendido | Encendido | order.paid (el pedido) — heredado suprimido | una vez, en el pedido | | Encendido | Apagado | Heredado (no se produce pedido) | una vez, en el cobro/comercio | Atribución del vendedor (fallback) El dueño del pedido se resuelve en cascada: negocio → contacto → responsable → creador. Un cobro sin negocio aún se atribuye al usuario que lo creó (campo de creador del cobro), de modo que ninguna venta pagada queda "sin dueño". Atribución de ventas externas al vendedor Las ventas externas (catálogo, Hotmart, Kiwify y otros gateways) llegan desde el gateway y, muchas veces, a un contacto comprador que no está en la cartera de nadie. Sin una regla, esa venta pagada quedaría "sin vendedor". La configuración por cuenta external_attribution_mode decide cómo se resuelve el vendedor automáticamente en ese caso: | Modo | Qué hace | |---|---| | off (por defecto) | Ningún crédito automático — la venta externa queda sin vendedor hasta una atribución manual | | last_conversation | Acredita al agente que atendió al comprador por última vez (la última conversación del contacto) | | distribution | Acredita según las reglas de distribución activas (las mismas de la distribución de leads) | Cuando el modo resuelve un vendedor, la cartera del comprador se reivindica de forma durable para ese vendedor — así, las próximas ventas del mismo contacto ya entran con dueño. El valor por defecto es off: ningún crédito automático hasta que elijas explícitamente last_conversation o distribution. Reatribución manual del vendedor. Un gestor (permiso de gestión de ventas) puede, desde el pedido, vincular una venta externa a un vendedor o mover el crédito entre agentes. El cambio revierte los puntos y la comisión del dueño anterior y acredita al nuevo dueño; el crédito del afiliado no se ve afectado. Dejar el vendedor en blanco desvincula el pedido. Todo cambio queda auditado (evento order_reattributed), preservando el registro de quién fue acreditado y por qué. Reembolso (clawback) Cuando un pedido se reembolsa, el crédito se revierte en el origen del pedido — para el vendedor y para el afiliado —, manteniendo el ledger fiel al dinero efectivamente recibido. Exportación CSV Una fila por pedido pagado, con las columnas: order_id, paid_at, source, gateway, owner_id, affiliate_id, amount, currency. Los valores están en unidades mayores (ej.: 4970.50 = R$ 4.970,50). Permisos y visibilidad - Leer el ledger y exportar exigen el permiso de gestión de ventas. - La lectura respeta el aislamiento por vendedor: bajo cartera/privacidad, un gestor ve solo su cascada; un vendedor, solo su propia cartera. Casos de uso - El gestor lee los ingresos por vendedor para reconocer quién más vendió en el período. - Finanzas exporta el CSV para conciliar los ingresos pagados con el extracto de comisiones. - La dirección compara los ingresos por origen (Hotmart × catálogo × cobro) y por gateway. - Los ingresos por afiliado alimentan el seguimiento del programa de afiliados (atribución dual). Consejos, límites y buenas prácticas - El dinero está en unidades mayores (decimal), la misma convención de Pagos/Catálogo — nunca dividas por 100. - El ledger nunca suma monedas distintas: cada moneda es una fila. - Activar el recurso acredita las ventas de aquí en adelante — no hay reprocesamiento retroactivo automático. Para reprocesar el historial de Hotmart, usa el backfill del operador. - Activa ambos recursos (unified_revenue_ledger + orders_registry): esa combinación es la que suprime el camino heredado y evita el conteo doble. Solución de problemas - Ledger vacío: no hay pedidos pagados en el período, o el recurso está apagado. Confirma la activación y la existencia de ventas pagadas. - Números duplicados: el orders_registry probablemente está apagado, así que el camino heredado y el del pedido acreditan juntos. Activa el registro de pedidos. - El vendedor aparece como nulo: el pedido no tuvo dueño resuelto (sin negocio, contacto, responsable ni creador). Verifica la atribución en el origen. - Venta externa sin vendedor o acreditada al vendedor equivocado: si external_attribution_mode está en off, las ventas externas quedan sin dueño — elige last_conversation o distribution, o haz la reatribución manual (gestión de ventas) desde el pedido. - Reembolso no reflejado: el evento de reembolso del pedido no se disparó. Confirma el flujo de reembolso en el gateway/Pagos. - Exportación bloqueada: falta el permiso de gestión de ventas. Pídelo a un administrador. Ver también - Programa de afiliados: atribución dual, comisión y portal - Paneles e informes de ventas - Visión general de Ventas y Gamificación
Programa de afiliados: atribución dual, códigos de referido, comisión y portal
Visión general El programa de afiliados convierte a quien refiere ventas en una entidad nativa con comisión propia. Un afiliado puede ser cuatro cosas, y el vínculo es de identidad (quién es el socio), nunca de pago — el receptor siempre es el registro del afiliado: | El afiliado es | Cuándo usarlo | |---|---| | Un agente | Alguien del equipo que además refiere ventas de otra cartera | | Un contacto | Un cliente que se volvió socio y ahora refiere a otros | | Una empresa | Una agencia, reventa o clínica socia — sus contactos pueden heredar el vínculo | | Un socio externo | Alguien que la cuenta no conoce: solo correo/código (p. ej. un afiliado de Hotmart) | Cada afiliado recibe un código de referido único (público, hecho para compartir) y un token de informe aparte (privado, rotable). Lo central es la atribución dual: un mismo pedido pagado acredita al vendedor (dueño) en el extracto del usuario y al afiliado — en el mismo ledger de comisión, sin colisión. Así el vendedor sigue recibiendo sus puntos y comisión, y el afiliado recibe la comisión de referido, sobre la misma venta, sin doble conteo. Requisitos previos - Módulo Ventas y Gamificación habilitado en la cuenta. - Recurso affiliate_program activado en la cuenta (dark-ship, por defecto apagado). - Recurso unified_revenue_ledger activado — la comisión del afiliado se acumula en el momento en que el pedido se paga (el mismo eje del ledger unificado). Sin él, no hay acumulación de comisión de afiliado. - Permiso de gestión de ventas (sales_manage) — o administrador — para gestionar afiliados. Paso a paso 1. Activa affiliate_program (y unified_revenue_ledger) en la cuenta. 2. Crea un afiliado: en "Este afiliado es" elige si es un agente, un contacto, una empresa o un socio externo; luego define la comisión (porcentaje, importe fijo por venta o plan). 3. Comparte el código/enlace de referido con el afiliado. 4. Atribuye el referido por cualquiera de estas vías: marca "Referido por" en el contacto, usa la acción de automatización "Definir afiliado del contacto", envía affiliate_id en el pedido, activa la herencia por empresa, o deja que el reconciliador case el split de la venta. 5. La venta pagada acredita al vendedor y al afiliado automáticamente. 6. El afiliado sigue su desempeño por el portal (por token); el gestor lee el informe en el panel. Configuración y opciones Campos del afiliado | Campo | Qué es | |---|---| | name | Nombre del afiliado (obligatorio) | | user_id / contact_id / organization_id | Quién es el afiliado — un agente, un contacto o una empresa. Son mutuamente excluyentes: llenar más de uno se rechaza | | inherit_to_org_contacts | Solo para empresa: al activarlo, los contactos de esa empresa heredan el afiliado en los pedidos nuevos | | email / external_ref | Correo y/o código externo (ucode de Hotmart). Únicos por cuenta — por ahí identifica el reconciliador al socio | | referral_code | Código de referido — autogenerado, único por cuenta, público, hecho para compartir | | portal_token | Credencial privada del informe del afiliado. Separada del código y rotable | | commission_percent | Comisión (%) — porcentaje de comisión (0–100); vacío cuando un plan lo define | | commission_amount | Comisión fija (R$) — importe fijo pagado por venta, en lugar del porcentaje. Opcional: déjalo vacío para usar el porcentaje | | plan_id | Plan de comisión que sustituye al porcentaje y al importe fijo | | status | active, paused o archived — solo activo acumula comisión | | metadata | Datos libres (ej.: la afiliación de Hotmart preservada) | Formato del importe: los campos de comisión aceptan coma o punto como separador decimal — 25,00 y 25.00 son lo mismo, y el separador de miles es opcional (1.250,50). Un valor fuera de rango (un porcentaje mayor que 100, un importe negativo) se rechaza al instante, con el motivo junto al campo. Cómo se atribuye una venta al afiliado En cascada, de lo más explícito a lo más genérico. Gana el primer escalón que responda, y un afiliado ya grabado en el pedido nunca se sobrescribe: 1. affiliate_id enviado en el pedido — lo aceptan la API del CRM, el ingest público y las automatizaciones. El id siempre se verifica contra los afiliados activos de esta cuenta: un id de otra cuenta se descarta. 2. "Referido por" en el contacto — el referido duradero de la persona. 3. Afiliado de la empresa principal del contacto — solo cuando ese afiliado activó inherit_to_org_contacts. Vale únicamente para la empresa principal y solo de ahí en adelante: activar la opción no reacredita pedidos anteriores. 4. Split externo reconciliado — casa el ucode/correo del split (Hotmart/Kiwify) con un afiliado existente, incluso por el correo del contacto o la empresa vinculada. 5. Sin coincidencia → el split entra en la cola de reconciliación en vez de desaparecer. Splits sin afiliado registrado Cuando la pasarela informa una comisión para alguien que la cuenta no tiene registrado, ese split se registra en una cola visible — con nombre, correo/ucode, el importe informado y el pedido de origen. Antes ese caso simplemente desaparecía dentro de la metadata: el único síntoma era una comisión que nunca aparecía. Abre "Splits sin registro" en la pantalla de Afiliados y decide: Registrar (abre el formulario ya rellenado con los datos del split) o Descartar. La cola nunca crea un afiliado por su cuenta — pagar a alguien a partir de un nombre no verificado llegado en un webhook es justo el riesgo que esta confirmación evita. Atribución dual sin colisión El ledger de comisión distingue el tipo de receptor (vendedor vs. afiliado). Un pedido pagado escribe dos filas — la del vendedor y la del afiliado — sin mezclarse. El extracto de un vendedor nunca suma las filas del afiliado. Comisión del afiliado La comisión se resuelve por venta, en este orden de precedencia — del más preciso al más genérico: 1. El importe reportado por la fuente — cuando la venta vino de Hotmart o Kiwify, la propia plataforma informa cuánto le pagó realmente a ese afiliado. Ese valor es autoritativo y entra en el ledger tal cual, para que el extracto nunca difiera de lo que el afiliado realmente recibió. 2. El plan de comisión — cuando el afiliado tiene uno. 3. Comisión fija (R$) — el importe fijo definido en el afiliado. 4. Comisión (%) — el porcentaje sobre el importe pagado del pedido. Por qué la fuente va primero: en un programa de afiliados externo la plataforma ya calculó y pagó el split, así que aplicar nuestro porcentaje encima produciría un número que no coincide con la realidad. Un afiliado externo recibe comisión y portal, pero no gana puntos de gamificación (los puntos exigen un usuario). Extracto del afiliado El afiliado tiene extracto propio, con el mismo ciclo que el del vendedor: acumulado → aprobado → pagado. Se cierra por período y por moneda — un extracto es un documento a pagar y se paga en una sola moneda, así que los movimientos en BRL y en USD generan extractos separados en lugar de un total que no existe. El extracto de un afiliado y el de un vendedor son registros independientes, aun cuando sus números de identificación coincidan. En la lista de extractos, el filtro de tipo de receptor separa ambos ledgers. Portal del afiliado Página pública y de solo lectura, abierta con el token de informe — sin sesión y sin account_id. Muestra solo su propio desempeño: pedidos atribuidos (paginados, con filtro de período), ingresos y comisión agrupados por moneda, y los extractos cerrados — sin PII de contactos. Un token inválido, rotado o una cuenta con el recurso apagado devuelven 404. El token no es el código de referido. El código es público — va en enlaces y materiales — y sigue válido para siempre; el token es la credencial privada del informe financiero. Usa Rotar en el registro del afiliado para invalidar de inmediato todo enlace de informe ya compartido: ningún referido deja de funcionar, porque el código no cambia. Los afiliados creados antes de esta versión empiezan con el token igual a su código de referido público — así ningún enlace ya entregado se rompió en la migración. Mientras eso sea cierto, cualquiera que conozca el código puede abrir el informe, y el registro muestra el aviso "este enlace sigue siendo el código público". Rota el token de esos afiliados para emitir un enlace realmente privado. Archivar, restaurar y eliminar definitivamente La lista predeterminada muestra afiliados actuales; usa el filtro de estado para revisar socios activos, pausados o archivados. Archivar detiene nuevas atribuciones y comisiones, pero conserva las referencias, pedidos y estados existentes; Restaurar vuelve a activar al socio. Eliminar definitivamente solo aparece para un afiliado archivado y solo funciona cuando no hay historial de referencias, pedidos, conciliación o financiero; la confirmación es explícita y no se puede deshacer. Casos de uso - Materializar un afiliado de Hotmart a partir del split preservado en la venta (reconciliación por ucode/correo). - Registrar un agente interno como afiliado que refiere ventas de otra cartera. - Compartir un enlace de referido para captar referidos rastreables. - El afiliado abre el portal y sigue su comisión acumulada casi en tiempo real. Consejos, límites y buenas prácticas - Un afiliado externo no gana puntos de gamificación — solo comisión + portal. - Solo los afiliados activos acumulan; un afiliado pausado/archivado no acumula nada. - Pagar al afiliado (Pix/transferencia) está fuera del alcance v1 — el módulo hace acumulación + informe + portal. - El referral_code es público — compártelo sin problema. Lo que abre el informe financiero es el token de informe, privado y rotable en cualquier momento. - La herencia por empresa es opt-in por afiliado y solo vale hacia adelante — activarla no reacredita nada del pasado. - Al fusionar contactos, el referido del contacto absorbido lo adopta el principal cuando este aún no tiene uno; un contacto que ya tenía referido conserva el suyo. - Un reembolso también revierte la comisión del afiliado, en el origen del pedido. Solución de problemas - Afiliado no acreditado: el unified_revenue_ledger puede estar apagado, el pedido puede no tener afiliado atribuido, o el afiliado no está activo. Verifica los tres. - El portal devuelve 404: token erróneo/antiguo, o el recurso affiliate_program está apagado en la cuenta. - El afiliado de Hotmart no casó: el split entró en "Splits sin registro". Abre la cola y usa Registrar — el formulario llega ya rellenado con el correo/ucode exactos que envió la pasarela. - La comisión aparece como "sin moneda": son movimientos anteriores a la separación por moneda. Su moneda real es desconocida y no se inventa; los movimientos nuevos llevan la moneda del pedido. - Se rechazó la eliminación definitiva: todavía existe historial de referencias, pedidos, conciliación o financiero. Mantén al afiliado archivado; conservar ese historial es intencional. Ver también - Ledger unificado de ingresos: conteo único de ventas - Paneles e informes de ventas - Visión general de Ventas y Gamificación