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
- Na conta: acompanhe os totais do mês e o histórico recente na área de uso da conta.
- No operador: consulte o consumo de qualquer conta no console administrativo ou via API de
plataforma (
GET /platform/api/v1/accounts/{id}/usage). - 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