openthorDocumentação

get_portfolio_size_by_rep

Tamanho da carteira por RCA · domínio Clientes · escopo mcp:customers

O que faz

Tamanho da carteira por vendedor: total de clientes, ativos (compraram nos últimos 12m) e inativos. Use para 'quantos clientes cada RCA tem?'.

Exemplo de pergunta

quantos clientes cada RCA tem?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
topinteger (1–200)não50
order_bystring (portfolio_size · active_count · inactive_count)nãoportfolio_size
include_pseudo_repsbooleannãofalseIncluir RCAs pseudo (73 venda-direta, 2 órfão)

O que você recebe

  • portfolio_size — Tamanho da carteira
  • active_count — Clientes ativos
  • inactive_count — Clientes inativos

Cuidados ao ler o resultado

Leia antes de interpretar
  • RCAs pseudo (73 venda-direta, 2 órfão) excluídos por padrão — use include_pseudo_reps para vê-los.

Por trás da ferramenta

Esta ferramenta consulta o endpoint /v1/agg/customers/portfolio-by-rep da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.