Explicación de la suscripción de calidad de servicio

La suscripción de Calidad de Servicio es un producto complementario que entrega datos de QoS de Reuniones, Seminarios web y Phone al endpoint de terceros de un cliente.

La Suscripción de Calidad de Servicio es un producto complementario que transmite telemetría de QoS casi en tiempo real para Zoom Meetings, Webinars y Zoom Phone mediante suscripciones a eventos

La Suscripción de Calidad de Servicio (QSS) de Zoom es un producto complementario 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 enviando eventos de QoS a nivel de participante en intervalos de un minuto (la frecuencia y agregación pueden variar según la configuración). Los clientes pueden usar esta rica transmisión de datos para identificar si los entornos de red están afectando los servicios de Zoom.

QSS entrega las mismas métricas subyacentes de QoS que se usan en los paneles (Dashboards) y APIs de Zoom, pero el muestreo y los tiempos difieren

El Panel de Zoom proporciona métricas de rendimiento de la red y de uso, que pueden ayudar a los clientes a comprender cómo está funcionando Zoom en un entorno de red. QSS ofrece los mismos datos de QoS de Zoom, pero a una velocidad más alta. Debido a esta mayor frecuencia de muestreo, las métricas agregadas de QoS mostrarán valores diferentes a los del Panel principal de Zoom. Sin embargo, estas métricas siguen permitiendo a los clientes configurarlas en sus propias vistas de panel para correlacionar los datos de Zoom con sistemas adicionales.

La tabla a continuación describe los datos de QoS entregados a los puntos finales de un cliente a través de QSS.

	Datos de QoS entregados a través de QSS
Métricas de calidad	Tasa de bits, Latencia, Jitter, Pérdida de paquetes, Resolución, Frecuencia de imagen, 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 eventos se conservan durante 7 días a través de la API Webhook Logs; los datos históricos de QoS a través de los endpoints de la API pueden persistir más tiempo (dependiendo de la licencia).

Los datos del Panel de Zoom no deben compararse con los datos entregados a través de QSS a un endpoint de terceros del cliente

QSS y el Panel de Zoom proporcionan dos mecanismos separados para acceder a los datos de QoS de Zoom que no deben compararse. Aunque el Panel de Zoom y QSS extraen del mismo conjunto de datos de QoS, los datos en cada mecanismo no coincidirán debido a las diferencias en el momento de recuperación y la frecuencia de entrega de datos.

QSS admite datos de eventos en tiempo real para Meetings, Webinars y llamadas telefónicas

QSS suministra datos de eventos de QoS para todos los usuarios de una cuenta en Zoom Meetings y Webinars, así como para llamadas de Zoom Phone. Dado que Zoom no gestiona la última etapa de las llamadas, QSS solo proporciona datos de eventos de QoS a nivel de cuenta para las llamadas de Zoom Phone y, por lo tanto, no puede ofrecer visibilidad completa en los datos avanzados de participantes de extremo a extremo.

Los datos de QSS no incluyen datos de participantes externos

QSS no proporciona datos para participantes externos de la reunión. Sin embargo, QSS puede ayudar a identificar qué participante interno tuvo un problema y cuál fue ese problema, así como las métricas de calidad y uso que los clientes necesitarán para solucionar incidencias.

QSS permite a los clientes llevar los datos brutos de QoS del Panel de Zoom a sus flujos de trabajo existentes

Si bien históricamente los clientes de Zoom han podido usar herramientas como el Panel de Zoom o las APIs para ver o recuperar datos de QoS de Zoom, QSS le permite transmitir la telemetría de QoS de Zoom a sus plataformas de gestión y supervisión de red mediante suscripciones a eventos (webhook o WebSocket).

QSS entrega eventos de QoS casi en tiempo real a sus endpoints suscritos, reduciendo el sondeo de API y el impacto de los límites de frecuencia

Los clientes de QSS pueden suscribirse a eventos y datos de QoS en tiempo real que se enviarán a los endpoints de su aplicación, lo que ayuda a liberar capacidad de API y optimizar la utilización de la red. QSS es una ampliación del servicio webhook estándar porque puede enviar datos brutos de QoS a un endpoint a una tasa casi en tiempo real de 4 a 6 veces por minuto.

QSS permite a los clientes acceder a datos de QoS casi en tiempo real del Panel de Zoom sin alcanzar los límites de frecuencia de la API

Los servicios de API se basan en solicitudes y usan un mecanismo de “pull” para recopilar los datos solicitados por una aplicación o usuario. Las APIs consumen más recursos que los webhooks porque requieren llamadas repetidas para extraer datos de un endpoint de API.

Los clientes que usan APIs de Zoom para extraer datos de QoS del Panel de Zoom pueden encontrarse con límites de frecuencia, lo que significa que han alcanzado el número máximo de llamadas API que pueden realizar en un periodo de tiempo determinado. QSS no aumenta los límites de frecuencia de la API, pero reduce las preocupaciones sobre dichos límites al enviar datos brutos de QoS a sus endpoints en lugar de requerir que los clientes extraigan los datos por sí mismos.

QSS permite a los clientes consumir datos brutos de QoS de Zoom y solucionar problemas usando su sistema de gestión de red preferido

Algunos clientes pueden necesitar evaluar el rendimiento de su red en varias aplicaciones a la vez. QSS les permite supervisar los datos de QoS de Zoom en un panel junto con otros datos de su suite de aplicaciones, proporcionando una forma flexible y escalable de consumir datos de QoS de Zoom e integrarlos sin problemas en paneles personalizados.

Los datos de QoS de Zoom se transmiten mediante TLS 1.2

Los datos de QSS se cifran en tránsito usando TLS 1.2 o superior. Los endpoints deben usar un certificado de una Autoridad de Certificación (CA) válido. Las solicitudes de webhook incluyen un encabezado de firma y una comprobación de reto-respuesta para la verificación.

Para una seguridad adicional, a los clientes se les solicitará validar sus endpoints de webhook utilizando una comprobación de reto-respuesta (CRC). El CRC confirmará la propiedad y la seguridad de las URL de sus endpoints de notificación de eventos.

Los clientes pueden comenzar a consumir datos de QoS creando una aplicación que pueda recibir eventos QSS

Después de que un cliente compre el plan complementario QSS, al menos un usuario de la cuenta debe tener habilitados los permisos de desarrollador. A continuación, los clientes pueden usar los tres pasos siguientes para crear una aplicación webhook que pueda suscribirse a eventos QSS.

Los clientes también pueden optar por el Paquete para desarrolladores de Zoom con una bandera QSS habilitada, que agrupa QSS con otras herramientas para desarrolladores.

1

Cree una aplicación de suscripción a eventos (OAuth general o Servidor a Servidor). Habilite las suscripciones a eventos y seleccione eventos de QoS

Los clientes deben crear primero una aplicación OAuth general o Servidor a Servidor en el Marketplace de aplicaciones de Zoom. Luego, habilitarían las suscripciones a eventos y seleccionarían los eventos de QoS que desean recibir.

A continuación, los clientes deben especificar el destino de las notificaciones de eventos QSS ingresando la URL del endpoint de notificación de eventos de su aplicación

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

2

Suscribirse a eventos Webhook de QSS

Para suscribirse a eventos QSS, los clientes deben agregar eventos y elegir de la lista de QSS disponibles Tipos de eventos. Los clientes pueden seleccionar uno o más eventos QSS antes de completar el proceso y activar su aplicación.

También puede administrar suscripciones a través de la IU del Marketplace o usando llamadas a la API:

• POST /marketplace/app/event_subscription – crear

• PATCH /{id} – suscribir usuarios/cuentas

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

• GET /marketplace/app/event_subscription – listar

Para autenticar mediante la API, utilice un token del Client Credentials Grant.

3

Verificar eventos Webhook

Después de configurar las suscripciones a eventos, asegúrese de que tanto la propiedad de la URL del webhook como la autenticidad del evento estén correctamente validadas.

• Validación de URL

  • Cuando habilita por primera vez las suscripciones a eventos, Zoom realiza una comprobación de reto–respuesta (CRC) para verificar la propiedad de su endpoint de webhook. Este proceso garantiza que Zoom esté enviando datos a un destino legítimo controlado por su aplicación. (Puede incluir el manejo del CRC en un paso de configuración anterior si lo prefiere).

• Validación de eventos

  • Cada notificación de evento entrante debe ser verificada por su 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 evento de webhook. Los desarrolladores que prefieran una alternativa al método de firma predeterminado pueden usar una de las otras opciones de verificación compatibles descritas en la documentación para desarrolladores de Zoom.

  • Use 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 rastreo.

Para obtener detalles completos de implementación, consulte la Guía de implementación de QSS para desarrolladores. Para detalles técnicos, consulte la API de suscripción a eventos, la API Webhook Logs y las guías de autenticación Client Credentials Grant en la documentación para desarrolladores de Zoom.