## Visión general

La plataforma mide el **consumo mensual** de la cuenta en cinco métricas: mensajes, conversaciones,
contactos, solicitudes de IA y tokens de IA. Los totales están disponibles para la cuenta, para el
operador y por API — la base para planes por consumo y alertas de límite.

## Requisitos previos

- Medición habilitada en la cuenta por el operador (capacidad de medición de uso).
- Los límites mensuales son opcionales y los define el operador por cuenta.

## Paso a paso

1. **En la cuenta**: sigue los totales del mes y el historial reciente en el área de uso de la
   cuenta.
2. **Como operador**: consulta el consumo de cualquier cuenta en la consola administrativa o vía la
   API de plataforma (`GET /platform/api/v1/accounts/{id}/usage`).
3. **Límites**: el operador define techos mensuales por métrica (p. ej., mensajes por mes) en los
   límites de la cuenta.

## Configuración y opciones

- **Métricas**: `messages`, `conversations`, `contacts`, `ai_requests`, `ai_tokens` — agregadas por
  mes calendario.
- **Límites mensuales**: configurados por métrica (`<métrica>_monthly`). Sin límite configurado, la
  medición solo acumula.
- **Alertas**: al cruzar el **80%** y el **100%** del límite, la instalación recibe un evento de
  webhook — una única vez por métrica, por mes.

## Casos de uso

- Vender planes con franquicia mensual de mensajes y recibir alerta automática al llegar al techo.
- Seguir el costo de IA por cuenta antes de definir precios por consumo.

## Consejos, límites y buenas prácticas

- La medición es tolerante a fallas: nunca bloquea el flujo de mensajes — incluso si el
  almacenamiento de contadores falla, la atención continúa.
- Las alertas de 80%/100% son informativas: esta versión no bloquea el consumo automáticamente.
- Sin conteo retroactivo: la medición empieza cuando se habilita.

## Solución de problemas

- **El uso no aparece en la cuenta**: la capacidad de medición está apagada para la cuenta.
- **La alerta no llegó**: confirma la URL del webhook de eventos de la instalación y que el límite
  mensual de la métrica esté configurado.

## Ver también

- Maestro & IA: configuración y salud de la integración
- Tokens de IA por cuenta (BYOK)
- Super Admin: cuentas, planes y licencia