get_active_base_trend
Tendência da base ativa de clientes · domínio Clientes · escopo mcp:customers
O que faz
Evolução do nº de clientes que compraram por período (a base ativa), com NFs e valor — em meses (padrão), semanas ou dias. Use para 'quantos clientes compraram por mês?' ou 'a base ativa está crescendo?'.
Exemplo de pergunta
“quantos clientes compraram por mês?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
from | data (YYYY-MM-DD) | sim | — | Início do período (YYYY-MM-DD) |
to | data (YYYY-MM-DD) | sim | — | Fim do período (inclusivo) |
bucket | string (month · week · day) | não | month | Granularidade da série |
O que você recebe
period— Períodoactive_customers— Clientes ativos no períodoinvoices— Notas (qtde)value— Faturamento (R$)
Cuidados ao ler o resultado
Leia antes de interpretar
- Cliente ativo no período = comprou ao menos uma vez naquele período (distinto por código de cliente).
- O período corrente costuma estar parcial — a contagem do período em andamento ainda vai subir.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/customers/active-base-trend 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.