get_churn_risk_by_rep
Carteira em risco por RCA (churn) · domínio Clientes · escopo mcp:customers
O que faz
Carteira em risco por vendedor: clientes inativos (sem comprar há 12m), taxa de churn (%), e o valor anual em risco (faturamento do ano anterior dos clientes que pararam). Use para 'onde estou perdendo clientes?'.
Exemplo de pergunta
“onde estou perdendo clientes?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
top | integer (1–200) | não | 50 | |
order_by | string (value_at_risk · inactive_count · churn_pct) | não | value_at_risk | |
include_pseudo_reps | boolean | não | false |
O que você recebe
total_customers— Total de clientesinactive_count— Clientes inativoschurn_pct— Churn (%)value_at_risk— Valor em risco (R$/ano)
Cuidados ao ler o resultado
Leia antes de interpretar
- Inativo = sem compra há 12 meses. value_at_risk = faturamento do ano anterior desses clientes.
- RCAs pseudo 73/2 excluídos por padrão.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/customers/churn-by-rep da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.
Esta página ajudou? Conte para a gente — lemos tudo.