Spiegazione dell’abbonamento alla qualità del servizio

L’abbonamento alla qualità del servizio è un prodotto add-on che fornisce dati QoS di Meeting, Webinar e Phone a un endpoint di terze parti del cliente.

abbonamento alla qualità del servizio è un add-on prodotto che trasmette in streaming dati di telemetria QoS quasi in tempo reale per Zoom Meetings, Webinars e Zoom Phone tramite sottoscrizioni Evento

L’abbonamento alla qualità del servizio di Zoom’s Quality of Service Subscription (QSS) è un prodotto add-on che offre dati sulla qualità del servizio (QoS) quasi in tempo reale per Zoom Meetings, Webinars e chiamate telefoniche. QSS estende la funzionalità del prodotto di Zoom inviando eventi QoS a livello di partecipante a intervalli a livello di minuti (la velocità e l’aggregazione possono variare in base alla configurazione). Clienti possono utilizzare questo flusso di dati ricco per identificare se gli ambienti di rete stanno influenzando i servizi di Zoom.

QSS fornisce le stesse metriche QoS sottostanti utilizzate in Zoom Dashboard e nelle API, ma il campionamento e i tempi sono diversi

L'esistente Zoom Dashboard fornisce metriche di prestazioni e utilizzo della rete, che possono aiutare i clienti a comprendere come Zoom opera in un ambiente di rete. QSS offre gli stessi dati QoS di Zoom, ma a una velocità maggiore. A causa di questa frequenza di campionamento più elevata, le metriche QoS aggregate Mostra valori diversi rispetto al principale Zoom Dashboard. Tuttavia, queste metriche consentire comunque ai clienti di Configura le proprie viste della dashboard per correlare i dati di Zoom con sistemi aggiuntivi.

La tabella seguente descrive i dati QoS consegnati agli endpoint di un cliente tramite QSS.

	QoS Dati forniti tramite QSS
Metriche di qualità	Bitrate, Latenza, Jitter, Perdita di pacchetti, Risoluzione, Frequenza dei fotogrammi, Utilizzo CPU
Metriche di utilizzo	Dispositivo, Rete, Regione di segnalazione, Versione del client, audio (I/O), video (I/O)
Frequenza	Circa 1 Evento al minuto, per partecipante (per metrica QoS o set aggregato a seconda delle Impostazioni account).
Conservazione dei dati	I log di consegna degli Evento vengono conservati per 7 giorni tramite la Webhook Logs API; i dati storici QoS tramite endpoint API possono persistere più a lungo (a seconda della licenza).

I dati di Zoom Dashboard non devono essere confrontati con i dati forniti tramite QSS a un endpoint di terze parti del cliente

QSS e Zoom Dashboard forniscono due meccanismi separati per accedere ai dati QoS di Zoom che non devono essere confrontati. Sebbene Zoom Dashboard e QSS attingano dallo stesso pool di dati QoS, i dati in ciascun meccanismo non corrisponderanno a causa delle differenze nei tempi di recupero e nella frequenza di consegna dei dati.

QSS supporta dati Evento in tempo reale per Riunioni, Webinar e chiamate telefoniche

QSS fornisce dati sugli eventi QoS per tutti gli utenti di un account per Zoom Meetings e webinar, nonché per le chiamate di Zoom Phone. Poiché Zoom non gestisce l’ultimo tratto delle chiamate, QSS fornisce solo dati sugli eventi QoS a livello di account per le chiamate di Zoom Phone e quindi non può offrire una visibilità completa sui dati avanzati end-to-end dei partecipanti.

I dati QSS non includono dati per partecipanti esterni

QSS non fornisce dati per i partecipanti esterni alla riunione. Tuttavia, QSS può aiutare a individuare quale partecipante interno alla riunione abbia avuto un problema e quale fosse quel problema, oltre alle metriche di qualità e utilizzo di cui i Clienti avranno bisogno per risolvere i problemi.

QSS consente ai Clienti di integrare i dati QoS grezzi da Dashboard nei propri flussi di lavoro esistenti

Sebbene storicamente i Clienti di Zoom abbiano potuto usare strumenti come Dashboard o le API per visualizzare o recuperare i dati QoS di Zoom, QSS consente di trasmettere in streaming la telemetria QoS di Zoom nelle piattaforme di gestione e monitoraggio della rete tramite sottoscrizioni agli eventi (webhook o WebSocket).

QSS fornisce eventi QoS quasi in tempo reale ai tuoi endpoint sottoscritti, riducendo il polling delle API e l’impatto dei limiti di frequenza

I Clienti QSS possono abbonarsi a eventi e dati QoS in tempo reale che verranno inviati ai loro endpoint dell’applicazione, il che aiuta a liberare capacità API e a ottimizzare l’utilizzo della rete. QSS è un’estensione del servizio webhook Standard di Zoom servizio webhook Standard perché può inviare dati QoS grezzi a un endpoint a una velocità quasi in tempo reale da 4 a 6 volte al minuto.

QSS consente ai Clienti di accedere a dati QoS quasi in tempo reale da Dashboard senza superare i limiti di frequenza delle API

I servizi API sono basati su richieste e usano un meccanismo “pull” per raccogliere i dati richiesti da un’app o da un utente. Le API richiedono più risorse rispetto ai webhook perché necessitano di chiamate ripetute per estrarre i dati da un endpoint API.

Clienti che utilizzano Zoom API per estrarre i dati QoS da Zoom Dashboard possono incontrare limiti di frequenza, il che significa che hanno raggiunto il numero massimo di chiamate API che possono effettuare in un determinato periodo di tempo. QSS non aumenta i limiti di frequenza delle API, ma riduce le preoccupazioni dei Clienti relative ai limiti di frequenza inviando i dati QoS grezzi ai loro endpoint invece di richiedere ai Clienti di estrarre i dati da soli.

QSS consente ai Clienti di consumare i dati QoS grezzi di Zoom e risolvere i problemi usando il loro sistema di gestione della rete preferito

Alcuni Clienti potrebbero dover valutare le prestazioni della propria rete su più applicazioni contemporaneamente. QSS consente loro di monitorare i dati QoS di Zoom in una dashboard insieme ad altri dati nella loro suite di applicazioni, fornendo un modo flessibile e scalabile per consumare i dati QoS di Zoom e integrarli senza soluzione di continuità nelle dashboard personalizzate.

I dati QoS di Zoom vengono trasmessi tramite TLS 1.2

I dati QSS sono crittografati in transito usando TLS 1.2 o versioni successive. Gli endpoint devono usare un valido certificato dell'Autorità di certificazione (CA). Le richieste webhook includono un'intestazione di firma e un controllo challenge-response per la Verifica.

Per una sicurezza aggiuntiva, ai Clienti verrà richiesto di validare i loro endpoint webhook utilizzando un Challenge-Response Check (CRC). Il CRC confermerà la proprietà e la sicurezza dei loro URL dell'endpoint di Notifica dell'Evento.

I Clienti possono iniziare a consumare dati QoS creando un'applicazione che può ricevere eventi QSS

Dopo che un Cliente ha acquistato il piano add-on di QSS, almeno un utente sull'account deve avere abilitati i permessi di sviluppatore. Clienti possono quindi utilizzare i seguenti tre passaggi per creare un'applicazione webhook che può sottoscrivere eventi QSS.

I Clienti possono anche perseguire il Pacchetto per sviluppatori Zoom con un flag QSS abilitato, che raggruppa QSS con altri strumenti per sviluppatori.

1

Crea un'app di sottoscrizione Evento (OAuth generale o server-to-server). Abilita le sottoscrizioni agli Evento e Seleziona gli eventi QoS

I Clienti devono prima creare un'app OAuth Generale o Server-to-Server nel Zoom App Marketplace. Quindi, Abilita le sottoscrizioni agli eventi e Seleziona gli eventi QoS che desiderano ricevere.

Avanti, i Clienti devono specificare la destinazione per le notifiche degli eventi QSS inserendo l’URL dell’endpoint di Notifica Evento della loro applicazione

Per questa configurazione non è richiesta un'app solo webhook. Zoom consiglia di creare un'app Generale.

2

Iscriviti agli eventi webhook di QSS

Per sottoscriversi agli eventi QSS, i Clienti devono Aggiungi eventi e Scegli dalla lista di QSS Disponibile Tipi di Evento. I Clienti possono Seleziona uno o più eventi QSS prima di completare il processo e attivare la loro applicazione.

Puoi նաև gestire gli abbonamenti tramite l'interfaccia utente di Marketplace o usando chiamate API:

• POST /Marketplace/app/Evento_subscription – crea

• PATCH /{id} – sottoscrivi utenti/account

• DELETE /{id} – annulla iscrizione/elimina

• GET /marketplace/app/Evento_subscription – elenco

Per autenticare tramite API, usa un token del Client Credentials Grant.

3

Verifica gli eventi webhook

Dopo aver configurato le sottoscrizioni di Evento, assicurati che sia la proprietà dell'URL del webhook sia l'autenticità dell'Evento siano convalidate correttamente.

• Convalida URL

  • Quando Abilita per la prima volta gli abbonamenti agli Evento, Zoom esegue un Controllo Challenge–Response (CRC) per verificare la proprietà del tuo webhook endpoint. Questo processo garantisce che Zoom stia inviando dati a una destinazione legittima controllata dalla tua app. (Puoi includere la gestione del CRC in una fase di configurazione precedente, se preferisci.)

• Validazione Evento

  • Ogni Notifica Evento in arrivo dovrebbe essere verificata dalla tua applicazione per confermare che provenga da Zoom. L'app può convalidare le richieste in arrivo utilizzando l'intestazione della firma fornita in ogni Evento webhook. Gli sviluppatori che preferiscono un'alternativa al metodo di firma predefinito possono usare una delle altre opzioni di Verifica supportate descritte nella Zoom Developer Docs.

  • Usa l'API Get Webhook Logs per esaminare fino a sette giorni di dati di consegna del webhook, inclusi stato, numero di tentativi e trace ID.

Per i dettagli completi sull’implementazione, fare riferimento a Guida all'implementazione QSS per gli sviluppatori. Per i dettagli tecnici, consulta le guide API di sottoscrizione agli Evento, API dei log webhook e autenticazione Client Credentials Grant nella documentazione per sviluppatori di Zoom.