openthorDocumentação

get_coverage_by_city

Cobertura por município · domínio Clientes · escopo mcp:customers

O que faz

Cobertura por município: clientes cadastrados, ativos (12m), taxa de positivação e valor. Use para 'em quais cidades tenho mais clientes/cobertura?'.

Exemplo de pergunta

em quais cidades tenho mais clientes/cobertura?” — 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 (registered · active · value)nãoregistered

O que você recebe

  • registered — Cadastrados
  • active — Ativos
  • positivacao_pct — Positivação (%)
  • value — Faturamento (R$)

Cuidados ao ler o resultado

Leia antes de interpretar
  • Agrupado por CODMUNICIPIO (não pelo texto livre do município).

Por trás da ferramenta

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