## Visão geral

A plataforma mede o **consumo mensal** da conta em cinco métricas: mensagens, conversas, contatos,
requisições de IA e tokens de IA. Os totais ficam disponíveis para a conta, para o operador e por
API — base para planos por consumo e alertas de limite.

## Pré-requisitos

- Medição habilitada na conta pelo operador (recurso de medição de uso).
- Limites mensais são opcionais e definidos pelo operador por conta.

## Passo a passo

1. **Na conta**: acompanhe os totais do mês e o histórico recente na área de uso da conta.
2. **No operador**: consulte o consumo de qualquer conta no console administrativo ou via API de
   plataforma (`GET /platform/api/v1/accounts/{id}/usage`).
3. **Limites**: o operador define tetos mensais por métrica (ex.: mensagens por mês) nos limites da
   conta.

## Configurações & opções

- **Métricas**: `messages`, `conversations`, `contacts`, `ai_requests`, `ai_tokens` — agregadas por
  mês-calendário.
- **Limites mensais**: configurados por métrica (`<métrica>_monthly`). Sem limite configurado, a
  medição apenas acumula.
- **Alertas**: ao cruzar **80%** e **100%** do limite, a instalação recebe um evento de webhook —
  uma única vez por métrica, por mês.

## Casos de uso

- Vender planos com franquia mensal de mensagens e receber alerta automático ao atingir o teto.
- Acompanhar o custo de IA por conta antes de definir preços por consumo.

## Dicas, limites e boas práticas

- A medição é tolerante a falhas: nunca bloqueia o fluxo de mensagens — mesmo se o armazenamento de
  contadores falhar, o atendimento continua.
- Os alertas de 80%/100% são informativos: nesta versão não há bloqueio automático de consumo.
- Zere expectativas de cobrança retroativa: a contagem começa quando a medição é ativada.

## Solução de problemas

- **Uso não aparece na conta**: o recurso de medição está desligado para a conta.
- **Alerta não chegou**: confirme a URL de webhook de eventos da instalação e se o limite mensal da
  métrica está configurado.

## Veja também

- Maestro & IA: configuração e saúde da integração
- Tokens de IA por conta (BYOK)
- Super Admin: contas, planos e licença