# 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 producto add-on que transmite 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 (Quality of Service Subscription, QSS) de Zoom es un producto add-on que ofrece datos de near real-time Calidad de servicio (QoS) para Zoom Meetings, Webinars y llamadas telefónicas. QSS amplía la funcionalidad del producto de Zoom enviando eventos de Calidad de servicio (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 avanzado para identificar si los entornos de red están afectando los servicios de Zoom.

#### <mark style="color:azul;">(QSS) ofrece las mismas métricas de QoS subyacentes que se usan en Zoom Dashboards y APIs, pero el muestreo y la temporización difieren</mark>

La existente [Zoom Panel de control](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) proporciona métricas de rendimiento y uso de la red, que pueden ayudar a Clientes a comprender cómo Zoom funciona en un entorno de red. QSS ofrece los mismos datos de Zoom QoS, pero a una tasa más rápida. Debido a esta tasa de muestreo más rápida, las métricas agregadas de QoS mostrarán valores diferentes de los del Panel de control principal de Zoom. Sin embargo, estas métricas aún permiten a Clientes configurarlas en sus propias vistas del panel de control para correlacionar los datos de Zoom con sistemas adicionales.

La tabla de abajo describe los datos de QoS entregados a los endpoints de un cliente a través de (QSS).

<table><thead><tr><th width="230"></th><th>QoS Datos entregados mediante (QSS)</th></tr></thead><tbody><tr><td>Métricas de calidad</td><td>Tasa de bits, latencia, fluctuación, pérdida de paquetes, resolución, velocidad de fotogramas, uso de CPU</td></tr><tr><td>Métricas de uso</td><td>Dispositivo, Red, Región de señalización, Versión del cliente, audio (E/S), Vídeo (E/S)</td></tr><tr><td>Frecuencia</td><td>Aprox. 1 Evento por minuto, por participante (por métrica de QoS o conjunto agregado según la Configuración de la cuenta).</td></tr><tr><td>Retención de datos</td><td>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 a través de endpoints de API pueden persistir más tiempo (según la licencia).</td></tr></tbody></table>

#### <mark style="color:azul;">Los datos del Panel de control de Zoom no deben compararse con datos entregados a través de (QSS) a un punto de conexión de un tercero del cliente</mark>

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

#### <mark style="color:azul;">(QSS) admite datos de eventos en tiempo real para Reuniones, Webinars y llamadas telefónicas</mark>

(QSS) proporciona datos de eventos de QoS para todos los usuarios en una cuenta para Zoom Meetings y Webinars, así como para llamadas de Zoom Phone. Debido a que Zoom no administra 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 del participante de extremo a extremo.

#### <mark style="color:azul;">(QSS) los datos no incluyen datos para Participantes externos</mark>

(QSS) no proporciona datos para los participantes de la reunión externa. Sin embargo, (QSS) puede ayudar a identificar qué participante interno de la reunión 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 problemas.

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

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

#### <mark style="color:azul;">(QSS) entrega eventos de QoS casi en tiempo real a los endpoints a los que te has suscrito, reduciendo el sondeo de API y el impacto de los límites de velocidad</mark>

(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 optimizar el uso de la red. QSS es una ampliación de la [servicio de webhook Estándar](https://developers.zoom.us/docs/api/webhooks/) porque puede enviar datos brutos de QoS a un punto de conexión a una velocidad de casi tiempo real de 4 a 6 veces por minuto.

#### <mark style="color:azul;">(QSS) permite a Clientes Acceso a datos de QoS casi en tiempo real desde Panel de control sin alcanzar los límites de velocidad del API</mark>

Los servicios API se basan en solicitudes y utilizan un mecanismo de «pull» para recopilar los datos solicitados por una aplicación o un 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](https://developers.zoom.us/docs/api/) al intentar extraer datos de QoS de Zoom Panel de control puede encontrar límites de velocidad, lo que significa que han alcanzado el número máximo de llamadas a la API que pueden realizar dentro de un período de tiempo determinado. QSS no aumenta los límites de velocidad de la API, pero reduce las preocupaciones de los Clientes sobre los límites de velocidad al enviar los datos sin procesar de QoS a sus endpoints en lugar de requerir que los Clientes extraigan los datos por sí mismos.

#### <mark style="color:azul;">(QSS) permite a Clientes consumir datos sin procesar de Zoom QoS y solucionarlos mediante su sistema de gestión de red preferido</mark>

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

#### <mark style="color:azul;">Los datos de Zoom QoS se transmiten mediante TLS 1.2</mark>

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

Para mayor seguridad, se solicitará a los Clientes que [validar sus endpoints webhook](https://developers.zoom.us/docs/api/webhooks/) usando una Comprobación de Desafío-Respuesta (CRC). La CRC confirmará la titularidad 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 de (QSS)

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

Los Clientes también pueden seguir la [Zoom Paquete para desarrolladores](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) con una bandera (QSS) habilitada, que agrupa (QSS) con otras herramientas de desarrollador.

{% stepper %}
{% step %}
**Cree una aplicación de Suscripción de Evento (OAuth general o de servidor a servidor). Habilitar Suscripciones de Evento y Seleccione eventos QoS**

Los Clientes deben primero crear una aplicación OAuth General o Server-to-Server en la [Zoom App Marketplace](https://marketplace.zoom.us/). Luego, ellos Habilitarían las Suscripciones de Evento y Seleccione los eventos de QoS que quieren recibir.

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

{% hint style="info" %}
No se requiere una aplicación solo webhook para esta configuración. Zoom recomienda crear una Aplicación general.
{% endhint %}
{% endstep %}

{% step %}
**Suscríbete a eventos de webhook de (QSS)**

Para suscribirse a los 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.

<figure><img src="/files/47eb770b29e5c14138f9d2ef19066e180dc57e70" alt="Image of the Event types screen, focused on QSS options."><figcaption></figcaption></figure>

También puede administrar 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} – cancelar la suscripción/eliminar`
* `GET /marketplace/aplicación/Evento_subscription – lista`

Para autenticarte vía API, usa un token del Client Credentials Grant.
{% endstep %}

{% step %}
**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 primero Habilitar suscripciones de Evento, Zoom realiza una verificación de desafío-respuesta (CRC) para verificar la propiedad de su punto de conexión webhook. Este proceso garantiza que Zoom está enviando datos a un destino legítimo controlado por su aplicación. (Puede incluir el manejo de CRC en un paso de configuración anterior si lo prefiere.)
* **Validación de Evento**
  * 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 webhook Evento. 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 los documentos para desarrolladores de Zoom.
  * Use la API de Get Webhook Logs para revisar hasta siete días de datos de entrega de webhook, incluidos el estado, el recuento de reintentos y el ID de seguimiento.
    {% endstep %}
    {% endstepper %}

Para obtener todos los detalles de implementación, consulte el [(QSS) Guía de implementación](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) para desarrolladores. Para obtener detalles técnicos, consulte las guías de API de suscripción de Evento, API de registros de webhook y autenticación de Client Credentials Grant en los Zoom Developer Docs.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://library.zoom.com/technical-library/es/rincon-del-administrador/network-management/quality-of-service-subscription-explainer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
