Förklaring av tjänstekvalitetsabonnemang

Tjänstekvalitetsabonnemang är en tilläggsprodukt som levererar QoS-data för möte, webbinarium och telefon till en kunds tredjepartsändpunkt.

tjänstekvalitetsabonnemang är en tilläggsprodukt som strömmar QoS-telemetri i nära realtid för Zoom Meetings, webbinarier och Zoom Phone via evenemangsprenumerationer

Zooms tjänstekvalitetsabonnemang (QSS) är en tilläggsprodukt som erbjuder data om tjänstekvalitet (QoS) i nära realtid för Zoom Meetings, webbinarier och telefonsamtal. QSS utökar Zooms produktfunktionalitet genom att skicka QoS-evenemang på nivå för deltagare med intervall på en minut (takten och aggregeringen 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.

QSS levererar samma underliggande QoS-mått som används i Zoom kontrollpaneler och API:er, men provtagningen och tidpunkterna skiljer sig åt

Den befintliga Zoom kontrollpanel tillhandahåller mätvärden för nätverksprestanda och användning, vilket kan hjälpa Kunder att förstå hur Zoom fungerar i en nätverksmiljö. QSS erbjuder samma Zoom QoS-data, men med högre frekvens. På grund av denna snabbare samplingsfrekvens kommer aggregerade QoS-mått att visa värden som skiljer sig från den huvudsakliga Zoom kontrollpanelen. Dessa mått kan dock fortfarande tillåta Kunder att konfigurera dem i sina egna kontrollpanelvyer för att korrelera Zoom-data med ytterligare system.

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

	QoS-data som levereras via QSS
Kvalitetsmått	Bitrate, latens, jitter, paketförlust, upplösning, bildfrekvens, CPU-användning
Användningsmått	Enhet, nätverk, signaleringsregion, klientversion, ljud (I/O), video (I/O)
Frekvens	Cirka 1 evenemang per minut, per deltagare (per QoS-mått eller aggregerad uppsättning beroende på kontoinställningarna).
Datalagring	Loggar för evenemangsleverans sparas i 7 dagar via Webhook Logs API; historiska QoS-data via API-ändpunkter kan finnas kvar längre (beroende på licens).

Data från Zoom kontrollpanel bör inte jämföras med data som levereras via QSS till en kunds tredjepartsändpunkt

QSS och Zoom kontrollpanel tillhandahåller två separata mekanismer för åtkomst till Zoom QoS-data som inte bör jämföras. Även om Zoom kontrollpanel och QSS hämtar från samma pool av QoS-data kommer data i respektive mekanism inte att stämma överens på grund av skillnader i hämtningstidpunkt och frekvensen för dataleverans.

QSS stöder evenemangsdata i realtid för möten, webbseminarier och telefonsamtal

QSS tillhandahåller QoS-evenemangsdata för alla användare på ett konto för Zoom Meetings och webbseminarier, samt för Zoom Phone-samtal. Eftersom Zoom inte hanterar den sista delen av samtalen tillhandahåller QSS endast QoS-evenemangsdata på kontonivå för Zoom Phone-samtal och kan därför inte ge full insyn i avancerad deltagardata från början till slut.

QSS-data inkluderar inte data för externa deltagare

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

QSS gör det möjligt för kunder att ta med rå QoS-data från Zoom kontrollpanel in i sina befintliga arbetsflöden

Även om Zoom-kunder historiskt har kunnat använda verktyg som Zoom kontrollpanel eller API:er för att visa eller hämta Zoom QoS-data, låter QSS dig strömma Zoom QoS-telemetri till dina plattformar för nätverkshantering och övervakning via evenemangsprenumerationer (webhook eller WebSocket).

QSS levererar QoS-evenemang i nära realtid till dina prenumererade ändpunkter, vilket minskar API-avfrågning och påverkan från hastighetsbegränsningar

QSS-kunder kan prenumerera på QoS-evenemang och data i nära realtid som kommer att skickas till deras ändpunkter för applikation, vilket hjälper till att frigöra API-kapacitet och optimera nätverksutnyttjandet. QSS är ett komplement till Zooms standard webhook-tjänst eftersom det kan skicka rå QoS-data till en ändpunkt med en nära realtidsfrekvens på 4 till 6 gånger per minut.

QSS gör det möjligt för kunder att få tillgång till QoS-data i nära realtid från Zoom kontrollpanel utan att stöta på API-begränsningar

API-tjänster är begärningsbaserade 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 resurskrävande än webhookar eftersom de kräver upprepade anrop för att hämta data från en API-ändpunkt.

Kunder som använder Zoom API:er att hämta QoS-data från Zoom kontrollpanel kan stöta på hastighetsbegränsningar, vilket innebär att de har nått det maximala antalet API-anrop de kan göra under en given tidsperiod. QSS ökar inte API-hastighetsgränserna, men det minskar oron hos Kunder kring hastighetsbegränsningar genom att skicka rå QoS-data till deras slutpunkter i stället för att kräva att Kunder själva hämtar data.

QSS gör det möjligt för Kunder att ta del av råa Zoom QoS-data och felsöka med sitt föredragna nätverkshanteringssystem

Vissa Kunder kan behöva bedöma sin nätverksprestanda i flera applikationer samtidigt. QSS gör det möjligt för dem att övervaka Zoom QoS-data i en kontrollpanel tillsammans med andra data i deras svit av applikationer, vilket ger ett flexibelt och skalbart sätt att ta del av Zoom QoS-data och sömlöst integrera den i anpassade kontrollpaneler.

Zoom QoS-data överförs via TLS 1.2

QSS-data krypteras under överföring 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 ett signaturhuvud och en utmanings-svarskontroll för verifiering.

För ytterligare säkerhet kommer Kunder att uppmanas att validera deras webhook-slutpunkter med en Challenge-Response Check (CRC). CRC kommer att bekräfta ägarskap och säkerhet för deras evenemang avisering ändpunkt webbadresser.

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

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

Kunder kan också välja Zoom Developer Pack med en aktiverad QSS-flagga, vilket paketerar QSS med andra utvecklarverktyg.

1

Skapa en app för evenemangsprenumeration (General eller Server-to-Server OAuth). Aktivera evenemangsprenumerationer och markera QoS-evenemang

Kunder måste först skapa en General- eller Server-to-Server OAuth-app i Zoom App Marketplace. Sedan aktiverar de evenemangsprenumerationer och markerar de QoS-evenemang de vill ta emot.

Nästa måste kunder ange målet för QSS-evenemangsaviseringarna genom att ange applikationens URL för evenemangsaviseringens ändpunkt

En app endast för webhookar krävs inte för denna konfiguration. Zoom rekommenderar att skapa en allmän app.

2

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änglig QSS evenemangstyper. Kunder kan markera ett eller flera QSS-händelser innan de slutför processen och aktiverar sin applikation.

Du kan också hantera prenumerationer via Marketplace-gränssnittet eller med API-anrop:

• POST /Marketplace/app/evenemang_prenumeration – skapa

• PATCH /{id} – prenumerera användare/konton

• DELETE /{id} – avregistrera/ta bort

• GET /marketplace/app/evenemang_subscription – lista

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

3

Verifiera webhook-händelser

Efter att ha konfigurerat evenemangsprenumerationer, se till att både webhook-URL-ägarskap och evenemangsautenticitet valideras korrekt.

• URL-validering

  • När du först aktiverar evenemangsprenumerationer utför Zoom en Challenge–Response Check (CRC) för att verifiera ägarskap för din webhook-ändpunkt. Den här processen 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 du föredrar det.)

• Validering av evenemang

  • Varje inkommande evenemangsavisering bör verifieras av din applikation för att bekräfta att den kom från Zoom. Din app kan validera inkommande begäranden med hjälp av signaturhuvudet som anges i varje webhook-evenemang. Utvecklare som föredrar ett alternativ till standardmetoden för signaturer kan använda ett av de andra verifieringsalternativen som beskrivs i Zoom Developer Docs.

  • Använd Get Webhook Logs API för att granska upp till sju dagars data om webhook-leveranser, inklusive status, antal återförsök och trace-ID.

För fullständiga implementeringsdetaljer, se QSS implementeringsguide för utvecklare. För tekniska detaljer, se guiderna för evenemangsprenumerations-API, webhook-loggar-API och Client Credentials Grant-autentisering i Zoom Developer Docs.