Vendas & Gamificação
Por Conversa Labs
Por Conversa Labs
Gestão de vendas, carteira, metas, meta-sobre-meta, gamificação, leaderboard, recompensas, comissões, TELÃO e lead score.
Visão geral de Vendas e Gamificação
Visão geral O módulo Vendas & Gamificação da Conversa Labs transforma a sua operação de atendimento em uma máquina de vendas mensurável e motivada. Ele reúne, em um só lugar, a gestão de vendas (carteira de clientes por vendedor, metas e distribuição), a gamificação (leaderboard, pontos, níveis, ligas, badges e troféus), a economia de recompensas (moedas e catálogo de prêmios), as comissões e um TELÃO (wallboard) em tempo real para exibir o ranking ao vivo. O grande diferencial: os números vêm dos eventos reais do produto. Quando um negócio é ganho no CRM, um pagamento é confirmado, uma venda do catálogo acontece, um agendamento é feito ou um follow-up converte, o módulo registra pontos automaticamente — sem digitação manual de planilha. A plataforma também inclui o Engagement & Lead Score, que mede o engajamento de cada contato e calcula uma pontuação de lead configurável. Pré-requisitos - Uma conta Conversa Labs ativa com o módulo Vendas & Gamificação habilitado (recurso opcional, ativado por um administrador/operador). - Para os recursos de engajamento e pontuação de leads, o módulo Engagement & Lead Score também precisa estar habilitado. - Um perfil de acesso com a permissão de gestão de vendas para configurar metas, recompensas e comissões. Vendedores normalmente recebem um perfil com acesso à sua própria carteira e ranking. - Eventos reais fluindo na plataforma (negócios no CRM, pagamentos, agendamentos, etc.) para que o placar tenha o que pontuar. Passo a passo 1. Peça a um administrador para habilitar o módulo na sua conta. 2. Defina os perfis de acesso de vendas (por exemplo, vendedor e gerente de vendas) e atribua-os à equipe. 3. Organize a carteira de clientes: cada vendedor passa a ter seus contatos, conversas e negócios. 4. Crie as primeiras metas (e, se quiser, os níveis de meta-sobre-meta) por período. 5. Ative a gamificação: confirme as fontes de pontos, badges e o leaderboard. 6. Monte a economia de recompensas (moedas e catálogo) e/ou os planos de comissão. 7. Abra o TELÃO em uma TV do escritório ou compartilhe o link de exibição. 8. Acompanhe os Relatórios para medir atingimento, payout e evolução. Configurações & opções - Gestão de vendas: carteira, isolamento por vendedor, transferência, distribuição e metas. - Gamificação: leaderboard, pontos, níveis, ligas, concursos, badges e reconhecimento. - Recompensas: moedas, catálogo de prêmios e fila de resgates. - Comissões: planos com faixas, aceleradores, SPIF, estorno (clawback) e extratos. - TELÃO: cenas, animações, token de exibição somente leitura e personalização visual. - Engagement & Lead Score: catálogo de eventos, grupos de pontos, pesos e linha do tempo. Casos de uso - Dar a cada vendedor uma carteira privada e medir o resultado individual com precisão. - Criar uma competição saudável com ranking ao vivo no TELÃO e premiações de equipe. - Recompensar comportamentos (não só vendas) com moedas trocáveis por prêmios. - Pagar comissões de forma transparente, com extratos auditáveis. - Priorizar os leads mais quentes pela pontuação de engajamento. Dicas, limites e boas práticas - Comece pelas metas e por uma ou duas fontes de pontos; adicione complexidade aos poucos. - Mantenha as regras visíveis para a equipe — gamificação funciona quando é transparente. - Use o TELÃO como ritual diário (manhã/tarde) para manter o engajamento alto. - Lembre-se de que os pontos derivam de eventos reais: garanta que CRM, Pagamentos e Agenda estejam sendo usados corretamente. Solução de problemas - Não vejo o módulo: ele pode não estar habilitado para a sua conta ou para o seu perfil de acesso — fale com um administrador. - O placar está zerado: confirme que existem metas ativas no período e que os eventos (negócios, pagamentos) estão acontecendo na plataforma. - Um vendedor não enxerga a carteira de outro: isso é esperado — o isolamento por vendedor é proposital. Veja também - Gestão de vendas: carteira, isolamento por vendedor e metas - Meta-sobre-meta e recompensas coletivas de equipe - Gamificação, leaderboard, recompensas e comissões - TELÃO (wallboard) em tempo real - Engagement & Lead Score: engajamento e pontuação de leads
Gestão de vendas: carteira, isolamento por vendedor e metas
Visão geral A gestão de vendas dá a cada vendedor uma carteira de clientes própria — seus contatos, conversas e negócios — com isolamento por vendedor, ou seja, um vendedor não enxerga a carteira do outro. Sobre essa base você define metas (quotas) por período e distribui novos contatos de forma justa. O dono de cada registro (o owner) acompanha o cliente de forma durável: mesmo que a conversa seja arquivada, o vínculo de propriedade permanece. A propriedade é a coluna vertebral do módulo: é ela que alimenta os rankings, as metas individuais e as comissões. Por isso o módulo cuida da carteira de ponta a ponta — atribuição, transferência (com carry-over do histórico) e distribuição automática (round-robin). Pré-requisitos - Módulo Vendas & Gamificação habilitado na conta. - Um perfil de acesso com a permissão de gestão de vendas para configurar a carteira, as regras de transferência/distribuição e as metas. - Vendedores cadastrados como agentes e atribuídos aos perfis de vendas adequados (por exemplo, vendedor e gerente de vendas). - Para a privacidade total entre vendedores, o recurso de permissões granulares precisa estar disponível no seu plano; sem ele, a visibilidade recai sobre as regras de equipe/caixa de entrada. Passo a passo 1. Defina os perfis de vendas. Crie/ajuste os perfis (vendedor, gerente de vendas) e o escopo de visibilidade (conta, equipes ou caixas de entrada). 2. Atribua donos. Cada contato, conversa e negócio passa a ter um vendedor responsável (owner). 3. Configure a distribuição. Ative o round-robin para que novos contatos sejam repartidos automaticamente entre a equipe. 4. Transfira quando necessário. Mova a carteira (ou registros específicos) de um vendedor para outro; o histórico vai junto (carry-over). 5. Crie as metas. Defina a quota de cada vendedor por período (semana/mês/trimestre) e a métrica (por exemplo, Receita ganha para negócios vencidos ou Receita liquidada para pedidos pagos). Receita liquidada lê o ledger de pedidos, portanto inclui vendas externas que já foram registradas e não conta uma cobrança bruta separadamente. 6. Acompanhe o atingimento. Use o painel/relatórios para ver quem está perto ou acima da meta. Quem é vendedor, e quem é o vendedor de cada registro Em Vendas → Carteira há quatro abas: - Minha carteira — os registros que são seus. - Todos os vendedores — a visão consolidada: cada vendedor com o tamanho da carteira (contatos, conversas em aberto, negócios em aberto) e a receita atribuída a ele. É onde o gestor compara o time em um lugar só. - Vendedores — o cadastro de quem vende nesta conta. - Não atribuídos — as vendas pagas que não foram creditadas a ninguém. O cadastro de vendedores não é permissão: a permissão de gestão continua sendo "administra o módulo"; estar no cadastro significa "é vendedor". Enquanto o cadastro estiver vazio, todos os agentes continuam sendo oferecidos nos seletores e na distribuição — exatamente como antes. Para definir o vendedor de um registro: - Contato — no painel do contato. - Conversa — no painel lateral de Vendas, em Vendedor (carteira), que fica ao lado de Atendente agora. São coisas diferentes: o atendente muda a cada passagem de bastão; o vendedor é quem detém a relação e recebe pontos, meta e comissão. - Negócio — no detalhe do negócio, ao lado do responsável pelo atendimento. - Vários contatos de uma vez — pela ação em massa da lista de contatos. Quem pode trocar: administrador, quem tem gestão de vendas, ou o próprio dono passando o cliente adiante. Um vendedor não pega para si o cliente de outro. Toda troca fica registrada no histórico de transferências de carteira. Atenção ao isolamento. O isolamento por vendedor (um vendedor não enxerga a carteira do outro) só entra em vigor com permissões granulares disponíveis e o modo de isolamento configurado. Sem isso, a gestão é por administrador e a visibilidade segue as regras de equipe/caixa de entrada. Configurações & opções - Owner (dono do registro): vínculo durável em contatos, conversas e negócios. - Isolamento por vendedor: cada vendedor vê apenas a própria carteira; gerentes têm visão ampliada conforme o perfil. - Transferência: manual (um a um ou em lote) ou automatizada por regra, com carry-over do histórico. - Distribuição (round-robin): reparte novos contatos automaticamente. - Metas: por vendedor e por período, com a métrica que faz sentido para o negócio. - Modo de isolamento: ajuste o quanto a carteira é privada conforme a maturidade da equipe. Casos de uso - Equipe de vendas inbound: cada lead novo cai automaticamente para o próximo vendedor da fila. - Reorganização de território: transferir a carteira de um vendedor que saiu para outro, sem perder histórico. - Operação com gerentes: gerente acompanha a carteira de todos; cada vendedor vê só a sua. - Metas mensais com acompanhamento diário no painel e no TELÃO. Dicas, limites e boas práticas - Defina o owner desde o início — rankings, metas e comissões dependem dele. - Prefira a distribuição automática para evitar disputa por leads. - Ao transferir carteiras, comunique a equipe para manter a relação com o cliente. - Comece com uma métrica de meta clara (ex.: negócios ganhos) antes de combinar várias. Solução de problemas - Um vendedor não vê um contato que deveria: confirme se ele é o owner e se o perfil/escopo de acesso está correto. - Os leads não estão sendo distribuídos: verifique se a distribuição automática (round-robin) está ativa e se há vendedores elegíveis. - A meta não aparece para o vendedor: confira se há meta ativa no período vigente e se o vendedor está no escopo correto. Veja também - Visão geral de Vendas e Gamificação - Meta-sobre-meta e recompensas coletivas de equipe - Gamificação, leaderboard, recompensas e comissões - TELÃO (wallboard) em tempo real
Cadastro de vendedores: quem vende, quem recebe carteira
Visão geral O cadastro de vendedores responde a uma pergunta que a plataforma não conseguia responder: quem vende nesta conta? Antes, o dono de um contato, de uma conversa ou de um negócio era simplesmente um usuário qualquer da conta — o seletor de transferência oferecia todos os agentes, a distribuição podia entregar um cliente a qualquer um, e quem saía do time de vendas continuava aparecendo como se nada tivesse mudado. Com o cadastro, o time comercial passa a ser explícito: quem está nele é oferecido nos seletores e recebe clientes da distribuição automática; quem sai deixa de receber, sem perder nada do que já é dele. Cadastro não é permissão. A permissão de gestão de vendas continua significando "administra o módulo" (metas, recompensas, comissões, regras). Estar no cadastro significa "é vendedor". As duas coisas são independentes — é comum um gerente administrar o módulo sem ser vendedor. Pré-requisitos - Módulo Vendas & Gamificação habilitado na conta. - Permissão de gestão de vendas (ou administrador) para cadastrar, tirar e trazer vendedores de volta. Ver a lista é liberado para qualquer participante do módulo. - Os vendedores precisam ser membros da conta (agentes). Um usuário de outra conta nunca pode ser cadastrado nem receber carteira. Passo a passo 1. Abra Vendas → Carteira e vá até a aba Vendedores. 2. Em Adicionar vendedor, escolha um agente e confirme. Só aparecem agentes que ainda não estão no cadastro. 3. Para tirar alguém do time, use Tirar do time e confirme. Ele deixa de receber clientes novos. 4. Para trazer de volta, use Trazer de volta na linha correspondente. 5. Use os filtros de busca e situação para revisar vendedores ativos ou quem saiu do time. 6. Em um cadastro inativo sem carteira, metas, transferências ou histórico financeiro, use Excluir definitivamente e confirme. O usuário da conta nunca é excluído. Configurações & opções - Situação — Ativo (recebe clientes novos) ou Saiu do time (não recebe mais). - Entrou em — a data em que o vendedor foi cadastrado, registrada automaticamente. - O cadastro é um conjunto: cada agente aparece uma única vez. Adicionar novamente um vendedor inativo reativa o cadastro existente em vez de criar duplicidade. Casos de uso - Time comercial separado do time de suporte. Só os comerciais entram no cadastro, então a distribuição automática nunca manda um lead para quem faz suporte. - Vendedor de férias ou desligado. Tire do time: ele para de receber clientes novos, mas a carteira, as comissões e as metas continuam intactas para fechar o período. - Conta que ainda não organizou o time. Deixe o cadastro vazio: tudo funciona como antes, com todos os agentes disponíveis. Você organiza quando quiser. Dicas, limites e boas práticas - Enquanto o cadastro estiver vazio, os seletores e a distribuição continuam oferecendo todos os agentes. Isso é proposital: cadastrar é uma decisão sua, não uma obrigação. - Tirar do time não redistribui a carteira. Use Transferir carteira (na mesma página) para passar os clientes a outro vendedor — o histórico vai junto. - Saída é registrada, não apagada. A pessoa continua no ranking histórico, nas comissões já provisionadas e na receita já atribuída. - Um vendedor tirado do time que ainda tenha clientes continua aparecendo na aba Todos os vendedores, marcado como Fora do time — para que a carteira dele nunca fique invisível. Solução de problemas - O agente não aparece na lista para adicionar: ele já está no cadastro (veja a tabela abaixo do seletor) ou não é membro desta conta. - "Não foi possível salvar os vendedores": seu perfil não tem gestão de vendas, ou o usuário escolhido não é membro da conta. - A aba Vendedores não aparece: o módulo está desligado na conta, ou seu perfil não tem gestão de vendas (as abas de gestão só aparecem para quem pode usá-las). - A distribuição parou de atribuir: com o cadastro preenchido, ela só entrega a vendedores ativos. Se a regra aponta para alguém que saiu do time, ela não atribui mais — atualize a regra ou traga a pessoa de volta. - A exclusão definitiva foi recusada: o vendedor possui carteira, meta, transferência ou histórico financeiro. Mantenha o cadastro inativo para que esse histórico continue auditável. Veja também - Gestão de vendas: carteira, isolamento por vendedor e metas - Vendas sem vendedor: receita que não foi creditada a ninguém - Visão geral de Vendas & Gamificação
Vendas sem vendedor: receita que não foi creditada a ninguém
Visão geral Uma venda paga entra na receita da conta mesmo quando ninguém é creditado por ela. Quando isso acontece, o dinheiro aparece no total e some de toda quebra por vendedor: ninguém ganha pontos, nenhuma meta avança e nenhuma comissão é provisionada. A tela Vendas → Carteira → Não atribuídos existe para essa diferença não ficar escondida. Ela lista as vendas pagas sem vendedor e deixa você atribuir o responsável direto dali. Por que uma venda fica sem vendedor O vendedor de um pedido é herdado em cascata quando ele é registrado: 1. o negócio ligado ao pedido, se houver; 2. senão, o contato do pedido; 3. senão, a atribuição externa — que vem desligada por padrão. Ou seja: um pedido de e-commerce (Kiwify, Hotmart, Nuvemshop…) para um contato que ainda não tem vendedor, sem negócio no CRM, fica sem dono — e continua assim até alguém atribuir. Pré-requisitos - Módulo Vendas & Gamificação habilitado. - O livro-caixa unificado de receita habilitado (é ele que consolida as vendas pagas). - Permissão de gestão de vendas (ou administrador) para atribuir. Passo a passo 1. Abra Vendas → Carteira e vá até a aba Não atribuídos. 2. Confira a lista: cliente, origem, data do pagamento e valor. 3. Clique em Atribuir vendedor na linha e escolha quem deve receber o crédito. 4. Confirme. Os pontos, o avanço de meta e a comissão passam a contar para essa pessoa, e a linha sai da lista. Configurações & opções - A lista mostra por padrão apenas as vendas sem vendedor — é a fila que precisa ser zerada. - Atribuir uma venda que já tinha vendedor reverte o crédito do anterior e credita o novo; deixar em branco devolve a venda para a fila de não atribuídos. - A página de Receita também passa a mostrar o balde Sem atribuição na quebra por vendedor, com o valor exato que ainda não foi creditado. Casos de uso - Venda de checkout externo sem CRM. O cliente comprou pelo link, sem conversa e sem negócio. Atribua ao vendedor que trabalhou o lead. - Fechamento de mês. Antes de aprovar as comissões, zere a fila para que o extrato de cada vendedor reflita a realidade. - Conferência de receita. Se o total da receita não bate com a soma por vendedor, a diferença está aqui. Dicas, limites e boas práticas - Atribua o quanto antes. Pontos e metas são apurados por período; atribuir depois do fechamento corrige a comissão mas não devolve o efeito motivacional do ranking na hora certa. - Prefira dar dono ao contato. Se o cliente costuma comprar de novo, defina o vendedor no contato: as próximas vendas já nascem atribuídas e a fila deixa de crescer. - Não atribua "para fechar a conta". O crédito move dinheiro de comissão; atribuir a pessoa errada é pior do que deixar em branco. Solução de problemas - A aba não aparece: falta o livro-caixa unificado de receita, ou seu perfil não tem gestão de vendas. - "Vendedor inválido": a pessoa escolhida não é membro desta conta. - A lista está vazia mas a receita não bate: as vendas podem estar atribuídas a alguém que saiu do time — confira a aba Todos os vendedores, onde quem saiu aparece marcado como Fora do time. - A venda volta para a lista depois de atribuir: o pedido foi reprocessado pelo webhook do gateway sem vendedor na origem. Defina o vendedor no contato para quebrar o ciclo. Veja também - Cadastro de vendedores: quem vende, quem recebe carteira - Gestão de vendas: carteira, isolamento por vendedor e metas - Livro-caixa unificado de receita
Meta-sobre-meta e recompensas coletivas de equipe
Visão geral A meta-sobre-meta permite empilhar objetivos em camadas: além da meta base, você cria uma super meta e uma mega meta. Quem ultrapassa um nível desbloqueia o próximo, com aceleradores de superação (recompensas crescentes para quem vai além) e encadeamento de metas (uma meta liberando a seguinte). Isso mantém a equipe motivada mesmo depois de bater o objetivo inicial. Em paralelo, as recompensas coletivas de equipe premiam o time inteiro quando ele atinge (ou ultrapassa) uma meta combinada. A liberação é idempotente por meta, nível e período — ou seja, a premiação é concedida uma única vez para cada combinação, sem risco de duplicidade. Pré-requisitos - Módulo Vendas & Gamificação habilitado. - Permissão de gestão de vendas para criar metas, níveis e recompensas. - Metas individuais e/ou de equipe já estruturadas (ver o artigo de gestão de vendas). - Recompensas configuradas (pontos, badges, moedas ou prêmios) para vincular aos níveis. Passo a passo 1. Crie a meta base do período (por vendedor ou por equipe). 2. Adicione os níveis super e mega sobre a base, definindo o gatilho de cada um (por exemplo, 110% e 130% da base). 3. Configure os aceleradores de superação: defina o que cresce conforme o atingimento avança. 4. Encadeie metas, se desejar: ao concluir uma meta, a próxima é liberada automaticamente. 5. Defina a recompensa coletiva: escolha o que o time ganha quando bate a meta combinada. 6. Acompanhe a liberação: quando o gatilho é atingido, a premiação coletiva é concedida uma única vez (idempotente) para aquele período/nível. Configurações & opções - Camadas de meta: base, super e mega, cada uma com seu gatilho. - Aceleradores de superação: recompensas que aumentam conforme o vendedor passa da meta. - Encadeamento (goal-chaining): a conclusão de uma meta libera a próxima. - Recompensa coletiva: premiação concedida ao time quando o objetivo combinado é alcançado ou superado. - Idempotência: cada combinação (meta + nível + período) gera no máximo uma concessão. Casos de uso - Campanha de fim de mês com base, super e mega para esticar o resultado. - Bônus de equipe quando todos juntos batem o número combinado (não só os top performers). - Sequência de desafios encadeados ao longo de um trimestre. - Acelerador para quem ultrapassa 100% — quanto mais vende, mais ganha. Dicas, limites e boas práticas - Calibre os gatilhos para que super e mega sejam ambiciosos, mas alcançáveis. - Combine recompensa individual (acelerador) com coletiva para equilibrar competição e colaboração. - Comunique claramente os níveis e prêmios — a transparência multiplica o efeito. - Confie na idempotência: a premiação coletiva não é concedida em duplicidade, mesmo com reprocessos. Solução de problemas - A premiação coletiva não foi liberada: confirme que a equipe atingiu o gatilho no período e que a recompensa coletiva está vinculada àquele nível. - Um nível super/mega não desbloqueou: verifique se o gatilho está acima do nível anterior e dentro do período correto. - Acelerador não aplicou: cheque se o vendedor de fato ultrapassou o limite configurado. Veja também - Gestão de vendas: carteira, isolamento por vendedor e metas - Gamificação, leaderboard, recompensas e comissões - TELÃO (wallboard) em tempo real - Visão geral de Vendas e Gamificação
Gamificação, leaderboard, recompensas e comissões
Visão geral A gamificação dá vida ao desempenho da equipe. Os pontos são derivados de eventos reais do produto — negócio ganho no CRM, pagamento confirmado, venda do catálogo, agendamento ou conversão de follow-up — e alimentam um leaderboard ao vivo com pódio, níveis, ligas, concursos (individuais e de equipe), badges/medalhas (de Bronze a Diamante), certificações, reconhecimento público e a análise de Pareto. Sobre essa camada, a plataforma traz uma economia de recompensas (moedas trocáveis por prêmios em um catálogo) e os módulos de comissão, com planos por faixas, aceleradores, SPIF, estorno (clawback) e extratos auditáveis. As comissões são apuradas a partir de eventos reais — por padrão no pagamento confirmado, com opção de apurar no negócio ganho. Pré-requisitos - Módulo Vendas & Gamificação habilitado. - Permissão de gestão de vendas para configurar pontos, recompensas e comissões. - Eventos reais fluindo (CRM, Pagamentos, Catálogo, Agenda, Follow-ups) para gerar pontos e apurar comissões. - Catálogo de prêmios e/ou plano de comissão definidos, conforme o que você for usar. Passo a passo 1. Confirme as fontes de pontos. Decida quais eventos pontuam e com qual peso. 2. Configure níveis e ligas. Defina a progressão (níveis) e os grupos de competição (ligas). 3. Crie concursos. Lance desafios por período, individuais ou de equipe. 4. Ative badges e reconhecimento. Escolha os troféus (Bronze→Diamante) e como celebrar conquistas. 5. Monte a economia de moedas. Defina como o time ganha moedas e cadastre o catálogo de prêmios. 6. Gerencie os resgates. Aprove e acompanhe a fila de resgates dos prêmios. 7. Crie o plano de comissão. Defina faixas, aceleradores, SPIF e regras de estorno. 8. Acompanhe os extratos. Verifique a apuração (accrued → aprovado → pago) e use o simulador. Configurações & opções - Leaderboard: ranking ao vivo com pódio e atualização em tempo real. - Pontos: derivados de eventos reais, com pesos configuráveis. - Níveis e ligas: progressão individual e grupos de competição. - Concursos: desafios por período, individuais e de equipe. - Badges/medalhas e reconhecimento: troféus de Bronze a Diamante, certificações e broadcast. - Moedas e catálogo: ganho de moedas + prêmios resgatáveis + fila de resgates. - Comissões: planos por faixa, aceleradores, SPIF, clawback, extratos e simulador (apuração no pagamento confirmado por padrão; negócio ganho como opção). - Pacotes por nicho (Program Packs): modelos prontos para começar rápido (SaaS, varejo, imóveis, infoproduto, agência e B2B). Casos de uso - Ranking diário no TELÃO com pódio dos três primeiros. - Concurso relâmpago (SPIF) de fim de semana para um produto específico. - Loja de prêmios onde o time troca moedas por benefícios. - Comissão transparente, com extrato que o vendedor consulta a qualquer momento. Dicas, limites e boas práticas - Comece com poucas fontes de pontos e um catálogo enxuto; evolua com o tempo. - Use os pacotes por nicho para acelerar a configuração inicial. - Garanta que crediar a comissão (apurar) é diferente de rankear: defina cada regra com clareza. - Revise os resgates com frequência para manter a confiança na economia de moedas. Solução de problemas - Os pontos não aparecem: confirme que os eventos reais estão ocorrendo e que a fonte de pontos está ativa. - O saldo de moedas parece errado: lembre que o saldo é a soma do histórico de movimentações (créditos e resgates). - A comissão não foi apurada: verifique a regra de gatilho (pagamento confirmado ou negócio ganho) e o período do plano. - Um resgate ficou preso: cheque a fila de resgates e as aprovações pendentes. Veja também - TELÃO (wallboard) em tempo real - Meta-sobre-meta e recompensas coletivas de equipe - Gestão de vendas: carteira, isolamento por vendedor e metas - Visão geral de Vendas e Gamificação
TELÃO (wallboard) em tempo real
Visão geral O TELÃO (wallboard) é a vitrine ao vivo da operação de vendas. Em uma tela grande — uma TV no escritório ou um navegador em tela cheia — ele mostra o ranking em tempo real com reordenação animada, pódio com movimento, termômetro de equipe (progresso rumo à meta) e celebrações quando alguém bate a meta base, super ou mega. É a ferramenta perfeita para criar energia e foco na equipe. O TELÃO suporta múltiplas cenas (alternando, por exemplo, entre ranking individual, ranking de equipe e concursos), pode ser aberto com um token de exibição somente leitura (sem expor a conta) e aceita personalização visual (whitelabel) para combinar com a sua marca. Pré-requisitos - Módulo Vendas & Gamificação habilitado, com gamificação configurada (pontos/leaderboard). - Permissão de gestão de vendas para gerar o link/token de exibição e ajustar as cenas. - Metas ativas no período para alimentar o termômetro e as celebrações. - Uma tela para exibição (TV, monitor ou navegador em tela cheia) com acesso à internet. Passo a passo 1. Abra a configuração do TELÃO no módulo de Vendas & Gamificação. 2. Escolha as cenas que deseja exibir (ranking individual, equipe, concursos) e a ordem de rotação. 3. Ajuste a aparência (cores, logo e identidade visual) conforme a sua marca. 4. Gere o token de exibição somente leitura para abrir o TELÃO em telas públicas com segurança. 5. Abra em tela cheia na TV/monitor do escritório usando o link de exibição. 6. Acompanhe ao vivo: o ranking reordena, o pódio se anima e as metas batidas são celebradas automaticamente. Configurações & opções - Cenas (multi-scene): alterna entre diferentes painéis em rotação. - Reordenação animada: o ranking se reorganiza em tempo real a cada nova pontuação. - Pódio com movimento: destaque animado para os primeiros colocados. - Termômetro de equipe: barra de progresso coletiva rumo à meta do período. - Celebrações: efeitos visuais ao atingir metas base, super e mega. - Token de exibição (somente leitura): link seguro para telas públicas, sem login na conta. - Personalização visual (whitelabel): cores, logo e tema próprios. Casos de uso - TV na sala de vendas mostrando o ranking do dia o tempo todo. - Cena dedicada a um concurso relâmpago durante uma campanha. - Celebração imediata quando um vendedor fecha um negócio (efeito no telão). - Telão em eventos/kickoffs para reconhecer a equipe publicamente. Dicas, limites e boas práticas - Use o token somente leitura para telas públicas — evite deixar uma sessão logada exposta. - Faça rodízio de cenas para manter o telão interessante ao longo do dia. - Combine o TELÃO com rituais (abertura/fechamento do dia) para reforçar o hábito. - Em telas de longa exposição, prefira o modo tela cheia e mantenha o navegador atualizado. Solução de problemas - O telão não atualiza em tempo real: verifique a conexão de internet e recarregue a página de exibição. - O link de exibição não abre: confirme se o token de exibição foi gerado e ainda está válido. - As celebrações não aparecem: confira se há metas ativas no período e se a gamificação está configurada. - A marca não aparece personalizada: revise as opções de personalização visual do TELÃO. Veja também - Gamificação, leaderboard, recompensas e comissões - Meta-sobre-meta e recompensas coletivas de equipe - Gestão de vendas: carteira, isolamento por vendedor e metas - Visão geral de Vendas e Gamificação
Engagement & Lead Score: timeline de engajamento e pontuação configurável
Visão geral O Engagement & Lead Score mede o quão engajado está cada contato e calcula uma pontuação de lead configurável. Cada interação relevante vira um evento em uma linha do tempo (timeline) ligada ao contato — e essa linha sobrevive mesmo que a conversa ou o negócio de origem sejam excluídos, porque os eventos são guardados de forma independente. Você define um catálogo de eventos (uma espécie de "pixel" de comportamento), organiza os eventos em grupos de pontos e atribui pesos a cada um. Eventos reais do produto — mensagens, negócios, follow-ups, pagamentos, agendamentos, vendas do catálogo, e-mails — são mapeados para esse catálogo e somam (ou não) pontos conforme o peso. Com isso, sua equipe prioriza os leads mais quentes. Esse módulo é o eixo do lead (o contato), complementar ao módulo de Vendas, que é o eixo do ator (o vendedor). Quando faz sentido, um mesmo evento pode dar crédito duplo: pontos de engajamento para o contato e, se o ator for um vendedor, XP para o vendedor no módulo de Vendas. Pré-requisitos - Módulo Engagement & Lead Score habilitado na conta (recurso opcional, ativado por um administrador/operador). - Permissão de gestão de engajamento para configurar o catálogo de eventos, grupos e pesos. - Eventos reais fluindo na plataforma (conversas, mensagens, CRM, pagamentos, agenda, follow-ups, catálogo) para alimentar a pontuação. - Para o crédito duplo de XP do vendedor, o módulo de Vendas & Gamificação também precisa estar habilitado. Passo a passo 1. Monte o catálogo de eventos. Cadastre os eventos que você quer acompanhar (cada um com nome, grupo, ícone e pontos padrão). 2. Defina os grupos de pontos. Agrupe eventos por tema (por exemplo, atendimento, compra, marketing). 3. Ajuste os pesos. Dê mais pontos aos eventos mais importantes; use peso 0 para apenas registrar (acompanhar) sem pontuar. 4. Escolha a política de deduplicação por evento: contar sempre, uma vez por contato, ou com intervalo (cooldown). 5. Acompanhe a timeline. No painel do contato, veja a linha do tempo de engajamento e o lead score. 6. Priorize e segmente. Ordene listas pelo score e crie segmentos dos leads mais quentes. 7. (Opcional) Rastreie eventos externos. Use o rastreador (pixel) com token para registrar eventos fora da plataforma. Configurações & opções - Catálogo de eventos (definições): chave, nome, grupo, ícone, pontos padrão e se está ativo. - Grupos de pontos: contadores nomeados que somam pontos por tema. - Pesos: pontuação por evento (incluindo 0 para registrar sem pontuar). - Deduplicação: contar sempre, uma vez por contato, ou com cooldown (intervalo configurável). - Lead score: pontuação geral e por grupo, exibida no contato e usável para ordenar/segmentar. - Crédito duplo: o mesmo evento pode pontuar o contato (engajamento) e o vendedor (XP em Vendas). - Rastreador (pixel): endpoint público com token para eventos externos. - Retenção: período opcional de retenção dos eventos da timeline (sem decaimento de pontos na v1). Casos de uso - Priorizar a fila de leads pelos contatos com maior score. - Criar um segmento de "leads quentes" para uma ação de vendas direcionada. - Acompanhar a jornada de um contato em uma única linha do tempo, mesmo após arquivar conversas. - Registrar comportamentos fora da plataforma (visita a uma página, abertura de e-mail) via pixel. Dicas, limites e boas práticas - Comece com poucos eventos de alto valor; refine os pesos com o tempo. - Use peso 0 para experimentar um evento novo antes de decidir quanto ele vale. - Combine a política de deduplicação certa para evitar inflar o score (ex.: "uma vez por contato" para cadastros). - Lembre-se: na v1 não há decaimento de pontos — o score é cumulativo. Solução de problemas - O lead score não muda: confirme que o evento está ativo no catálogo, com peso maior que 0, e que os eventos reais estão ocorrendo. - Um evento contou demais: revise a política de deduplicação (talvez precise de "uma vez por contato" ou um cooldown). - A timeline sumiu após excluir uma conversa: ela não some — os eventos de engajamento são preservados de forma independente da origem. - O pixel externo não registra: verifique o token do rastreador e os limites de requisição. Veja também - Visão geral de Vendas e Gamificação - Gestão de vendas: carteira, isolamento por vendedor e metas - Gamificação, leaderboard, recompensas e comissões - TELÃO (wallboard) em tempo real
Painéis e relatórios de vendas: lendo o desempenho, atingimento e payout
Visão geral O módulo de Vendas da Conversa Labs tem superfícies de consumo (onde você lê os números) e uma superfície ao vivo (o TELÃO). As de consumo são três: - Painel do Vendedor — a leitura individual: suas moedas, badges, nível, pontos do mês e o progresso das suas metas. - Painel do Gestor — a visão agregada da equipe, montada a partir do ranking (leaderboard), dos Relatórios e do TELÃO. - Relatórios de vendas — o painel analítico de atingimento, histórico de comissões (payout) e histórico de ranking, com exportação em CSV. Acima de tudo isso, o TELÃO (wallboard) mostra o ranking ao vivo em uma TV do escritório. Em todas as superfícies, os números derivam de eventos reais do produto — negócios ganhos no CRM, pagamentos confirmados, agendamentos, follow-ups que convertem. Não há digitação manual: o que você lê é o que a operação realmente produziu. Pré-requisitos - Módulo Vendas & Gamificação habilitado na conta. - Eventos reais fluindo na plataforma (negócios no CRM, pagamentos, agendamentos), para que haja o que pontuar e relatar. - Metas ativas no período vigente, para que o atingimento tenha referência. - Para abrir os Relatórios de vendas e as exportações CSV (incluindo o livro de um vendedor específico), é necessária a permissão de gestão de vendas (sales_manage) — ou ser administrador. O Painel do Vendedor não exige essa permissão. Passo a passo 1. Abra o Painel do Vendedor. Confira, de relance, saldo de moedas, badges, nível, pontos do mês e o progresso de até 5 metas ativas. 2. Acompanhe o ranking. Veja sua posição no leaderboard (por métrica, período e escopo) e no TELÃO ao vivo. 3. Gestor: abra os Relatórios de vendas. Leia as três seções — atingimento, histórico de payout e histórico do leaderboard. 4. Aplique filtros. Estreite por período, vendedor, métrica e escopo para responder a uma pergunta específica. 5. Exporte em CSV. Baixe o extrato de comissões ou o histórico de ranking para conciliar ou analisar fora da plataforma. Configurações & opções Painel do Vendedor A leitura individual é sempre da sua própria carteira. Os widgets: | Widget | O que mostra | De onde vem | |---|---|---| | Saldo de moedas | Moedas disponíveis para resgate | Soma do extrato de moedas (créditos menos débitos) | | Badges conquistados | Quantidade de medalhas que você ganhou | Premiações de badge atribuídas a você | | Nível atual | Seu nível e os pontos acumulados que o sustentam | Maior nível cujo limiar de pontos você ultrapassou | | Pontos do mês | Pontos somados no mês corrente | Eventos de pontos do mês vigente | | Metas ativas | Até 5 metas (a sua, a da sua equipe e a da conta) com % de atingimento | Metas vigentes mais o atingimento calculado | Painel do Gestor O gestor consolida a equipe a partir de três fontes: o leaderboard (ranking por métrica × período × escopo), os Relatórios de vendas (atingimento, payout e histórico do ranking) e o TELÃO ao vivo. É aqui que carteira, metas e ranking se conectam: a carteira define o dono de cada negócio, as metas definem o alvo, e o ranking ordena quem está mais perto de bater. O Painel do Vendedor continua individual mesmo para o gestor — a visão de equipe vem do ranking e dos Relatórios. Relatórios de vendas O overview analítico traz três seções: | Seção | O que traz | |---|---| | Atingimento (attainment) | % de atingimento por meta vigente, com valor atual e data do cálculo (até 50 metas, da maior para a menor) | | Histórico de payout | Totais de comissão por período: acumulado, aprovado e pago | | Histórico do leaderboard | O vencedor (1º lugar) por período e métrica | Filtros disponíveis: | Filtro | Efeito | |---|---| | Período (period_start) | Considera registros a partir da data informada | | Vendedor (payee_id) | Restringe ao extrato de um vendedor (livro individual) | | Métrica (metric) | Filtra o histórico de ranking pela métrica | | Escopo (scope_type) | Filtra o histórico de ranking por tipo de escopo (conta/equipe/vendedor) | Exportação CSV A exportação aceita ?kind=commissions ou ?kind=leaderboard (sem o parâmetro, o padrão é comissões): | Exportação | Quando usar | Colunas | |---|---|---| | Comissões (?kind=commissions) | Conciliar payout e contabilidade | payee_id, period_start, period_end, status, total_accrued, total_approved, total_paid | | Leaderboard (?kind=leaderboard) | Analisar o histórico do ranking | rank, user_id, team_id, scope_type, period_type, period_start, metric, value, trend | Permissões e privacidade - O Painel do Vendedor é isolado por vendedor: cada métrica (moedas, badges, nível, pontos) é filtrada pelo seu usuário. Um vendedor não enxerga os números de outro. - O ranking (leaderboard/TELÃO) é a visão compartilhada da competição. - Os Relatórios de vendas e as exportações CSV exigem a permissão de gestão de vendas. Puxar o livro de um vendedor específico (filtro por vendedor) também é uma ação de gestão. Casos de uso - O vendedor abre o painel pela manhã e vê, em segundos, quão perto está da meta do mês. - O gestor usa os Relatórios para identificar quem está acima e abaixo do atingimento por meta. - O financeiro exporta o CSV de comissões para conciliar o payout do período. - A liderança exporta o histórico do leaderboard para analisar a evolução do ranking ao longo dos períodos. Dicas, limites e boas práticas - Trate o Painel do Vendedor como ritual diário — é a forma mais rápida de ver o progresso da meta. - Nos Relatórios, comece sem filtros e estreite aos poucos; filtros muito restritos podem esvaziar o resultado. - O atingimento lista as metas vigentes da maior para a menor — use-o para priorizar quem precisa de apoio. - A exportação de comissões reflete o extrato (payout); a de leaderboard reflete os snapshots do ranking. Escolha a que responde à sua pergunta. Solução de problemas - Painel zerado: provavelmente não há eventos pontuáveis no período (negócios, pagamentos, agendamentos) ou não há metas ativas. Confirme o uso de CRM/Pagamentos/Agenda e a existência de metas vigentes. - Relatório vazio: os filtros podem estar restritos demais ou o escopo errado. Amplie o período, limpe o filtro de vendedor/métrica e revise o tipo de escopo. - Exportação bloqueada: você não tem a permissão de gestão de vendas. Peça a um administrador para conceder o perfil adequado. Veja também - Visão geral de Vendas e Gamificação - Gestão de vendas: carteira, isolamento por vendedor e metas - Gamificação, leaderboard, recompensas e comissões - TELÃO (wallboard) em tempo real
Ledger unificado de receita: contagem única de vendas por origem, gateway, vendedor e afiliado
Visão geral O ledger unificado de receita é o registro nativo, em R$, de toda venda paga — não importa a origem. Uma cobrança paga na conversa, um pedido de catálogo do WhatsApp, uma venda do Hotmart, um pedido manual ou um pedido via API convergem para um único pedido canônico (o registro de pedidos do CRM). No momento em que esse pedido é pago, a Conversa Labs credita o vendedor (dono do pedido) uma única vez: pontos de gamificação, comissão e a receita que aparece no relatório. Antes disso, cada caminho de dinheiro creditava de forma diferente (ou não creditava): uma venda de catálogo ou do Hotmart podia não render pontos nem comissão a ninguém, enquanto uma cobrança creditava o autor. O ledger unificado resolve isso com um único eixo de receita e contagem exatamente uma vez — a mesma venda nunca é contada em dobro. Pré-requisitos - Módulo Vendas & Gamificação habilitado na conta. - Recurso unified_revenue_ledger ativado na conta (é dark-ship, padrão desligado — o operador ativa). Com ele desligado, o comportamento é idêntico ao anterior. - Registro de pedidos do CRM (orders_registry) ativado para que cobranças e pedidos de comércio também convirjam ao pedido único — é o que suprime o crédito legado e garante a contagem única. - Permissão de gestão de vendas (sales_manage) — ou administrador — para ler o ledger e exportar. - Vendas pagas reais fluindo (cobranças, catálogo, Hotmart, pedidos manuais), para haver o que contabilizar. Passo a passo 1. Ative o recurso unified_revenue_ledger (e o orders_registry) na conta. 2. Garanta vendas fluindo por qualquer origem — a convergência é automática pelos alimentadores de pedido. 3. Abra a visão de Receita no painel/TELÃO de Vendas. 4. Escolha o período (o padrão são os últimos 30 dias). 5. Leia os agrupamentos — total por moeda, por origem, por gateway, por vendedor e por afiliado. 6. Exporte em CSV para conciliar a receita fora da plataforma. Configurações & opções O que o ledger agrupa Sobre os pedidos pagos do período (por paid_at), a receita é somada e agrupada: | Agrupamento | O que traz | |---|---| | Total por moeda | Receita total em R$ por moeda — nunca soma moedas diferentes | | Por origem | Receita por source do pedido: manual, webhook, api, payments, commerce | | Por gateway | Receita por gateway de dinheiro (asaas, mercado_pago, hotmart, nativo, catálogo…) | | Por vendedor | Receita por dono do pedido (o vendedor creditado) | | Por afiliado | Receita por afiliado atribuído (atribuição dupla) | Contagem exatamente uma vez (sem duplicidade) O crédito acontece no eixo do pedido quando existe um pedido, e no caminho legado apenas quando nenhum pedido é produzido: | unified_revenue_ledger | orders_registry | Quem credita | Resultado | |---|---|---|---| | Desligado | qualquer | Caminho legado (cobrança/comércio) | idêntico ao anterior | | Ligado | Ligado | order.paid (o pedido) — legado suprimido | uma vez, no pedido | | Ligado | Desligado | Legado (nenhum pedido é produzido) | uma vez, na cobrança/comércio | Atribuição do vendedor (fallback) O dono do pedido é resolvido em cascata: negócio → contato → responsável → criador. Uma cobrança sem negócio ainda atribui ao usuário que a criou (campo de criador na cobrança), então nenhuma venda paga fica "sem dono". Atribuição de vendas externas ao vendedor Vendas externas (catálogo, Hotmart, Kiwify e outros gateways) chegam a partir do gateway e, muitas vezes, para um contato comprador que não está na carteira de ninguém. Sem uma regra, essa venda paga ficaria "sem vendedor". A configuração por conta external_attribution_mode decide como o vendedor é resolvido automaticamente nesse caso: | Modo | O que faz | |---|---| | off (padrão) | Nenhum crédito automático — a venda externa fica sem vendedor até uma atribuição manual | | last_conversation | Credita o agente que atendeu o comprador por último (a última conversa do contato) | | distribution | Credita conforme as regras de distribuição ativas (as mesmas da distribuição de leads) | Quando o modo resolve um vendedor, a carteira do comprador é reivindicada de forma durável para esse vendedor — assim, as próximas vendas do mesmo contato já entram com dono. O padrão é off: nenhum crédito automático até você escolher explicitamente last_conversation ou distribution. Reatribuição manual do vendedor. Um gestor (permissão de gestão de vendas) pode, a partir do pedido, vincular uma venda externa a um vendedor ou mover o crédito entre agentes. A troca reverte os pontos e a comissão do dono anterior e credita o novo dono; o crédito do afiliado não é afetado. Deixar o vendedor em branco desvincula o pedido. Toda mudança é auditada (evento order_reattributed), preservando o histórico de quem foi creditado e por quê. Estorno (clawback) Quando um pedido é estornado, o crédito é revertido na origem do pedido — para o vendedor e para o afiliado —, mantendo o ledger fiel ao dinheiro efetivamente recebido. Exportação CSV Uma linha por pedido pago, com as colunas: order_id, paid_at, source, gateway, owner_id, affiliate_id, amount, currency. Os valores estão em unidades maiores (ex.: 4970.50 = R$ 4.970,50). Permissões e visibilidade - Ler o ledger e exportar exigem a permissão de gestão de vendas. - A leitura respeita o isolamento por vendedor: sob carteira/privacidade, um gestor vê apenas a sua cascata; um vendedor, apenas a própria carteira. Casos de uso - O gestor lê a receita em R$ por vendedor para reconhecer quem mais vendeu no período. - O financeiro exporta o CSV para conciliar a receita paga com o extrato de comissões. - A liderança compara a receita por origem (Hotmart × catálogo × cobrança) e por gateway. - A receita por afiliado alimenta o acompanhamento do programa de afiliados (atribuição dupla). Dicas, limites e boas práticas - O dinheiro está em unidades maiores (decimal), a mesma convenção de Pagamentos/Catálogo — nunca divida por 100. - O ledger nunca soma moedas diferentes: cada moeda é uma linha. - Ativar o recurso credita as vendas daqui para frente — não há reprocessamento retroativo automático. Para reprocessar histórico do Hotmart, use o backfill do operador. - Ative ambos os recursos (unified_revenue_ledger + orders_registry): é essa combinação que suprime o caminho legado e evita a contagem em dobro. Solução de problemas - Ledger vazio: não há pedidos pagos no período, ou o recurso está desligado. Confirme a ativação e a existência de vendas pagas. - Números em dobro: o orders_registry provavelmente está desligado, então o caminho legado e o do pedido creditam juntos. Ative o registro de pedidos. - Vendedor aparece como nulo: o pedido não teve dono resolvido (sem negócio, contato, responsável ou criador). Verifique a atribuição na origem. - Venda externa sem vendedor ou creditada ao vendedor errado: se external_attribution_mode está off, vendas externas ficam sem dono — escolha last_conversation ou distribution, ou faça a reatribuição manual (gestão de vendas) a partir do pedido. - Estorno não refletido: o evento de estorno do pedido não foi disparado. Confirme o fluxo de reembolso no gateway/Pagamentos. - Exportação bloqueada: falta a permissão de gestão de vendas. Peça a um administrador. Veja também - Programa de afiliados: atribuição dupla, comissão e portal - Painéis e relatórios de vendas - Visão geral de Vendas e Gamificação
Programa de afiliados: atribuição dupla, códigos de indicação, comissão e portal
Visão geral O programa de afiliados transforma quem indica vendas em uma entidade nativa com comissão própria. Um afiliado pode ser quatro coisas, e o vínculo é de identidade (quem é o parceiro), nunca de pagamento — o recebedor é sempre o cadastro do afiliado: | O afiliado é | Quando usar | |---|---| | Um agente | Alguém da equipe que também indica vendas de outra carteira | | Um contato | Um cliente que virou parceiro e passou a indicar outros | | Uma empresa | Uma agência, revenda ou clínica parceira — os contatos dela podem herdar o vínculo | | Um parceiro externo | Alguém que a conta não conhece: só e-mail/código (ex.: um afiliado do Hotmart) | Cada afiliado recebe um código de indicação único (público, para compartilhar) e um token de relatório separado (privado, rotacionável). O ponto central é a atribuição dupla: um mesmo pedido pago credita o vendedor (dono) no extrato do usuário e o afiliado — no mesmo ledger de comissão, sem colisão. Assim, o vendedor continua recebendo seus pontos e comissão, e o afiliado recebe a comissão de indicação, sobre a mesma venda, sem contagem dobrada. Pré-requisitos - Módulo Vendas & Gamificação habilitado na conta. - Recurso affiliate_program ativado na conta (dark-ship, padrão desligado). - Recurso unified_revenue_ledger ativado — a comissão do afiliado é acumulada no momento em que o pedido é pago (o mesmo eixo do ledger unificado). Sem ele, não há acúmulo de comissão de afiliado. - Permissão de gestão de vendas (sales_manage) — ou administrador — para gerenciar afiliados. Passo a passo 1. Ative affiliate_program (e unified_revenue_ledger) na conta. 2. Crie um afiliado: escolha em "Este afiliado é" se ele é um agente, um contato, uma empresa ou um parceiro externo; depois defina a comissão (percentual, valor fixo por venda ou plano). 3. Compartilhe o código/link de indicação com o afiliado. 4. Atribua a indicação por qualquer um destes caminhos: marque "Indicado por" na ficha do contato, use a ação de automação "Definir afiliado do contato", envie affiliate_id no pedido, ligue a herança pela empresa, ou deixe o reconciliador casar o split da venda. 5. A venda paga credita o vendedor e o afiliado automaticamente. 6. O afiliado acompanha seu desempenho pelo portal (por token); o gestor lê o relatório no painel. Configurações & opções Campos do afiliado | Campo | O que é | |---|---| | name | Nome do afiliado (obrigatório) | | user_id / contact_id / organization_id | Quem o afiliado é — um agente, um contato ou uma empresa. São mutuamente exclusivos: preencher mais de um é recusado | | inherit_to_org_contacts | Só para empresa: quando ligado, os contatos daquela empresa herdam o afiliado nos novos pedidos | | email / external_ref | E-mail e/ou código externo (ucode do Hotmart). Únicos por conta — é por eles que o reconciliador identifica o parceiro | | referral_code | Código de indicação — gerado automaticamente, único por conta, público, feito para compartilhar | | portal_token | Credencial privada do relatório do afiliado. Separada do código e rotacionável | | commission_percent | Comissão (%) — percentual de comissão (0–100); vazio quando um plano define | | commission_amount | Comissão fixa (R$) — valor fixo pago por venda, no lugar do percentual. Opcional: deixe em branco para usar o percentual | | plan_id | Plano de comissão que substitui o percentual e o valor fixo | | status | active, paused ou archived — apenas ativo acumula comissão | | metadata | Dados livres (ex.: a afiliação do Hotmart preservada) | Formato do valor: os campos de comissão aceitam vírgula ou ponto como separador decimal — 25,00 e 25.00 valem o mesmo, e o separador de milhar é opcional (1.250,50). Um valor fora da faixa (percentual acima de 100, valor negativo) é recusado na hora, com o motivo ao lado do campo. Como a venda é atribuída ao afiliado Em cascata, do mais explícito para o mais genérico. O primeiro degrau que responder vence, e um afiliado já gravado no pedido nunca é sobrescrito: 1. affiliate_id enviado no pedido — aceito pela API do CRM, pelo ingest público e pelas automações. O id é sempre conferido contra os afiliados ativos desta conta: um id de outra conta é descartado. 2. "Indicado por" no contato — a indicação durável da pessoa. 3. Afiliado da empresa principal do contato — só quando aquele afiliado ligou inherit_to_org_contacts. Vale apenas para a empresa principal e apenas daí para frente: ligar a opção não recredita pedidos antigos. 4. Split externo reconciliado — casa o ucode/e-mail do split (Hotmart/Kiwify) com um afiliado existente, inclusive pelo e-mail do contato ou da empresa vinculada. 5. Sem correspondência → o split vai para a fila de reconciliação, e não some. Splits sem cadastro Quando o gateway informa uma comissão para alguém que a conta não tem cadastrado, esse split é registrado numa fila visível — com nome, e-mail/ucode, valor informado e o pedido de origem. Antes, esse caso simplesmente desaparecia dentro da metadata: o único sintoma era uma comissão que nunca aparecia. Abra "Splits sem cadastro" na tela de Afiliados e decida: Cadastrar (abre o formulário já preenchido com os dados do split) ou Ignorar. A fila nunca cria um afiliado sozinha — pagar alguém a partir de um nome não verificado que veio de um webhook é exatamente o risco que essa confirmação existe para evitar. Atribuição dupla sem colisão O ledger de comissão distingue o tipo de recebedor (vendedor vs. afiliado). Um pedido pago gera duas linhas — a do vendedor e a do afiliado — sem se misturar. O extrato de um vendedor nunca soma as linhas do afiliado. Comissão do afiliado A comissão é resolvida por venda, nesta ordem de precedência — do mais preciso para o mais genérico: 1. Valor reportado pela fonte — quando a venda veio do Hotmart ou da Kiwify, a própria plataforma informa quanto de fato pagou àquele afiliado. Esse valor é autoritativo e entra no ledger exatamente como veio, para que o extrato nunca divirja do que o afiliado realmente recebeu. 2. Plano de comissão — quando o afiliado tem um plano. 3. Comissão fixa (R$) — o valor fixo definido no afiliado. 4. Comissão (%) — o percentual sobre o valor pago do pedido. Por que a fonte vem primeiro: em um programa de afiliados externo, a plataforma já calculou e pagou o split — aplicar o nosso percentual por cima produziria um número que não bate com a realidade. Afiliado externo recebe comissão e portal, mas não ganha pontos de gamificação (pontos exigem um usuário). Extrato do afiliado O afiliado tem extrato próprio, com o mesmo ciclo do extrato do vendedor: acumulado → aprovado → pago. Ele é fechado por período e por moeda — um extrato é um documento a pagar, e você paga em uma moeda só, então lançamentos em BRL e em USD viram extratos separados em vez de um total que não existe. Extrato de afiliado e extrato de vendedor são registros independentes, mesmo quando o número de identificação coincide. Na lista de extratos, o filtro de tipo de recebedor separa os dois ledgers. Portal do afiliado Página pública e somente-leitura, aberta pelo token de relatório — sem sessão e sem account_id. Mostra apenas o próprio desempenho: pedidos atribuídos (paginados, com filtro de período), receita e comissão agrupadas por moeda, e os extratos fechados — sem PII de contatos. Token inválido, rotacionado ou conta com o recurso desligado retornam 404. O token não é o código de indicação. O código é público — vai em links e material — e continua válido para sempre; o token é a credencial privada do relatório financeiro. Use Girar no cadastro do afiliado para invalidar imediatamente todo link de relatório já compartilhado: nenhuma indicação deixa de funcionar, porque o código não muda. Afiliados criados antes desta versão começam com o token igual ao código de indicação público — foi assim que nenhum link já entregue quebrou na migração. Enquanto isso for verdade, quem conhece o código consegue abrir o relatório, e o cadastro mostra o aviso "este link ainda é o código público". Gire o token desses afiliados para emitir um link realmente privado. Arquivar, restaurar e excluir definitivamente A lista padrão mostra afiliados atuais; use o filtro de status para revisar ativos, pausados e arquivados. Arquivar interrompe novas atribuições e comissões, mas mantém indicações, pedidos e demonstrativos existentes; Restaurar torna o parceiro ativo novamente. Excluir definitivamente só aparece no afiliado arquivado e só funciona quando não existe histórico de indicação, pedido, reconciliação ou financeiro; a confirmação é explícita e a ação não pode ser desfeita. Casos de uso - Materializar um afiliado do Hotmart a partir do split preservado na venda (reconciliação por ucode/e-mail). - Registrar um agente interno como afiliado que indica vendas de outra carteira. - Compartilhar um link de indicação para captar indicações rastreáveis. - O afiliado abre o portal e acompanha sua comissão acumulada em tempo quase real. Dicas, limites e boas práticas - Afiliado externo não recebe pontos de gamificação — só comissão + portal. - Apenas afiliados ativos acumulam; um afiliado pausado/arquivado não acumula nada. - O pagamento ao afiliado (Pix/transferência) está fora do escopo v1 — o módulo faz acúmulo + relatório + portal. - O referral_code é público — compartilhe à vontade. Quem abre o relatório financeiro é o token de relatório, que é privado e pode ser girado a qualquer momento. - A herança pela empresa é opt-in por afiliado e só vale daqui para frente — ligar a opção não recredita nada do passado. - Ao mesclar contatos, a indicação do contato absorvido é adotada pelo principal quando ele ainda não tem uma; um contato que já tinha indicação mantém a dele. - Um estorno também reverte a comissão do afiliado, na origem do pedido. Solução de problemas - Afiliado não creditado: o unified_revenue_ledger pode estar desligado, o pedido pode não ter afiliado atribuído, ou o afiliado não está ativo. Verifique os três. - Portal retorna 404: token errado/antigo ou o recurso affiliate_program está desligado na conta. - Afiliado do Hotmart não casou: o split entrou em "Splits sem cadastro". Abra a fila e use Cadastrar — o formulário já vem preenchido com o e-mail/ucode exatos que vieram do gateway. - Comissão aparece com "sem moeda": são lançamentos anteriores à separação por moeda. A moeda real deles é desconhecida e não é inventada; novos lançamentos já saem com a moeda do pedido. - A exclusão definitiva foi recusada: ainda existe histórico de indicação, pedido, reconciliação ou financeiro. Mantenha o afiliado arquivado; preservar esse histórico é intencional. Veja também - Ledger unificado de receita: contagem única de vendas - Painéis e relatórios de vendas - Visão geral de Vendas e Gamificação