- Hacer seguimiento del uso de créditos en tu workspace y por usuario individual.
- Monitorizar el pool de créditos de tu workspace y los límites por miembro.
- Supervisar la actividad de los usuarios e identificar cuentas inactivas.
- Auditar los ajustes de seguridad de las apps.
- Analizar la interacción mediante vistas, usuarios activos y tendencias de uso.
Workspaces
Un workspace es un entorno compartido donde los equipos colaboran en apps. La API de monitorización ofrece a los propietarios y administradores del workspace datos agregados sobre los usuarios y las apps de un workspace específico.ID del workspace
La mayoría de los endpoints requieren unworkspace_id en la ruta de la URL, y debes tener el rol de administrador o propietario en ese workspace para acceder a ellos.
Para obtener tu workspace_id, ve a la página de gestión de tu workspace:
- Haz clic en el icono de tu perfil arriba a la derecha de tu cuenta.
- Pasa el cursor sobre el workspace correspondiente y haz clic en Manage.
- El ID del workspace es la última parte de la URL de la página de gestión del workspace.
Pools de créditos y límites por miembro
Tu workspace comparte un único pool de créditos por cada periodo de reinicio. El pool registra por separado los créditos de mensajes y los créditos de integración, y cada uno informa de su límite, la cantidad usada y la restante. El periodo de reinicio coincide con el que se muestra en tu página de facturación. En las suscripciones anuales que se reinician mensualmente, este es el periodo mensual. La respuesta deGet analytics devuelve estos datos en el objeto credit_pool, incluyendo tu nivel, los límites diarios de mensajes, los créditos bonus, el saldo de tarjeta regalo y los indicadores de exceso de límite.
Los workspaces también pueden establecer límites de créditos por miembro sobre cuántos créditos de mensajes usa cada miembro del pool compartido. El límite de un miembro proviene de una anulación individual o de un valor por defecto del workspace. El objeto member_allocations en la respuesta de analytics resume estos límites en tu workspace, y el objeto member_allocation de cada usuario en Get user informa del límite y el uso individuales de un miembro.
Los límites de créditos por miembro dependen del nivel de tu workspace. Cuando tu nivel no los admite, los miembros consumen del pool sin un límite individual y los campos por miembro devuelven
null.Flujos de ejemplo
Aquí tienes algunas formas habituales de usar la API de monitorización.Comparar el uso mensual
1
Obtener analítica del mes actual
Llama a
Get analytics con el
rango de fechas de este mes para obtener el consumo actual de créditos y la
actividad de usuarios.2
Obtener analítica del mes anterior
Llama a
Get analytics de nuevo
con el rango de fechas del mes anterior para comparar tendencias.Analizar la actividad de los usuarios
1
Listar usuarios
Llama a
List users para obtener todos
los usuarios con datos de consumo resumidos del periodo de facturación
actual.2
Obtener usuario
Llama a
Get user para obtener los datos
de consumo de un usuario específico en un rango de fechas personalizado.Encontrar miembros que superan su límite de créditos
1
Listar usuarios que superan su límite
Llama a
List users con
over_member_limit=true para obtener solo los miembros que han superado su
límite de créditos por miembro en el periodo de reinicio actual.2
Obtener el detalle de la asignación del miembro
Llama a
Get user para un miembro
específico y ver su member_allocation, incluyendo el límite, el origen
del límite y los créditos restantes.Auditar una app
1
Listar usuarios
Llama a
List users para encontrar
usuarios en tu workspace.2
Listar las apps del usuario
Llama a
List user apps para
obtener los IDs de las apps de un usuario específico.3
Obtener analítica de la app
Llama a
Get app analytics para
obtener métricas detalladas e indicadores de gobernanza de la app.Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.