Calidad de Servicio de la Suscripción (Quality of Service Subscription, QSS) Explicación

Calidad de Servicio de la Suscripción (Quality of Service Subscription, QSS) es un add-on product que entrega datos de reunión, seminario web y QoS de teléfono a un punto de conexión de terceros de un cliente.

Calidad de Servicio de la Suscripción (Quality of Service Subscription, QSS) es un producto add-on que transmite datos de telemetría de Calidad de servicio (QoS) casi en tiempo real para Zoom Meetings, Webinars y Zoom Phone mediante suscripciones de Evento

La Calidad de Servicio de la Suscripción (QSS) de Zoom es un producto add-on que ofrece datos de Calidad de servicio (QoS) casi en tiempo real para Zoom Meetings, Webinars y llamadas telefónicas. QSS amplía la funcionalidad del producto de Zoom al enviar eventos de QoS a nivel de participante en intervalos a nivel de minuto (la tasa y la agregación pueden variar según la configuración). Clientes pueden usar este flujo de datos enriquecido para identificar si los entornos de red están afectando los servicios de Zoom.

(QSS) entrega las mismas métricas de QoS subyacentes usadas en Zoom Dashboards y APIs, pero el muestreo y la temporización difieren

Lo existente Zoom Panel de control proporciona métricas de rendimiento y uso de la red, que pueden ayudar a Clientes a entender cómo Zoom está funcionando en un entorno de red. QSS ofrece los mismos datos QoS de Zoom, pero a una tasa más rápida. Debido a este muestreo a mayor velocidad, las métricas agregadas de QoS mostrarán valores diferentes a los del Panel de control principal de Zoom. Sin embargo, estas métricas aún permiten que Clientes las Configure en sus propias vistas del Panel de control para correlacionar los datos de Zoom con sistemas adicionales.

La tabla siguiente describe los datos de QoS entregados a los endpoints de un cliente mediante (QSS).

	QoS Datos entregados mediante (QSS)
Métricas de calidad	Tasa de bits, latencia, fluctuación, pérdida de paquetes, resolución, velocidad de fotogramas, uso de CPU
Métricas de uso	Dispositivo, Red, Región de señalización, Versión del cliente, audio (E/S), Vídeo (E/S)
Frecuencia	Aprox. 1 Evento por minuto, por participante (por métrica de QoS o conjunto agregado según la Configuración de la cuenta).
Retención de datos	Los registros de entrega de Evento se conservan durante 7 días a través de la API de registros de webhook; los datos históricos de QoS mediante endpoints de API pueden conservarse durante más tiempo (según la licencia).

Los datos del Panel de control de Zoom no deben compararse con los datos entregados mediante (QSS) a un punto de conexión de terceros de un cliente

(QSS) y el Zoom Panel de control proporcionan dos mecanismos independientes para acceder a los datos de Zoom QoS que no deberían compararse. Aunque el Zoom Panel de control y (QSS) obtienen del mismo conjunto de datos de QoS, los datos de cada mecanismo no coincidirán debido a las diferencias en el momento de la recuperación y la frecuencia de entrega de los datos.

(QSS) supports real-time Evento data for Meetings, Webinars, and Phone calls

(QSS) proporciona datos de eventos de QoS para todos los usuarios de una cuenta en Zoom Meetings y Webinars, así como para llamadas de Zoom Phone. Debido a que Zoom no gestiona el tramo final de las llamadas, (QSS) solo proporciona datos de eventos de QoS a nivel de cuenta para llamadas de Zoom Phone y, por lo tanto, no puede proporcionar visibilidad completa de los datos avanzados de participante de extremo a extremo.

Los datos de (QSS) no incluyen datos para Participantes externos

(QSS) no proporciona datos para Participantes de reunión externos. Sin embargo, QSS puede ayudar a identificar qué Participante de reunión interno tuvo un problema y cuál era ese problema, así como las métricas de calidad y uso que Clientes necesitarán para solucionar problemas.

(QSS) permite Clientes traer datos sin procesar de QoS desde Zoom Panel de control a sus flujos de trabajo existentes

Mientras los Clientes de Zoom han podido, históricamente, usar herramientas como el Panel de control de Zoom o APIs para ver o recuperar datos de Zoom QoS, QSS le permite transmitir la telemetría de Zoom QoS a sus plataformas de administración de red y supervisión mediante suscripciones de Evento (webhook o WebSocket).

(QSS) entrega eventos de QoS casi en tiempo real a los endpoints a los que te has suscrito, reduciendo el sondeo del API y el impacto de los límites de velocidad

(QSS) Clientes pueden suscribirse a eventos de QoS en tiempo real y a datos que se enviarán a sus puntos finales de aplicación, lo que ayuda a liberar capacidad de API y a optimizar el uso de la red. (QSS) es una ampliación de la servicio webhook Estándar porque puede enviar datos brutos de QoS a un punto de conexión a una tasa de casi tiempo real de 4 a 6 veces por minuto.

(QSS) permite Clientes Acceso a datos de QoS casi en tiempo real desde Panel de control de Zoom sin superar los límites de frecuencia de API

Los servicios de API se basan en solicitudes y utilizan un mecanismo de «pull» para recopilar los datos solicitados por una aplicación o usuario. Las API consumen más recursos que los webhooks porque requieren llamadas repetidas para extraer datos de un punto de conexión de API.

Clientes que usan APIs de Zoom al extraer datos de QoS desde Panel de control may encounter rate limits, meaning that they’ve reached the maximum number of API calls they can make within a given time period. (QSS) no increase API rate limits, but it reduces Clientes’ rate-limit concerns by pushing raw QoS data to their endpoints instead of requiring Clientes to pull the data themselves.

(QSS) permite a Clientes consumir datos sin procesar de QoS de Zoom y solucionar problemas mediante su sistema preferido de gestión de red

Es posible que algunos Clientes necesiten evaluar el rendimiento de su red en varias aplicaciones a la vez. (QSS) les permite supervisar los datos de Zoom QoS en el Panel de control junto con otros datos en su conjunto de aplicaciones, proporcionando una forma flexible y escalable de consumir los datos de Zoom QoS e integrarlos sin problemas en Paneles de control personalizados.

Los datos de Zoom QoS se transmiten mediante TLS 1.2

Los datos de (QSS) se cifran en tránsito mediante TLS 1.2 o superior. Los puntos finales deben usar un certificado válido de una Autoridad de Certificación (CA). Las solicitudes de webhook incluyen un encabezado de firma y una comprobación desafío-respuesta para Verificación.

Para mayor seguridad, se solicitará a los Clientes que validar sus puntos finales webhook mediante una Verificación de Desafío-Respuesta (CRC). La CRC confirmará la propiedad y la seguridad de las URL de su punto de conexión de Notificación de Evento.

Clientes pueden comenzar a consumir datos de QoS creando una aplicación que puede recibir eventos QSS

Después de que un Cliente compra el plan add-on de (QSS), al menos un usuario de la cuenta debe tener habilitadas las permisos de desarrollador. Clientes pueden usar entonces los siguientes tres pasos para crear una aplicación webhook que pueda suscribirse a eventos de (QSS).

Los Clientes también pueden seguir el Paquete de desarrollador de Zoom con una opción QSS habilitada, que agrupa QSS con otras herramientas de desarrolladores.

1

Crear una aplicación de suscripción a Evento (OAuth general o de servidor a servidor). Habilitar las suscripciones de Evento y Seleccione eventos QoS

Los Clientes deben primero crear una aplicación OAuth General o de servidor a servidor en la Zoom App Marketplace. Luego, Habilitarían las Suscripciones de Evento y seleccionarían los eventos de QoS que desean recibir.

Siguiente, Clientes deben especificar el destino para las Notificaciónes de Evento de QSS introduciendo la URL del punto de conexión de notificación del Evento de su aplicación

No se requiere una aplicación solo webhook para esta configuración. Zoom recomienda crear una aplicación General.

2

Suscríbete a eventos de (QSS) webhook

Para suscribirse a eventos de (QSS), Clientes deben Añadir eventos y Seleccione de la lista de Disponible (QSS) Tipos de Evento. Clientes pueden seleccionar uno o más eventos (QSS) antes de completar el proceso y activar su aplicación.

También puedes gestionar las suscripciones a través de la interfaz de usuario de Marketplace o mediante llamadas a API:

• POST /Marketplace/aplicación/Evento_subscription – crear

• PATCH /{id} – suscribir usuarios/cuentas

• ELIMINAR /{id} – darse de baja/eliminar

• GET /Marketplace/aplicación/Evento_subscription – lista

Para autenticar vía API, usa un token del Client Credentials Grant.

3

Verificar eventos de webhook

Después de configurar las suscripciones de Evento, asegúrese de que tanto la propiedad de la URL del webhook como la autenticidad del Evento se validen correctamente.

• Validación de URL

  • Cuando Habilitar por primera vez las suscripciones de Evento, Zoom realiza una verificación de desafío-respuesta (CRC) para verificar la propiedad de tu punto de conexión webhook. Este proceso garantiza que Zoom esté enviando datos a un destino legítimo controlado por tu aplicación. (Puedes incluir el manejo de CRC en un paso de configuración anterior si lo prefieres.)

• Validación de Evento

  • Cada Notificación de Evento entrante debe ser Verificación por tu aplicación para confirmar que se originó en Zoom. La aplicación puede validar las solicitudes entrantes usando el encabezado de firma proporcionado en cada webhook Evento. Los desarrolladores que prefieran una alternativa al método de firma predeterminado pueden usar una de las otras opciones de Verificación admitidas descritas en los Zoom Developer Docs.

  • Utilice la API Get Webhook Logs para revisar hasta siete días de datos de entrega de webhook, incluido el estado, el recuento de reintentos y el ID de seguimiento.

Para obtener todos los detalles de implementación, consulte el Guía de implementación de (QSS) para desarrolladores. Para obtener detalles técnicos, consulte las guías de autenticación de Evento Subscription API, webhook Logs API y Client Credentials Grant en Zoom Developer Docs.