openthorDocumentação

get_positivacao_by_supervisor

Positivação por supervisor (equipe) · domínio Clientes · escopo mcp:customers

O que faz

Positivação por SUPERVISOR: clientes positivados no mês sobre a base ativa (12m) da carteira da equipe, com a taxa (%). Use para 'qual a positivação da equipe do supervisor X?'.

Exemplo de pergunta

qual a positivação da equipe do supervisor X?” — 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 (taxa_pct · active_base · positivados)nãotaxa_pct
include_pseudo_repsbooleannãofalse

O que você recebe

  • active_base — Base ativa (12m)
  • positivados — Positivados no mês
  • taxa_pct — Positivação (%)

Cuidados ao ler o resultado

Leia antes de interpretar
  • Modelo CARTEIRA (base ativa 12m × positivados no mês) — o MESMO do get_positivacao_by_rep; não misturar com 'clientes compradores' do by-supplier (grão movimento).
  • Atribuição pelo ROSTER ATUAL (ADR-0023); supervisor_code NULO = carteiras de RCAs sem supervisor no roster.
  • Supervisores incluem buckets de canal (unidades, não pessoas).

Por trás da ferramenta

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