> 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/it/angolo-admin/network-management/quality-of-service-subscription-explainer.md).

# Spiegazione dell'abbonamento alla qualità del servizio

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

La Quality of Service Subscription (QSS) di Zoom è 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 di minuti (la velocità e l’aggregazione possono variare in base alla configurazione). Clienti possono utilizzare questo ricco flusso di dati per identificare se ambienti di rete stanno influenzando i servizi di Zoom.

#### <mark style="color:blu;">QSS fornisce le stesse metriche QoS sottostanti utilizzate in Zoom Dashboard e API, ma il campionamento e i tempi variano</mark>

L'esistente [Zoom Dashboard](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) fornisce metriche sulle prestazioni e sull'utilizzo della rete, che possono aiutare i Clienti a comprendere come Zoom sta operando in un ambiente di rete. QSS offre gli stessi dati QoS di Zoom, ma a una velocità maggiore. A causa di questa velocità di campionamento più elevata, le metriche QoS aggregate Mostra valori diversi dalla Dashboard principale di Zoom. Tuttavia, queste metriche consentire ancora ai Clienti di Configura le loro visualizzazioni Dashboard in modo da correlare i dati Zoom con sistemi aggiuntivi.

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

<table><thead><tr><th width="230"></th><th>Dati QoS forniti tramite QSS</th></tr></thead><tbody><tr><td>Metriche di qualità</td><td>Bitrate, latenza, jitter, perdita di pacchetti, risoluzione, frame rate, utilizzo della CPU</td></tr><tr><td>Metriche di utilizzo</td><td>Dispositivo, Rete, Regione di segnalazione, Versione del client, audio (I/O), Video (I/O)</td></tr><tr><td>Frequenza</td><td>Circa 1 evento al minuto, per partecipante (per metrica QoS o insieme aggregato a seconda delle Impostazioni dell'account).</td></tr><tr><td>Conservazione dei dati</td><td>I log di consegna degli eventi vengono conservati per 7 giorni tramite la webhook Logs API; i dati QoS storici tramite endpoint API possono persistere più a lungo (a seconda della licenza).</td></tr></tbody></table>

#### <mark style="color:blu;">I dati di Zoom Dashboard non devono essere confrontati con i dati consegnati tramite QSS a un endpoint di terze parti del cliente</mark>

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 allo stesso insieme di dati QoS, i dati in ciascun meccanismo non coincideranno a causa delle differenze nel momento di recupero e nella frequenza di consegna dei dati.

#### <mark style="color:blu;">QSS supporta dati evento in tempo reale per Zoom Meetings, webinar e chiamate Zoom Phone</mark>

QSS fornisce dati evento QoS per tutti gli utenti su un account per Zoom Meetings e webinar, così come per le chiamate Zoom Phone. Poiché Zoom non gestisce l'ultimo tratto delle chiamate, QSS fornisce solo dati evento QoS a livello di account per le chiamate Zoom Phone e pertanto non può offrire una visibilità completa sui dati avanzati end-to-end del partecipante.

#### <mark style="color:blu;">I dati QSS non includono dati per i partecipanti esterni</mark>

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

### QSS consente ai clienti di portare i dati grezzi di QoS da Zoom Dashboard nei loro flussi di lavoro esistenti

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

#### <mark style="color:blu;">QSS fornisce eventi QoS quasi in tempo reale ai tuoi endpoint sottoscritti, riducendo il polling delle API e l'impatto dei limiti di velocità</mark>

I clienti QSS possono iscriversi a eventi e dati QoS in tempo reale che verranno inviati ai loro endpoint di applicazione, aiutando a liberare capacità API e ottimizzare l'utilizzo della rete. QSS è un'estensione del servizio webhook standard di Zoom [servizio webhook Standard](https://developers.zoom.us/docs/api/webhooks/) perché può inviare dati grezzi di QoS a un endpoint a una velocità quasi in tempo reale da 4 a 6 volte al minuto.

#### <mark style="color:blu;">QSS consente ai clienti di accedere ai dati QoS quasi in tempo reale da Zoom Dashboard senza superare i limiti di velocità delle API</mark>

I servizi API sono basati su richieste e utilizzano un meccanismo di “pull” per raccogliere i dati richiesti da un'app o da un utente. Le API sono più dispendiose in termini di risorse rispetto ai webhook perché richiedono chiamate ripetute per prelevare i dati da un endpoint API.

Clienti che usano [API di Zoom](https://developers.zoom.us/docs/api/) per estrarre i dati QoS da Zoom Dashboard potrebbero 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 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 autonomamente.

#### <mark style="color:blu;">QSS consente ai clienti di utilizzare i dati QoS grezzi di Zoom e di risolvere i problemi usando il loro sistema di gestione della rete preferito</mark>

Alcuni clienti potrebbero aver bisogno di 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, offrendo un modo flessibile e scalabile per utilizzare i dati QoS di Zoom e integrarli senza problemi in dashboard personalizzate.

#### <mark style="color:blu;">I dati QoS di Zoom vengono trasmessi tramite TLS 1.2</mark>

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

Per maggiore sicurezza, ai clienti verrà chiesto di [convalidare i loro endpoint webhook](https://developers.zoom.us/docs/api/webhooks/) usando un Controllo Challenge-Response (CRC). Il CRC confermerà la proprietà e la sicurezza degli URL del loro endpoint di notifica degli Evento.

### I Clienti possono iniziare a utilizzare i dati QoS creando un'applicazione che possa ricevere eventi QSS

Dopo che un Clienti acquista il piano add-on di QSS, almeno un utente sull'account deve avere abilitate le autorizzazioni per sviluppatori. Clienti possono quindi utilizzare i seguenti tre passaggi per creare una applicazione webhook che può sottoscrivere eventi QSS.

I Clienti possono anche seguire la [Pacchetto per sviluppatori Zoom](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) con un flag QSS abilitato, che raggruppa QSS con altri strumenti per sviluppatori.

{% stepper %}
{% step %}
**Crea un'app di sottoscrizione all'Evento (OAuth generale o server-to-server). Abilita le sottoscrizioni all'Evento e seleziona gli eventi QoS**

I Clienti devono prima creare un'app OAuth General o Server-to-Server in [Zoom App Marketplace](https://marketplace.zoom.us/). Quindi, dovrebbero Abilita le Sottoscrizioni Evento e Seleziona gli eventi QoS che vogliono ricevere.

Avanti, i Clienti devono specificare la destinazione per le notifiche Evento QSS inserendo l'URL dell'endpoint di Notifica dell'applicazione

{% hint style="info" %}
Una app solo webhook non è richiesta per questa configurazione. Zoom consiglia di creare una app Generale.
{% endhint %}
{% endstep %}

{% step %}
**Iscriviti agli eventi webhook di QSS**

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

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

Puoi anche gestire gli abbonamenti tramite l'interfaccia utente di Marketplace o utilizzando chiamate API:

* `POST /Marketplace/app/Evento_subscription – crea`
* `PATCH /{id} – iscrivi utenti/account`
* `ELIMINA /{id} – annulla l'iscrizione/elimina`
* `GET /marketplace/app/Evento_subscription – elenco`

Per autenticare tramite API, usa un token del Client Credentials Grant.
{% endstep %}

{% step %}
**Verifica gli eventi webhook**

Dopo aver configurato gli abbonamenti agli Evento, assicurati che sia la proprietà dell’URL webhook sia l’autenticità dell’Evento siano convalidate correttamente.

* **Validazione URL**
  * Quando Abilita per la prima volta le sottoscrizioni di Evento, Zoom esegue un controllo challenge–response (CRC) per verificare la proprietà del tuo endpoint webhook. Questo processo garantisce che Zoom stia inviando dati a una destinazione legittima controllata dalla tua app. (Se preferisci, puoi includere la gestione del CRC in una fase di configurazione precedente.)
* **Convalida evento**
  * Ogni Notifica di Evento in arrivo dovrebbe essere verificata dalla tua applicazione per confermare che provenga da Zoom. L'app può convalidare le richieste in arrivo usando 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 documentazione per sviluppatori di Zoom.
  * Usa l'API Get Webhook Logs per rivedere fino a sette giorni di dati di consegna del webhook, inclusi stato, numero di tentativi e trace ID.
    {% endstep %}
    {% endstepper %}

Per i dettagli completi sull'implementazione, si prega di fare riferimento a [Guida all'implementazione QSS](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) per sviluppatori. Per i dettagli tecnici, consulta le guide dell'API di sottoscrizione Evento, dell'API dei log webhook e dell'autenticazione Client Credentials Grant nella documentazione per sviluppatori di 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:

```
GET https://library.zoom.com/technical-library/it/angolo-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.