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
- En la cuenta: sigue los totales del mes y el historial reciente en el área de uso de la cuenta.
- 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). - 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