openthorDocumentação

find_inactive_customers

Clientes inativos (carteira em risco) · domínio Clientes · escopo mcp:customers

O que faz

Clientes sem comprar há N dias (padrão 90), com última compra, dias inativos e valor de 12 meses — a carteira em risco. Filtre por RCA. Use para 'quem parou de comprar?'.

Exemplo de pergunta

quem parou de comprar?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
inactive_daysinteger (1–…)não90
rep_codeintegernão
topinteger (1–200)não50

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
  • Inativo = última compra há N+ dias. Clientes que nunca compraram não entram (sem recência).

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.