openthorDocumentação

get_customer_rfm

RFM por cliente (recência, frequência, valor) · domínio Clientes · escopo mcp:customers

O que faz

Clientes ordenados por valor (monetário) em 12 meses, com última compra (recência), nº de NFs e meses ativos (frequência). Use para 'meus clientes mais valiosos' ou análise RFM.

Exemplo de pergunta

meus clientes mais valiosos” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
topinteger (1–500)não50
order_bystring (value_12m · invoices_12m · last_purchase_at)nãovalue_12m

O que você recebe

  • customer_code — Cliente (cód.)
  • name — Nome
  • rep_code — Vendedor (RCA)
  • last_purchase_at — Última compra
  • days_inactive — Dias sem comprar
  • value_12m — Faturamento 12m (R$)
  • invoices_12m — Notas 12m
  • months_active_12m — Meses ativos (12m)

Cuidados ao ler o resultado

Leia antes de interpretar
  • Valor/frequência consideram 12 meses (vendas, exclui bonificação). Recência = última compra faturada.

Por trás da ferramenta

Esta ferramenta consulta o endpoint /v1/customer-metrics da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.