> 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).

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

### L’Abonnement Qualité de service (QSS) est un produit 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 aux événements.

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

#### <mark style="color:bleu;">QSS fournit les mêmes mesures QoS sous-jacentes que celles utilisées dans les Tableaux de bord Zoom et les API, mais l’échantillonnage et la temporalité diffèrent.</mark>

Le [Tableau de bord Zoom](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) fournit des mesures de performance et d’utilisation du réseau, qui peuvent aider les Clients à comprendre le fonctionnement de Zoom dans un environnement réseau. QSS offre les mêmes données QoS de Zoom, mais à une fréquence plus élevée. En raison de cet échantillonnage plus fréquent, les mesures QoS agrégées afficheront des valeurs différentes de celles du Tableau de bord Zoom principal. Toutefois, ces mesures 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>Mesures 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 (E/S), vidéo (E/S)</td></tr><tr><td>Fréquence</td><td>Environ 1 événement par minute, par participant (par mesure QoS ou ensemble agrégé selon les Paramètres du compte).</td></tr><tr><td>Conservation des données</td><td>Les journaux de diffusion des événements sont conservés pendant 7 jours via l’API des journaux de webhooks ; les données QoS historiques via les points de terminaison de l’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 fournies 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 de Zoom qui ne doivent pas être comparés. Bien que le Tableau de bord Zoom et QSS utilisent 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 diffusion 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 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 fournit uniquement 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 des participants.

#### <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 à une réunion. Toutefois, QSS peut aider à identifier quel participant interne à la réunion a rencontré un problème et quel était ce problème, ainsi que les mesures 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 du Tableau de bord Zoom dans leurs flux de travail existants.

Alors que les Clients Zoom ont historiquement pu utiliser des outils tels que le Tableau de bord Zoom ou les API pour consulter ou récupérer des données QoS de Zoom, QSS vous permet de diffuser la télémétrie QoS de Zoom dans 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 les interrogations d’API et l’impact des limites de débit.</mark>

Les Clients QSS peuvent s’abonner à des événements et données QoS en temps réel qui seront envoyés à leurs points de terminaison d’application, ce qui permet de libérer de la capacité API et d’optimiser l’utilisation du réseau. QSS est une extension du [service webhook Standard](https://developers.zoom.us/docs/api/webhooks/) car il peut envoyer des données QoS brutes à un point de terminaison à une fréquence 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 « pull » pour recueillir 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 les données d’un point de terminaison API.

Les Clients qui utilisent [API Zoom](https://developers.zoom.us/docs/api/) pour extraire des données QoS du 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 au cours d’une période donnée. QSS n’augmente pas les limites de débit de l’API, mais réduit les préoccupations des Clients liées aux limites de débit en envoyant des données QoS brutes à 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 des données QoS brutes de Zoom et de résoudre les problèmes à l’aide de leur système de gestion de réseau préféré.</mark>

Certains Clients peuvent avoir besoin d’évaluer simultanément les performances de leur réseau sur plusieurs applications. QSS leur permet de surveiller les données QoS de Zoom dans un tableau de bord avec d’autres données de leur suite d’applications, offrant ainsi une manière flexible et évolutive de consommer les données QoS de Zoom et de les intégrer de façon 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 version ulté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 un contrôle défi-réponse pour la vérification.

Pour une sécurité supplémentaire, 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é des URL de leurs points de terminaison de Notification d’événements.

### 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 Module d'extension QSS, au moins un utilisateur du compte doit disposer des autorisations de développeur activées. Les Clients peuvent ensuite suivre les trois étapes suivantes pour créer une application webhook pouvant s’abonner aux événements QSS.

Les Clients peuvent également choisir 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 de 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 de serveur à serveur dans le [Zoom App Marketplace](https://marketplace.zoom.us/). Ensuite, ils activeraient les abonnements aux événements et sélectionnez les événements QoS qu’ils souhaitent recevoir.

Ensuite, les Clients doivent spécifier la destination des Notifications d’événements QSS en saisissant l’URL du point de terminaison de Notification d’événements 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 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 à 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 issu 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 choisissez Activer les abonnements aux événements pour la première fois, Zoom effectue un Challenge–Response Check (CSsC) pour 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 la documentation développeur Zoom.
  * 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 tous les détails de mise en œuvre, veuillez vous reporter 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 API d'abonnement aux événements, API des journaux webhook et d'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.
