# 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="/files/881abc763bd1697bbfc1420b738089077206ddff" 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.


---

# Agent Instructions: 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/sv/adminhornan/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.
