Manual do painel · Inteligência

Monitor de sucesso: análise RFV de clientes, importação de pedidos e agentes de reativação

O Monitor de sucesso é a tela que separa quem já comprou em grupos RFV (recência, frequência e valor), mostra as vendas e os pedidos em aberto e cria agentes de IA para reengajar cada grupo.

Quem pode usar

Papel	O que vê e faz
Dono	Vê a tela, importa pedidos, baixa o relatório e é o único que salva e ativa um agente especialista, dispara e pausa ou ativa agentes.
Admin	Vê a tela, importa pedidos, baixa o relatório e pode abrir o rascunho de um agente; salvar e ativar, disparar e pausar ficam com o dono.
Atendente	Vê o item no menu e lê a tela e o relatório; importar pedidos é recusado com o aviso de que a conta não tem permissão.

Telas

Monitor de sucesso

A tela Monitor de sucesso serve para ver a saúde da base de clientes pelos pedidos reais, achar quem está esfriando e montar uma abordagem de reengajamento para cada grupo.

Endereço no painel: /app/monitor

Captura da tela Monitor de sucesso. A tela Monitor de sucesso serve para ver a saúde da base de clientes pelos pedidos reais, achar quem está esfriando e montar uma abordagem de reengajamento para cada grupo. — A tela Monitor de sucesso na conta de demonstração, com dados fictícios e os valores desfocados.

Cabeçalho

A origem dos dados, o tamanho da base, o período das vendas e as ações principais.

Botões e ações

7 dias: Mostra no cartão de vendas os últimos 7 dias.
30 dias: Mostra no cartão de vendas os últimos 30 dias. É o período que a tela abre.
90 dias: Mostra no cartão de vendas os últimos 90 dias.
Importar pedidosDono, Admin: Abre o diálogo para enviar a planilha CSV de pedidos.
Baixar relatório: Baixa uma planilha CSV com cada grupo (clientes, recência, frequência e valor médio) e as vendas do período.

Selo Importação · atualizado há ‹tempo›, quando já houve importação.
Contagem: ‹n› clientes · ‹n› pedidos.
O seletor de dias muda só o cartão de vendas; grupos, gráfico e pedidos em aberto usam todo o histórico.

Cartões de saúde da base

Três cartões que juntam os grupos por situação.

Botões e ações

‹grupo› · ‹n›: Cada etiqueta de grupo dentro do cartão destaca esse grupo no gráfico e na lista; clicar de novo tira o destaque.

Melhores clientes: fidelidade e retenção.
Com potencial: prontos para upsell.
Prioridade de atenção: risco de churn.
Cada cartão mostra o total de clientes e as etiquetas dos grupos que o compõem.

AGRUPAMENTOS RFV

O gráfico de bolhas Recência × Frequência + Valor, uma bolha por grupo.

Botões e ações

‹grupo›: ‹n› clientes: Cada bolha é clicável (ou Enter e espaço no teclado): destaca o grupo na lista; os outros ficam apagados.

Eixo horizontal: ← recente à esquerda, inativo → à direita.
Eixo vertical: Frequência + Valor ↑.
O tamanho da bolha é a quantidade de clientes; o número dentro dela também.
Grupos sem clientes não aparecem no gráfico.

Vendas

Os números de venda do período escolhido no cabeçalho.

Receita
Ticket médio
Pedidos
Recência média, em dias

PEDIDOS EM ABERTO

Quantos pedidos ainda não foram pagos e podem ser recuperados.

O total de pedidos em aberto e a linha recuperáveis · ticket médio ‹valor›.

GRUPOS

A lista dos oito grupos RFV com os números de cada um.

Botões e ações

Criar agente: Abre o diálogo do agente especialista daquele grupo, com a abordagem escrita pela IA. Fica apagado em grupo sem clientes.

Cada linha: a cor do grupo, o nome, a quantidade de clientes, ‹dias›d · ‹compras›x (recência e frequência) e o valor médio.
Em telas estreitas, recência, frequência e valor somem e o botão fica só com o ícone.

MAIS VENDIDOS

Os produtos que mais faturaram, quando os pedidos trazem os itens.

Posição, nome do produto e uma barra proporcional à receita.
Selo catálogo quando o produto está ligado ao catálogo da conta.
À direita: a receita, as unidades (un) e os pedidos (ped).

AGENTES ESPECIALISTAS

Os agentes já salvos, um por grupo, com o estado e as ações. Aparece só depois do primeiro agente salvo.

Botões e ações

DispararDono: Envia agora a primeira mensagem do agente para os leads daquele grupo. Manda mensagem de verdade e debita saldo. Mostra Disparando… enquanto envia e fica apagado com o agente pausado.
PausarDono: Botão de ícone (dica Pausar) que pausa o agente; com ele pausado, a dica vira Ativar e o botão o liga de novo.

Nome do agente, o objetivo e quantos disparos já fez.
Selo Ativo ou Pausado.
Depois de disparar, um aviso mostra o resultado do envio.

Diálogo Importar pedidos

Envia a planilha CSV de pedidos que alimenta o RFV; cada pedido é casado com um contato por telefone ou e-mail.

Botões e ações

Arraste o CSV ou clique para escolher: Área de envio: solte o arquivo ou clique para escolher. Mostra Importando… durante o envio. Aceita só arquivo .csv.
Baixar modelo de CSV: Baixa uma planilha de exemplo com as colunas na ordem certa.
Importar outro arquivo: Depois do resultado, volta para a área de envio.
Fechar: Fecha o diálogo; depois de uma importação, o botão diz Concluir.

Colunas esperadas: telefone/e-mail · id do pedido · valor · data · status.
Aviso fixo: Reimportar não duplica (idempotente por id do pedido).
Resultado: Importados, Atualizados e Clientes, e a frase ‹n› pedido(s) no RFV, de ‹n› linha(s).
Se nenhum pedido casar: Nenhum pedido casou com um contato existente.
Linhas ignoradas: a contagem e a lista com o número da linha e o motivo.
Falha: o quadro vermelho A importação não foi concluída, com o motivo.

Diálogo Agente especialista · ‹grupo›

A IA redige a abordagem para o grupo; você escolhe o objetivo, confere e ativa.

Botões e ações

Fidelização: Reescreve a abordagem para manter quem já é bom cliente.
Upsell e expansão: Reescreve a abordagem para vender mais a quem já compra.
Reativação: Reescreve a abordagem para chamar de volta quem parou.
Retenção (anti-churn): Reescreve a abordagem para segurar quem está prestes a sair.
Copiar: Copia a primeira mensagem para a área de transferência.
Fechar: Fecha sem salvar.
Salvar e ativar agenteDono: Salva a estratégia e a primeira mensagem e deixa o agente ativo na lista de Agentes especialistas. Mostra Ativando… enquanto salva.

Ao abrir, a IA já escreve com o objetivo sugerido para o grupo, que vem marcado.
Estratégia: o plano da abordagem.
Primeira mensagem: o texto que o lead recebe; {nome} é trocado pelo nome de cada lead no disparo.
Cuidados (guardrail · LGPD): os cuidados que a mensagem respeita.
Enquanto escreve, aparece A IA está redigindo a abordagem….

Estados da tela

Carregando: Dois blocos cinza no lugar do cabeçalho e do gráfico.
Sem nada ainda: Sem nenhum pedido, a tela mostra Traga suas vendas para o Monitor, o botão Importar pedidos, três dicas (Grupos automáticos, Agentes por grupo, Vendas a recuperar) e o atalho Integrações para receber os pedidos do seu sistema automaticamente.
Se der erro: Não foi possível carregar o monitor, avisando que isso não quer dizer que não há clientes em risco e que clientes e pedidos continuam salvos, com o botão Tentar de novo.

Passo a passo

Como importar pedidos por planilha CSV

Garanta que os clientes já existem como contatos, com telefone ou e-mail iguais aos da planilha.
No Monitor de sucesso, clique em Importar pedidos.
Se precisar, clique em Baixar modelo de CSV e preencha em cima dele.
Arraste o arquivo para Arraste o CSV ou clique para escolher.
Confira Importados, Atualizados e as linhas ignoradas, e clique em Concluir.

Como criar um agente de reativação para um grupo de clientes

Na lista GRUPOS, clique em Criar agente na linha do grupo.
Escolha o objetivo, por exemplo Reativação; a IA reescreve a abordagem.
Leia a estratégia, a primeira mensagem e os cuidados.
Clique em Salvar e ativar agente (só o dono).

Como disparar o agente especialista para um grupo

Em AGENTES ESPECIALISTAS, confira se o agente está Ativo.
Clique em Disparar: a mensagem sai de verdade e debita o saldo.
Leia o aviso com o resultado e acompanhe as respostas no Inbox.

Como pausar um agente especialista

Em AGENTES ESPECIALISTAS, ache a linha do agente.
Clique no botão de pausa (dica Pausar); o selo muda para Pausado e Disparar fica apagado.
Para voltar, clique no mesmo botão, agora com a dica Ativar.

Como exportar os grupos RFV para uma planilha

Escolha o período das vendas no cabeçalho.
Clique em Baixar relatório.
Abra o arquivo baixado: uma linha por grupo e, abaixo, as vendas e os pedidos em aberto.

Perguntas frequentes

Quem pode salvar e disparar um agente especialista?

Só o dono da conta salva e ativa o agente, dispara e pausa. Administradores importam pedidos e podem ver o rascunho da abordagem.

O que é RFV no Monitor de sucesso?

É a combinação de recência (há quanto tempo foi a última compra), frequência (quantas compras) e valor (quanto o cliente gastou). Os grupos saem dessa combinação.

Abrir o Criar agente já envia mensagem?

Não. O diálogo só escreve o rascunho. Nada é enviado até o agente ser salvo e alguém clicar em Disparar.

Dá para receber os pedidos sem planilha?

Sim. Pelo atalho Integrações, o seu sistema de vendas ou loja virtual manda os pedidos sozinho, e o Monitor se atualiza com eles.

O que o relatório baixado traz?

Uma planilha com cada grupo (clientes, recência, frequência e valor médio) e, abaixo, as vendas do período escolhido, o ticket médio, a receita e os pedidos em aberto.

Por que o botão Criar agente está apagado em alguns grupos?

Porque o grupo está sem clientes. Sem ninguém para receber a mensagem, não há agente para criar.

O que acontece se eu mudar o objetivo no diálogo do agente?

A IA escreve de novo a estratégia e a primeira mensagem para o objetivo escolhido. Só a última versão é salva quando você ativa o agente.

Guia da Central de ajuda

Monitor de sucesso

Quem já comprou, separado em grupos: quem é campeão, quem está sumindo e quem precisa de um empurrão agora.

Todas as outras telas olham para quem está chegando. Esta olha para quem já comprou. Ela separa a sua base de clientes em grupos por comportamento de compra e diz, para cada grupo, o que fazer: manter, crescer, chamar de volta ou deixar quieto.

A decisão daqui é onde colocar a sua atenção de pós-venda nesta semana. Quase sempre a resposta está no card Prioridade de atenção: quem gastou bem com você e está esfriando vale mais que dez leads novos.

A tela por partes

Na tela: Monitor de sucesso com três cards de saúde no topo, o gráfico de agrupamentos, o card de vendas, os pedidos em aberto e a lista de grupos. Oito clientes e doze pedidos importados.

Este seletor muda um card só: 7 / 30 / 90 dias mexe apenas no card de vendas (receita, ticket médio, número de pedidos, recência média). Os grupos, o gráfico, a lista de grupos e os pedidos em aberto usam todo o histórico, sempre. A tela não avisa isso em lugar nenhum.
Importar pedidos e Baixar relatório: Importar pedidos é de onde vem tudo o que você vê aqui. Baixar relatório exporta os grupos e as vendas em planilha, para levar para uma reunião ou para o contador.
Os três cards de saúde: Eles juntam os oito grupos em três leituras: Melhores clientes (Campeões + Leais), Com potencial (Potencialmente leais + Recentes) e Prioridade de atenção (Precisam de atenção + Não podem ser perdidos + Em risco). Onde a tela escreve prontos para upsell, leia prontos para comprar mais; onde escreve risco de churn, leia risco de parar de comprar. O grupo Perdidos não entra em card nenhum.
O mapa dos grupos: Cada bolha é um grupo e o tamanho dela é quanta gente tem dentro. Da esquerda (recente) para a direita (inativo) é há quanto tempo compraram; para cima é comprar mais vezes. Bolha grande à direita e embaixo é dinheiro indo embora.
Vendas e pedidos em aberto: Vendas é o único bloco que obedece ao seletor de dias: receita, ticket médio (quanto rende um pedido, em média), quantidade de pedidos e recência média (há quantos dias, em média, foi a última compra). Pedidos em aberto é dinheiro no meio do caminho: pedido que existe e não foi pago.
Grupos, e o botão que gasta: Cada grupo com quanta gente tem, há quantos dias compraram e quanto valem. Criar agente monta a abordagem para aquele grupo — e disparar dali envia mensagem de verdade e debita saldo. É a ação mais cara desta tela.

Os oito grupos e o que fazer com cada um

Campeões: Compram muito, com frequência e faz pouco tempo. Não venda nada: peça indicação e depoimento. É a sua reserva.
Leais: Voltam sempre, mesmo gastando menos. Aqui a conta fecha com condição para quem é de casa e com novidade em primeira mão.
Potencialmente leais: Compraram há pouco e já repetiram alguma vez. É o grupo com maior retorno por mensagem enviada: falta pouco para virarem Leais.
Recentes: Chegaram agora, quase sempre com uma compra só. O que decide o futuro deles é o pós-venda das primeiras semanas, não desconto.
Precisam de atenção: Eram bons e estão espaçando as compras. É o momento barato de agir — mais tarde eles viram Em risco.
Não podem ser perdidos: Gastaram muito e sumiram. Cada nome aqui vale uma ligação de gente, não uma mensagem automática.
Em risco: Compravam com alguma constância e pararam. Vale uma oferta de volta com prazo.
Perdidos: Faz muito tempo, valor baixo. Não gaste aqui todo mês. Uma tentativa de reativação por trimestre é honesto; mais que isso é queimar saldo.

Como o grupo de cada cliente é decidido

A tela chama isso de agrupamentos RFV, que é o apelido de três perguntas: R de recência (há quantos dias foi a última compra), F de frequência (quantas compras ao todo) e V de valor (quanto essa pessoa já gastou).

Cada uma das três vira uma nota de 1 a 5, e é aqui que mora a parte que confunde: a nota sai da comparação com o resto da sua base, não de uma faixa fixa. É ranking.

Só pedido pago entra na classificação. É ele que forma os grupos, o gráfico e a lista de grupos.
Pedido em aberto não classifica ninguém: alimenta apenas o card de pedidos em aberto, que é a sua lista de cobrança.
Pedido cancelado é ignorado por completo, como se não existisse.

O seletor de dias engana

Vale repetir fora do print, porque é o erro de leitura mais comum daqui: trocar entre 7, 30 e 90 dias muda somente o card de vendas. Gráfico, lista de grupos e pedidos em aberto continuam calculados sobre todo o histórico de compras.

Na prática: você clica em 7 dias, vê a receita despencar e conclui que perdeu clientes. Não perdeu — a receita é da semana e os grupos são de sempre. Compare receita com receita, e olhe os grupos como o retrato da base inteira.

Importar os seus pedidos

Importe os contatos antes: Cada pedido é casado com um contato por telefone ou e-mail. Se o contato não existir, a linha é descartada em silêncio. Comece pela Base de contatos e só depois volte aqui.
Baixe o modelo de CSV: O botão Baixar modelo de CSV entrega o arquivo com as colunas certas na ordem certa. Preencher em cima do modelo evita metade dos problemas.
Confira a coluna de situação do pedido: É a coluna que decide se o pedido conta como venda. Preencha todas as linhas: pago, em aberto ou cancelado.
Respeite os limites do arquivo: Só .csv, no máximo 5 MB e 50.000 linhas. Planilha maior, divida em duas — importar duas vezes não é problema.
Importe e confira o cabeçalho da tela: No topo aparece a origem dos dados e quantos clientes e pedidos existem. Se o número de pedidos veio muito menor que o do arquivo, foram linhas descartadas por contato inexistente.

Criar agente para um grupo

Na lista de grupos, Criar agente abre um diálogo onde a abordagem é escrita para aquele grupo específico. Você escolhe o objetivo, e é o objetivo que muda o tom e o pedido da conversa:

Fidelização: Manter quem já é bom. Serve para Campeões e Leais, sem oferta agressiva.
Upsell e expansão: Vender mais para quem já compra. Combina com Potencialmente leais e com Campeões que ainda só usam uma parte do que você vende.
Reativação: Chamar de volta quem parou. É o caminho de Em risco e de Perdidos.
Retenção (anti-churn): Segurar quem está prestes a sair — churn é quando o cliente para de comprar de vez. É o objetivo de Precisam de atenção e Não podem ser perdidos.

Quando os números não batem

Importei e continua zerado: os contatos não existiam. Suba a Base de contatos primeiro e reimporte o mesmo arquivo — ele não vai duplicar nada.
A receita ficou absurda: procure situação em branco na planilha. Corrija a coluna e reimporte por cima; a importação atualiza os pedidos existentes.
Faltam clientes que eu sei que compraram: o telefone ou o e-mail da planilha está diferente do cadastrado no contato. É por esses dois campos que o casamento acontece.
A receita caiu de repente: confira o seletor de dias antes de qualquer coisa. Ele é o culpado na maioria das vezes.
Mudou muita gente de grupo de uma vez: entrou um lote grande de pedidos e as comparações se refizeram. Olhe o total de clientes e pedidos no topo.

Para levar isso para fora da tela, Baixar relatório exporta os grupos e as vendas em planilha. Para falar com um grupo grande, sem o teto de 20, o caminho é Campanhas.

No painel: Abrir o Monitor de sucesso