Skip to main content
Quase todos os indicadores desta página saem de uma única rota: Clientes (CRM). Ela devolve o perfil de compra já calculado pela Repediu para cada cliente — não é preciso reconstruir histórico de pedidos para chegar nestes números. As exceções são a frequência de compra e a nota média de avaliação, que são indicadores de período e saem das rotas de pedidos e avaliações.
GET /customers não aceita from/to — é sempre a base completa da loja. Os indicadores calculados a partir dela refletem a base inteira, não um período filtrado.

​
Taxa de recompra

Pergunta: que fração da minha base já comprou mais de uma vez?
Requisição
Pagine com cursor/nextCursor até esgotar a base e conte:
Resposta (exemplo de item)

​
Frequência de compra

Pergunta: com que frequência (em compras por mês) os clientes compraram no período? Este indicador não sai de GET /customers: é calculado sobre os pedidos do período, via Listar pedidos — a mesma conta do dashboard da Repediu.
Requisição
Pagine até esgotar (page/total) e calcule:
O dashboard também tem a visão semanal: a conta é a mesma, trocando o divisor de meses por semanas = dias do período ÷ 7, arredondado para baixo.
createdFrom/createdTo filtram pela data da venda no fuso da loja. Para bater com o dashboard, envie o offset explícito e feche o dia final às 23:59:59 — createdTo=2026-08-31 (sem hora) corta à meia-noite e descarta o último dia inteiro.
O identifier do pedido é o mesmo id que o dashboard usa para contar clientes únicos — agrupando por ele, o resultado bate 1:1 com a tela de Frequência de Compra.

​
LTV médio

Pergunta: qual o valor médio gerado por cliente, considerando toda a base?
Divida pelo total da base, não só por quem tem purchaseCount > 1 — o objetivo é o valor médio por contato, e clientes de compra única devem puxar a média para baixo de propósito.

​
Clientes ativos

Pergunta: quantos clientes estão ativos (compraram recentemente)?
90 dias é a janela usada no nosso dashboard de referência, não um valor fixo da API — ajuste ao ciclo de recompra do seu negócio.

​
Segmentos (RFV)

Pergunta: como minha base está distribuída entre os grupos de RFV (campeões, fiéis, em risco…)? O campo rfvStatus vem em texto livre, com até 11 variações. Agrupe em macro-segmentos antes de exibir:
Normalize acentuação e caixa antes de comparar (rfvStatus.toLowerCase() sem acentos) — o texto é livre e pode variar.

​
Opt-in por canal

Pergunta: quantos clientes aceitam contato por WhatsApp ou e-mail?
Útil para estimar o alcance real de uma campanha antes de criá-la em Campanhas.

​
Satisfação (nota média de avaliação)

Pergunta: qual a nota média das avaliações no período? (a API não tem um campo de NPS — esta é a alternativa mais próxima)
Requisição
Se você buscar Avaliações com uma janela mais ampla que o período que vai exibir (por exemplo, para achar um mês de referência), refiltre os itens por ratingDate antes de calcular a média — a API não faz esse recorte por você além do from/to da chamada.