# Présentation de Abonnement Qualité de service (QSS)

### L'Abonnement Qualité de service (QSS) est un Module d'extension qui diffuse une télémétrie QoS quasi en temps réel pour Zoom Meetings, les webinaires et Zoom Phone via des abonnements d'événement

L'Abonnement Qualité de service (QSS) de Zoom est un Module d'extension qui offre des données de qualité de service (QoS) en quasi temps réel pour Zoom Meetings, les webinaires et les appels téléphoniques. QSS étend les fonctionnalités du produit Zoom en envoyant des événements QoS au niveau du participant à des intervalles d'une minute (le taux et l'agrégation peuvent varier selon la configuration). Les Clients peuvent utiliser ce flux de données riche pour identifier si les environnements réseau affectent les services de Zoom.

#### <mark style="color:bleu;">QSS fournit les mêmes métriques QoS sous-jacentes utilisées dans les Tableau de bord Zoom et les API, mais l'échantillonnage et le timing diffèrent</mark>

L'existant [Tableau de bord Zoom](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) fournit des métriques de performance réseau et d'utilisation, ce qui peut aider les Clients à comprendre comment Zoom fonctionne dans un environnement réseau. QSS offre les mêmes données QoS Zoom, mais à un rythme plus rapide. En raison de cette fréquence d'échantillonnage plus rapide, les métriques QoS agrégées afficheront des valeurs différentes de celles du principal Tableau de bord Zoom. Cependant, ces métriques permettent toujours aux Clients de les configurez dans leurs propres vues de tableau de bord afin de corréler les données Zoom avec des systèmes supplémentaires.

Le tableau ci-dessous décrit les données QoS fournies aux points de terminaison d'un Client via QSS.

<table><thead><tr><th width="230"></th><th>Données QoS fournies via QSS</th></tr></thead><tbody><tr><td>Métriques de qualité</td><td>Débit, latence, gigue, perte de paquets, résolution, fréquence d’images, utilisation du processeur</td></tr><tr><td>Métriques d’utilisation</td><td>Appareil, réseau, région de signalisation, version du client, audio (E/S), vidéo (E/S)</td></tr><tr><td>Fréquence</td><td>Environ 1 événement par minute, par participant (par métrique QoS ou ensemble agrégé selon les Paramètres du compte).</td></tr><tr><td>Conservation des données</td><td>Les journaux de livraison des événements sont conservés pendant 7 jours via l’API des journaux webhook ; les données historiques QoS via les points de terminaison API peuvent être conservées plus longtemps (selon la licence).</td></tr></tbody></table>

#### <mark style="color:bleu;">Les données du Tableau de bord Zoom ne doivent pas être comparées aux données livrées via QSS à un point de terminaison tiers du client</mark>

QSS et le Tableau de bord Zoom fournissent deux mécanismes distincts pour accéder aux données QoS Zoom, qui ne doivent pas être comparés. Bien que le Tableau de bord Zoom et QSS s’appuient sur le même pool de données QoS, les données de chaque mécanisme ne correspondront pas en raison de différences dans le moment de récupération et la fréquence de livraison des données.

#### <mark style="color:bleu;">QSS prend en charge les données d’événements en temps réel pour les réunions, les webinaires et les appels téléphoniques</mark>

QSS fournit des données d'événement QoS pour tous les utilisateurs d'un compte pour Zoom Meetings et les webinaires, ainsi que pour les appels Zoom Phone. Parce que Zoom ne gère pas le dernier segment des appels, QSS ne fournit des données d'événement QoS qu'au niveau du compte pour les appels Zoom Phone et ne peut donc pas offrir une visibilité complète sur les données avancées de participant de bout en bout.

#### <mark style="color:bleu;">Les données QSS n'incluent pas les données des participants externes</mark>

QSS ne fournit pas de données pour les participants externes à la réunion. Cependant, QSS peut aider à identifier précisément quel participant interne à la réunion a rencontré un problème et quel était ce problème, ainsi que les indicateurs de qualité et d'utilisation dont les Clients auront besoin pour résoudre les problèmes.

### QSS permet aux Clients d'intégrer les données QoS brutes de Tableau de bord dans leurs workflows existants

Bien que les Clients Zoom aient historiquement pu utiliser des outils comme Tableau de bord Zoom ou des API pour consulter ou récupérer des données QoS Zoom, QSS vous permet de diffuser la télémétrie QoS Zoom vers vos plateformes de gestion et de surveillance du réseau via des abonnements aux événements (webhook ou WebSocket).

#### <mark style="color:bleu;">QSS fournit des événements QoS quasi en temps réel à vos points de terminaison abonnés, réduisant le polling API et l'impact des limites de débit</mark>

Les Clients QSS peuvent s'abonner à des événements et à des données QoS en temps réel qui seront envoyés à leurs points de terminaison d'application, ce qui aide à libérer de la capacité API et à optimiser l'utilisation du réseau. QSS est une extension du service webhook Standard de Zoom [service webhook Standard](https://developers.zoom.us/docs/api/webhooks/) car il peut envoyer des données QoS brutes à un point de terminaison à un rythme quasi en temps réel de 4 à 6 fois par minute.

#### <mark style="color:bleu;">QSS permet aux Clients d'accéder à des données QoS quasi en temps réel depuis Tableau de bord sans atteindre les limites de débit de l'API</mark>

Les services API sont basés sur des requêtes et utilisent un mécanisme « pull » pour հավաքer les données demandées par une application ou un utilisateur. Les API sont plus gourmandes en ressources que les webhooks, car elles nécessitent des appels répétés pour extraire des données depuis un point de terminaison API.

Clients qui utilisent [API Zoom](https://developers.zoom.us/docs/api/) pour extraire des données QoS depuis le Tableau de bord Zoom peuvent rencontrer des limites de débit, ce qui signifie qu’ils ont atteint le nombre maximal d’appels API qu’ils peuvent effectuer sur une période donnée. QSS n’augmente pas les limites de débit API, mais réduit les préoccupations des clients liées aux limites de débit en envoyant les données QoS brutes à leurs points de terminaison au lieu de leur demander d’extraire eux-mêmes les données.

#### <mark style="color:bleu;">QSS permet aux clients de consommer des données QoS brutes de Zoom et de dépanner à l’aide de leur système de gestion réseau préféré</mark>

Certains clients peuvent avoir besoin d’évaluer les performances de leur réseau sur plusieurs applications à la fois. QSS leur permet de surveiller les données QoS de Zoom dans un tableau de bord aux côtés d’autres données de leur suite d’applications, offrant ainsi un moyen flexible et évolutif de consommer les données QoS de Zoom et de les intégrer de manière transparente dans des tableaux de bord personnalisés.

#### <mark style="color:bleu;">Les données QoS de Zoom sont transmises via TLS 1.2</mark>

Les données QSS sont chiffrées en transit à l’aide de TLS 1.2 ou supérieur. Les points de terminaison doivent utiliser un certificat valide d’une autorité de certification (CA). Les requêtes webhook incluent un en-tête de signature et une vérification défi-réponse pour la vérification.

Pour une sécurité renforcée, les clients seront invités à [valider leurs points de terminaison webhook](https://developers.zoom.us/docs/api/webhooks/) en utilisant un Challenge-Response Check (CSsC). Le CSsC confirmera la propriété et la sécurité de leurs URL de point de terminaison de Notification d'événement.

### Les Clients peuvent commencer à consommer les données QoS en créant une application capable de recevoir des événements QSS

Après qu'un client achète le plan du Module d'extension QSS, au moins un utilisateur du compte doit avoir les autorisations de développeur activées. Les Clients peuvent alors suivre les trois étapes suivantes pour créer une application webhook qui peut s'abonner aux événements QSS.

Les Clients peuvent également poursuivre le [Zoom Pack développeur](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) avec un indicateur QSS activé, qui regroupe QSS avec d’autres outils de développement.

{% stepper %}
{% step %}
**Créez une application d’abonnement aux événements (OAuth Général ou Serveur à serveur). Activer les abonnements aux événements et sélectionnez les événements QoS**

Les Clients doivent d'abord créer une application OAuth générale ou serveur à serveur dans la [Zoom App Marketplace](https://marketplace.zoom.us/). Ensuite, ils Activer les abonnements aux événements et sélectionnez les événements QoS qu'ils souhaitent recevoir.

suivant, les clients doivent spécifier la destination des notifications d’événement QSS en saisissant l’URL du point de terminaison de notification d’événement de leur application

{% hint style="info" %}
Une application uniquement Webhook n’est pas requise pour cette configuration. Zoom recommande de créer une application générale.
{% endhint %}
{% endstep %}

{% step %}
**Abonnez-vous aux événements Webhook QSS**

Pour s’abonner aux événements QSS, les clients doivent ajout des événements et choisissez dans la liste des QSS disponibles **Types d’événements**. Clients peuvent sélectionnez un ou plusieurs événements QSS avant de terminer le processus et d’activer leur application.

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

Vous pouvez également gérer les abonnements via l’interface utilisateur du Marketplace ou à l’aide d’appels API :

* `POST /marketplace/application/événement_subscription – créer`
* `PATCH /{id} – abonner des utilisateurs/comptes`
* `DELETE /{id} – se désabonner/supprimer`
* `GET /marketplace/application/événement_subscription – liste`

Pour authentifier via API, utilisez un jeton provenant du flux Client Credentials Grant.
{% endstep %}

{% step %}
**Vérifier les événements webhook**

Après avoir configuré les abonnements aux événements, assurez-vous que la propriété de l’URL webhook et l’authenticité des événements sont correctement validées.

* **Validation de l'URL**
  * Lorsque vous activez pour la première fois les abonnements aux événements, Zoom effectue une vérification Challenge–Response Check (CSsC) pour vérifier la propriété de votre point de terminaison webhook. Ce processus garantit que Zoom envoie les données vers une destination légitime contrôlée par votre application. (Vous pouvez inclure la gestion du CSsC dans une étape de configuration antérieure si vous le préférez.)
* **Validation d'événement**
  * Chaque Notification d’événement entrante doit être vérifiée par votre application afin de confirmer qu’elle provient de Zoom. L’application peut valider les requêtes entrantes à l’aide de l’en-tête de signature fourni dans chaque webhook d’événement. Les développeurs qui préfèrent une alternative à la méthode de signature par défaut peuvent utiliser l’une des autres options de vérification prises en charge décrites dans les Zoom Developer Docs.
  * Utilisez l'API Get Webhook Logs pour consulter jusqu'à sept jours de données de livraison webhook, y compris le statut, le nombre de tentatives et l'ID de trace.
    {% endstep %}
    {% endstepper %}

Pour obtenir tous les détails de l’implémentation, veuillez vous référer à la [Guide de mise en œuvre QSS](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) pour les développeurs. Pour les détails techniques, consultez les guides API d'abonnement aux événements, API des journaux webhook et d'authentification Client Credentials Grant dans les documents de développement Zoom.


---

# 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/fr/coin-admin/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.