Estadísticas de uso
Los endpoints de estadísticas te permiten monitorear el consumo de Platica desde sistemas externos: periodo de facturación, mensajes usados, conversaciones, tasa de autonomía, tipos de mensajes y actores que generan consumo.
Endpoints disponibles
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/usage/period | Consultar el periodo de facturación activo |
GET | /v1/usage/summary | Obtener un resumen de consumo y autonomía |
GET | /v1/usage/messages | Consultar mensajes por tipo, canal, categoría, campaña o estatus |
GET | /v1/usage/conversations | Consultar conversaciones, asistencia y autonomía |
GET | /v1/usage/actors | Consultar consumo por actor |
Frescura de datos
Los mensajes se leen desde agregados actualizados por cada transacción. Incluyen dos universos: volumen total (all) y mensajes que se cobran (billable), normalmente con desfase de segundos. Las conversaciones y la tasa de autonomía dependen de agregados horarios, por lo que pueden tener hasta ~60 minutos de desfase. Cada respuesta incluye un objeto freshness con la última actualización disponible.
Workspaces enterprise
En workspaces con billingType: "enterprise", Platica conserva credits (los del workspace) pero omite creditsUsed y los campos de costo. La facturación enterprise usa tarifas personalizadas por cliente, así que el monitoreo se hace con conteos totales, facturables y no facturables. Enterprise siempre usa agregados, incluso si se solicita mode=full.