# Förklaring av tjänstekvalitetsabonnemang

### Quality of Service-abonnemang är en tilläggsprodukt som strömmar nästintill realtids QoS-telemetri för Zoom-möten, webbinarier och Zoom Phone via händelseprenumerationer

Zooms Quality of Service-abonnemang (QSS) är en tilläggsprodukt som erbjuder nästintill realtidsdata om tjänstekvalitet (QoS) för Zoom-möten, webbinarier och telefonsamtal. QSS utökar Zooms produktfunktionalitet genom att skicka QoS-händelser på deltagarnivå med minutvisa intervaller (frekvens och aggregering kan variera beroende på konfiguration). Kunder kan använda denna rika dataström för att identifiera om nätverksmiljöer påverkar Zooms tjänster.

#### <mark style="color:blå;">QSS levererar samma underliggande QoS-metriker som används i Zoom Dashboard och API:er, men provtagning och tidpunkt skiljer sig</mark>

Den befintliga [Zoom Dashboard](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) tillhandahåller nätverksprestanda- och användningsmetrik som kan hjälpa kunder att förstå hur Zoom fungerar i en nätverksmiljö. QSS erbjuder samma Zoom QoS-data, men i en snabbare takt. På grund av denna snabbare provtagningsfrekvens kommer aggregerade QoS-metriker att visa värden som skiljer sig från huvudpanelen i Zoom Dashboard. Dessa metrik gör det dock fortfarande möjligt för kunder att konfigurera dem i sina egna instrumentpanelsvyer för att korrelera Zoom-data med ytterligare system.

Tabellen nedan beskriver QoS-data som levereras till en kunds slutpunkter via QSS.

<table><thead><tr><th width="230"></th><th>QoS-data som levereras via QSS</th></tr></thead><tbody><tr><td>Kvalitetsmetrik</td><td>Bitrate, Latens, Jitter, Paketförlust, Upplösning, Bildfrekvens, CPU-användning</td></tr><tr><td>Användningsmetrik</td><td>Enhet, Nätverk, Signaleringsregion, Klientversion, Ljud (I/O), Video (I/O)</td></tr><tr><td>Frekvens</td><td>C:a 1 händelse per minut och per deltagare (per QoS-metrik eller aggregerad uppsättning beroende på kontoinställningar).</td></tr><tr><td>Dataretention</td><td>Loggar för händelseleverans sparas i 7 dagar via Webhook Logs API; historiska QoS-data via API-slutpunkter kan finnas kvar längre (beroende på licens).</td></tr></tbody></table>

#### <mark style="color:blå;">Zoom Dashboard-data bör inte jämföras med data som levereras via QSS till en kunds tredjeparts-slutpunkt</mark>

QSS och Zoom Dashboard tillhandahåller två separata mekanismer för åtkomst till Zoom QoS-data som inte bör jämföras. Även om Zoom Dashboard och QSS hämtar från samma datakälla för QoS, kommer datan i varje mekanism inte att stämma överens på grund av skillnader i hämtningstidpunkt och leveransfrekvens.

#### <mark style="color:blå;">QSS stöder realtids händelsedata för möten, webbinarier och telefonsamtal</mark>

QSS levererar QoS-händelsedata för alla användare på ett konto för Zoom-möten och webbinarier, samt för Zoom Phone-samtal. Eftersom Zoom inte hanterar sista delen av samtal, tillhandahåller QSS endast kontonivå QoS-händelsedata för Zoom Phone-samtal och kan därför inte ge full insyn i den ända-till-ända avancerade deltagardatan.

#### <mark style="color:blå;">QSS-data inkluderar inte data för externa deltagare</mark>

QSS tillhandahåller inte data för externa mötesdeltagare. QSS kan dock hjälpa till att lokalisera vilken intern mötesdeltagare som hade ett problem och vad det problemet var, samt kvalitets- och användningsmetrik som kunder behöver för att felsöka problem.

### QSS låter kunder föra in rå QoS-data från Zoom Dashboard i sina befintliga arbetsflöden

Medan Zoom-kunder historiskt har kunnat använda verktyg som Zoom Dashboard eller API:er för att visa eller hämta Zoom QoS-data, låter QSS dig strömma Zooms QoS-telemetri till dina nätverkshanterings- och övervakningsplattformar via händelseprenumerationer (webhook eller WebSocket).

#### <mark style="color:blå;">QSS levererar nästintill realtids QoS-händelser till dina prenumererade slutpunkter, vilket minskar API-pollning och påverkan av hastighetsbegränsningar</mark>

QSS-kunder kan prenumerera på realtids QoS-händelser och data som kommer att pushas till deras applikationsslutpunkter, vilket hjälper till att frigöra API-kapacitet och optimera nätverksutnyttjande. QSS är en utvidgning av Zooms [standardwebhooktjänst](https://marketplace.zoom.us/docs/api-reference/webhook-reference/) eftersom den kan skicka rå QoS-data till en slutpunkt i en nästintill realtidstakt på 4 till 6 gånger per minut.

#### <mark style="color:blå;">QSS gör det möjligt för kunder att få åtkomst till nästintill realtids QoS-data från Zoom Dashboard utan att träffa API-hastighetsbegränsningar</mark>

API-tjänster är begäransbaserade och använder en "pull"-mekanism för att samla in data som begärs av en app eller användare. API:er är mer resursintensiva än webhooks eftersom de kräver upprepade anrop för att hämta data från en API-slutpunkt.

Kunder som använder [Zoom API:er](https://marketplace.zoom.us/docs/api-reference/zoom-api/) för att hämta QoS-data från Zoom Dashboard kan stöta på hastighetsbegränsningar, vilket innebär att de har nått maximalt antal API-anrop de kan göra inom en viss tidsperiod. QSS ökar inte API-hastighetsgränserna, men minskar kundernas oro för hastighetsbegränsningar genom att pusha rå QoS-data till deras slutpunkter istället för att kräva att kunderna själva hämtar datan.

#### <mark style="color:blå;">QSS gör det möjligt för kunder att konsumera rå Zoom QoS-data och felsöka med sitt föredragna nätverkshanteringssystem</mark>

Vissa kunder kan behöva bedöma nätverksprestanda på flera applikationer samtidigt. QSS låter dem övervaka Zoom QoS-data i en instrumentpanel tillsammans med annan data i deras applikationssvit, vilket ger ett flexibelt, skalbart sätt att konsumera Zoom QoS-data och sömlöst integrera det i egna instrumentpaneler.

#### <mark style="color:blå;">Zoom QoS-data överförs över TLS 1.2</mark>

QSS-data är krypterad i transit med TLS 1.2 eller högre. Slutpunkter måste använda ett giltigt certifikat från en certifikatutfärdare (CA). Webhook-förfrågningar inkluderar en signaturhuvud och en challenge-response-kontroll för verifiering.

För ytterligare säkerhet kommer kunder att uppmanas att [validera sina webhook-slutpunkter](https://marketplace.zoom.us/docs/api-reference/webhook-reference/#validate-your-webhook-endpoint) med en Challenge-Response Check (CRC). CRC kommer att bekräfta äganderätten och säkerheten för deras URL:er för händelsenotifikationer.

### Kunder kan börja konsumera QoS-data genom att skapa en applikation som kan ta emot QSS-händelser

Efter att en kund köpt tilläggsplanen QSS måste minst en användare på kontot ha utvecklarbehörigheter aktiverade. Kunder kan därefter använda följande tre steg för att skapa en webhook-applikation som kan prenumerera på QSS-händelser.

Kunder kan också välja att skaffa [Zoom Developer Pack](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) med en QSS-flagga aktiverad, vilket paketerar QSS med andra utvecklarverktyg.

{% stepper %}
{% step %}
**Skapa en Event Subscription-app (General eller Server-to-Server OAuth). Aktivera Event Subscriptions och välj QoS-händelser**

Kunder måste först skapa en General- eller Server-to-Server OAuth-app i [Zoom App Marketplace](https://marketplace.zoom.us/). Därefter aktiverar de Event Subscriptions och väljer de QoS-händelser de vill ta emot.

Nästa steg är att kunder anger destinationen för QSS-händelsenotifikationer genom att ange sin applikations Event notification endpoint-URL

{% hint style="info" %}
En endast webhook-app krävs inte för denna konfiguration. Zoom rekommenderar att skapa en General App.
{% endhint %}
{% endstep %}

{% step %}
**Prenumerera på QSS Webhook-händelser**

För att prenumerera på QSS-händelser måste kunder lägga till händelser och välja från listan över tillgängliga QSS **Händelsetyper**. Kunder kan välja en eller flera QSS-händelser innan de slutför processen och aktiverar sin applikation.

<figure><img src="https://460446308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0e6bcd7f34f9ebd6a9342919e58f15d0e72d51d0%2Fsubscribe-to-qss-webhook.png?alt=media" alt="Image of the Event types screen, focused on QSS options."><figcaption></figcaption></figure>

Du kan också hantera prenumerationer via Marketplace-gränssnittet eller genom att använda API-anrop:

* `POST /marketplace/app/event_subscription – skapa`
* `PATCH /{id} – prenumerera användare/konton`
* `DELETE /{id} – avprenumerera/ta bort`
* `GET /marketplace/app/event_subscription – lista`

För att autentisera via API, använd en token från Client Credentials Grant.
{% endstep %}

{% step %}
**Verifiera webhook-händelser**

Efter att ha konfigurerat händelseprenumerationer, säkerställ att både ägarskap av webhook-URL och äktheten av händelser valideras korrekt.

* **URL-validering**
  * När du först aktiverar händelseprenumerationer utför Zoom en Challenge–Response Check (CRC) för att verifiera ägarskapet av din webhook-slutpunkt. Denna process säkerställer att Zoom skickar data till en legitim destination som kontrolleras av din app. (Du kan inkludera CRC-hantering i ett tidigare installationssteg om så föredras.)
* **Händelsevalidering**
  * Varje inkommande händelsenotifikation bör verifieras av din applikation för att bekräfta att den härstammar från Zoom. Appen kan validera inkommande förfrågningar med hjälp av signaturhuvudet som tillhandahålls i varje webhook-händelse. Utvecklare som föredrar ett alternativ till standard signaturmetod kan använda ett av de andra stödda verifieringsalternativen som beskrivs i Zoom Developer Docs.
  * Använd Get Webhook Logs API för att granska upp till sju dagars data om webhook-leverans, inklusive status, antal omförsök och spårnings-ID.
    {% endstep %}
    {% endstepper %}

För fullständiga implementeringsdetaljer, se [QSS Implementation Guide](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) för utvecklare. För tekniska detaljer, se Event Subscription API, Webhook Logs API och guiderna för Client Credentials Grant-autentisering i Zoom Developer Docs.