> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/fr/coin-admin/network-management/quality-of-service-subscription-explainer.md).

# Explicatif de l'Abonnement Qualité de service (QSS)

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

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 rythme et l’agrégation peuvent varier selon la configuration). Les Clients peuvent utiliser ce flux de données riche pour identifier si des 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 Tableaux de bord Zoom et les API, mais l’échantillonnage et le minutage 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 et d’utilisation du réseau, 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 ce rythme d’échantillonnage plus rapide, les métriques QoS agrégées Afficher des valeurs différentes de celles du principal Tableau de bord Zoom. Cependant, ces métriques autorisent encore les Clients à 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 transmises via QSS</th></tr></thead><tbody><tr><td>Métriques de qualité</td><td>Débit binaire, Latence, Gigue, Perte de paquets, Résolution, Fréquence d’images, Utilisation du processeur</td></tr><tr><td>Mesures d'utilisation</td><td>Appareil, réseau, région de signalisation, version du client, audio (I/O), vidéo (I/O)</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 d’un 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 ensemble 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 Zoom Meetings, les webinaires et les appels Zoom Phone</mark>

QSS fournit des données d’événements QoS pour tous les utilisateurs d’un compte pour Zoom Meetings et les webinaires, ainsi que pour les appels Zoom Phone. Comme Zoom ne gère pas la dernière partie des appels, QSS ne fournit que des données d’événements QoS au niveau du compte pour les appels Zoom Phone et ne peut donc pas fournir une visibilité complète sur les données avancées de bout en bout du participant.

#### <mark style="color:bleu;">Les données QSS n’incluent pas de données pour les Participants externes</mark>

QSS ne fournit pas de données pour les Participants externes de réunion. Cependant, QSS peut aider à identifier quel participant interne de 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 des données brutes de QoS depuis le Tableau de bord Zoom dans leurs flux de travail existants

Bien que les Clients Zoom aient historiquement pu utiliser des outils comme le Tableau de bord Zoom ou les API pour afficher 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 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 ainsi l’interrogation des 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 contribue à 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 le Tableau de bord Zoom 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 de « pull » pour collecter les données demandées par une application ou un utilisateur. Les API consomment davantage de ressources que les webhooks, car elles nécessitent des appels répétés pour extraire les données d’un point de terminaison API.

Clients qui utilisent [les 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 des API, mais réduit les inquiétudes des Clients liées aux limites de débit en envoyant les données QoS brutes vers leurs points de terminaison au lieu d’exiger que les Clients extraient eux-mêmes les données.

#### <mark style="color:bleu;">QSS permet aux Clients de consommer les 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, en parallèle 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 fluide 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 d’une version supérieure. 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 plus de sécurité, les Clients seront invités à [valider leurs points de terminaison webhook](https://developers.zoom.us/docs/api/webhooks/) à l’aide d’un Contrôle Défi-Réponse (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 des données QoS en créant une application capable de recevoir des événements QSS

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

Les Clients peuvent également poursuivre le [Pack développeur Zoom](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 pourraient 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 webhook uniquement 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 parmi la liste des QSS Disponible **Types d'événement**. Clients peuvent sélectionner 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 Marketplace ou en utilisant des 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 du 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é de l’événement sont correctement validées.

* **Validation de l’URL**
  * Lorsque vous activez pour la première fois les abonnements aux événements, Zoom effectue un Challenge–Response Check (CSsC) afin de vérifier la propriété de votre point de terminaison webhook. Ce processus garantit que Zoom envoie des 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 des événements**
  * 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 événement webhook. 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, notamment le statut, le nombre de tentatives et l’ID de trace.
    {% endstep %}
    {% endstepper %}

Pour connaître tous les détails d’implémentation, veuillez vous référer au [Guide d’implémentation QSS](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) pour les développeurs. Pour les détails techniques, consultez les guides de l’API d’abonnement aux événements, de l’API des journaux de webhook et de l’authentification Client Credentials Grant dans la documentation développeur Zoom.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://library.zoom.com/technical-library/fr/coin-admin/network-management/quality-of-service-subscription-explainer.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.