Explication de l'abonnement Qualité de service

L'abonnement Qualité de service est un produit complémentaire qui fournit des données QoS de réunion, webinaire et téléphonie à un point de terminaison tiers du client.

L'abonnement Quality of Service est un produit complémentaire qui diffuse une télémétrie QoS quasi temps réel pour les réunions Zoom, les webinaires et Zoom Phone via des abonnements d'événements

L'abonnement Quality of Service (QSS) de Zoom est un produit complémentaire qui fournit des données de qualité de service (QoS) quasi temps réel pour les réunions Zoom, les webinaires et les appels téléphoniques. Le QSS étend les fonctionnalités du produit Zoom en envoyant des événements QoS au niveau des participants à 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 Zoom.

Le QSS fournit les mêmes métriques QoS sous-jacentes utilisées dans les tableaux de bord et les API Zoom, mais l'échantillonnage et le calendrier diffèrent

L' Tableau de bord Zoom fournit des métriques de performance réseau et d'utilisation, qui peuvent aider les clients à comprendre comment Zoom fonctionne dans un environnement réseau. Le 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 afficheront des valeurs différentes de celles du tableau de bord principal de Zoom. Cependant, ces métriques permettent toujours aux clients de les configurer 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 livrées aux points de terminaison d'un client via le QSS.

	Données QoS livrées via QSS
Métriques de qualité	Débit binaire, latence, gigue, perte de paquets, résolution, fréquence d'images, utilisation du CPU
Métriques d'utilisation	Appareil, réseau, région de signalisation, version du client, audio (E/S), vidéo (E/S)
Fréquence	Environ 1 événement par minute, par participant (par métrique QoS ou ensemble agrégé selon les paramètres du compte).
Conservation des données	Les journaux de livraison des événements sont conservés pendant 7 jours via l'API Webhook Logs ; les données QoS historiques via les points de terminaison API peuvent persister plus longtemps (selon la licence).

Les données du tableau de bord Zoom ne doivent pas être comparées aux données livrées via QSS vers le point de terminaison tiers d'un client

Le QSS et le tableau de bord Zoom fournissent deux mécanismes distincts d'accès aux données QoS de Zoom qui ne doivent pas être comparés. Bien que le tableau de bord Zoom et le QSS tirent du même ensemble de données QoS, les données dans chaque mécanisme ne correspondront pas en raison des différences de temporisation et de fréquence de livraison des données.

Le 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

Le QSS fournit des données d'événements QoS pour tous les utilisateurs d'un compte pour les réunions et webinaires Zoom, ainsi que pour les appels Zoom Phone. Comme Zoom ne gère pas la dernière phase des appels, le 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 des données avancées des participants de bout en bout.

Les données QSS n'incluent pas les données des participants externes

Le QSS ne fournit pas de données pour les participants externes à une réunion. Cependant, le QSS peut aider à identifier quel participant interne à la réunion a rencontré un problème et quel était ce problème, ainsi que les métriques de qualité et d'utilisation dont les clients auront besoin pour dépanner les problèmes.

Le 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 les données QoS Zoom, le QSS vous permet de diffuser la télémétrie QoS Zoom vers vos plates-formes de gestion et de surveillance réseau via des abonnements d'événements (webhook ou WebSocket).

Le QSS diffuse des événements QoS quasi temps réel vers vos points de terminaison abonnés, réduisant ainsi les requêtes d'API et l'impact des limites de débit

Les clients QSS peuvent s'abonner à des événements et des données QoS en temps réel qui seront poussés vers leurs points de terminaison d'application, ce qui aide à libérer la capacité des API et à optimiser l'utilisation du réseau. Le QSS est un ajout au service webhook standard car il peut envoyer des données QoS brutes à un point de terminaison à un rythme quasi temps réel de 4 à 6 fois par minute.

Le QSS permet aux clients d'accéder aux données QoS quasi temps réel du tableau de bord Zoom sans atteindre les limites de débit de l'API

Les services API sont basés sur les requêtes et utilisent un mécanisme de « pull » pour rassembler 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 les API Zoom pour extraire les 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 dans une période donnée. Le QSS n'augmente pas les limites de débit des API, mais il réduit les préoccupations liées aux limites de débit des clients en poussant les données QoS brutes vers leurs points de terminaison au lieu d'exiger que les clients extraient les données eux-mêmes.

Le QSS permet aux clients de consommer les données QoS brutes de Zoom et de dépanner en utilisant leur système de gestion réseau préféré

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

Les données QoS Zoom sont transmises via TLS 1.2

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 d'autorité de certification (CA) valide. Les requêtes webhook incluent un en‑tête de signature et un contrôle challenge‑response pour vérification.

Pour une sécurité supplémentaire, les clients seront invités à valider leurs points de terminaison webhook en utilisant une vérification Challenge‑Response (CRC). La CRC confirmera la propriété et la sécurité des URL de leurs points de notification d'événements.

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 a acheté le forfait add-on QSS, au moins un utilisateur du compte doit disposer des autorisations 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 aussi opter pour le Pack développeur Zoom avec un indicateur QSS activé, qui regroupe le QSS avec d'autres outils pour développeurs.

1

Créer une application d'abonnement d'événements (OAuth général ou serveur‑à‑serveur). Activer les abonnements d'événements et sélectionner les événements QoS

Les clients doivent d'abord créer une application OAuth générale ou serveur‑à‑serveur dans le Zoom App Marketplace. Ensuite, ils activeraient les abonnements d'événements et sélectionnaient 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

Une application uniquement Webhook n'est pas requise pour cette configuration. Zoom recommande de créer une application générale.

2

S'abonner aux événements Webhook QSS

Pour s'abonner aux événements QSS, les clients doivent ajouter des événements et choisir dans la liste des QSS disponibles Types d'événements. Les clients peuvent sélectionner un ou plusieurs événements QSS avant de terminer le processus et d'activer leur application.

Vous pouvez également gérer les abonnements via l'interface Marketplace ou en utilisant des appels API :

• POST /marketplace/app/event_subscription – créer

• PATCH /{id} – abonner des utilisateurs/comptes

• DELETE /{id} – se désabonner/supprimer

• GET /marketplace/app/event_subscription – lister

Pour vous authentifier via l'API, utilisez un jeton issu du Client Credentials Grant.

3

Vérifier les événements Webhook

Après avoir configuré les abonnements d'é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 les abonnements d'événements pour la première fois, Zoom effectue une vérification Challenge–Response (CRC) 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 de la CRC lors d'une étape de configuration antérieure si vous le souhaitez.)

• Validation des événements

  • Chaque notification d'événement entrante doit être vérifiée par votre application pour confirmer qu'elle provient de Zoom. L'application peut valider les requêtes entrantes en utilisant 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 pour développeurs Zoom.

  • Utilisez l'API Get Webhook Logs pour consulter jusqu'à sept jours de données de livraison des webhooks, y compris le statut, le nombre de tentatives et l'ID de trace.

Pour les détails d'implémentation complets, veuillez vous référer au Guide d'implémentation QSS pour les développeurs. Pour les détails techniques, voir l'API Event Subscription, l'API Webhook Logs et les guides d'authentification Client Credentials Grant dans la documentation pour développeurs Zoom.