服務品質訂閱說明

服務品質訂閱是一項加購產品，可將 Meeting、Webinar 與 Phone 的 QoS 資料傳送至客戶的第三方端點。

品質服務訂閱是一項附加產品，透過事件訂閱串流近乎即時的 Zoom 會議、網路研討會與 Zoom Phone QoS 遙測資料

Zoom 的品質服務訂閱（QSS）是一項附加產品，為 Zoom 會議、網路研討會與電話通話提供近乎即時的品質服務（QoS）資料。QSS 透過以每分鐘為單位的間隔傳送參與者層級的 QoS 事件，擴充了 Zoom 的產品功能（速率與彙總方式可能因設定而異）。客戶可運用這些豐富的資料串流來判斷網路環境是否影響 Zoom 的服務。

QSS 提供與 Zoom 儀表板和 API 中使用的相同底層 QoS 指標，但取樣與時間安排不同

現有的 Zoom 儀表板 提供網路效能與使用量指標，可協助客戶了解 Zoom 在網路環境中的運作情況。QSS 提供相同的 Zoom QoS 資料，但速率更快。由於取樣速率較快，彙總的 QoS 指標所顯示的值會與主要的 Zoom 儀表板不同。不過，這些指標仍可讓客戶將其設定到自己的儀表板視圖中，以便將 Zoom 資料與其他系統進行關聯。

下表說明透過 QSS 傳送至客戶端點的 QoS 資料。

	透過 QSS 傳送的 QoS 資料
品質指標	位元率、延遲、抖動、封包遺失、解析度、影格率、CPU 使用率
使用量指標	裝置、網路、信令區域、用戶端版本、音訊（輸入/輸出）、視訊（輸入/輸出）
頻率	每位參與者每分鐘約 1 個事件（依帳戶設定而定，可能是每個 QoS 指標或彙總後的集合）。
資料保留	事件傳遞記錄可透過 Webhook Logs API 保留 7 天；透過 API 端點取得的歷史 QoS 資料可能保留更久（視授權而定）。

不應將 Zoom 儀表板資料與透過 QSS 傳送至客戶第三方端點的資料進行比較

QSS 與 Zoom 儀表板提供兩種不同的 Zoom QoS 資料存取機制，兩者不應相互比較。雖然 Zoom 儀表板與 QSS 取自同一組 QoS 資料，但由於擷取時間與資料傳送頻率不同，兩種機制中的資料不會完全一致。

QSS 支援會議、網路研討會與電話通話的即時事件資料

QSS 會為帳戶中的所有使用者提供 Zoom 會議與網路研討會的 QoS 事件資料，以及 Zoom Phone 通話的 QoS 事件資料。由於 Zoom 不負責通話的最後一段，因此 QSS 只會為 Zoom Phone 通話提供帳戶層級的 QoS 事件資料，因而無法提供端到端進階參與者資料的完整可見性。

QSS 資料不包含外部參與者的資料

QSS 不會提供外部會議參與者的資料。不過，QSS 可協助找出哪一位內部會議參與者發生問題，以及問題為何，同時提供客戶排除問題所需的品質與使用量指標。

QSS 讓客戶可將 Zoom 儀表板中的原始 QoS 資料帶入現有工作流程

雖然 Zoom 客戶過去可使用 Zoom 儀表板或 API 等工具來檢視或擷取 Zoom QoS 資料，但 QSS 讓您可以透過事件訂閱（webhook 或 WebSocket）將 Zoom QoS 遙測資料串流至您的網路管理與監控平台。

QSS 會將近乎即時的 QoS 事件傳送到您已訂閱的端點，降低 API 輪詢與速率限制的影響

QSS 客戶可以訂閱會推送至其應用程式端點的即時 QoS 事件與資料，這有助於釋放 API 容量並最佳化網路使用率。QSS 是 Zoom 標準 webhook 服務 的延伸，因為它能以每分鐘 4 到 6 次的近乎即時速率將原始 QoS 資料傳送到端點。

QSS 讓客戶能在不觸發 API 速率限制的情況下，從 Zoom 儀表板存取近乎即時的 QoS 資料

API 服務是以請求為基礎，並使用「拉取」機制來收集應用程式或使用者所要求的資料。由於 API 需要重複呼叫以從 API 端點拉取資料，因此比 webhook 更耗費資源。

使用 Zoom API 從 Zoom 儀表板拉取 QoS 資料的客戶可能會遇到速率限制，這表示他們在特定時間內已達到可發出的 API 呼叫上限。QSS 不會提高 API 速率限制，但它會將原始 QoS 資料推送到客戶的端點，而不是要求客戶自行拉取資料，因此可降低客戶對速率限制的疑慮。

QSS 讓客戶可使用偏好的網路管理系統來消費原始 Zoom QoS 資料並進行疑難排解

某些客戶可能需要同時評估多個應用程式的網路效能。QSS 讓他們可以在儀表板中監控 Zoom QoS 資料，並與其應用程式套件中的其他資料並列，提供彈性且可擴充的方式來使用 Zoom QoS 資料，並將其無縫整合到自訂儀表板中。

Zoom QoS 資料會透過 TLS 1.2 傳輸

QSS 資料在傳輸中會使用 TLS 1.2 或更高版本進行加密。端點必須使用有效的憑證授權單位（CA）憑證。Webhook 請求包含簽章標頭與挑戰回應檢查以供驗證。

為了提高安全性，系統會提示客戶 驗證其 webhook 端點 並使用挑戰回應檢查（CRC）。CRC 將確認其事件通知端點 URL 的擁有權與安全性。

客戶可以透過建立可接收 QSS 事件的應用程式，開始使用 QoS 資料

客戶購買 QSS 附加方案後，帳戶中至少有一位使用者必須啟用開發者權限。接著，客戶可以依照以下三個步驟建立可訂閱 QSS 事件的 webhook 應用程式。

客戶也可以選擇 Zoom 開發者套件 並啟用 QSS 標記，將 QSS 與其他開發者工具整合在一起。

1

建立事件訂閱應用程式（一般或伺服器對伺服器 OAuth）。啟用事件訂閱並選取 QoS 事件

客戶必須先在 Zoom App Marketplace中建立一般或伺服器對伺服器 OAuth 應用程式。接著，啟用事件訂閱並選取想要接收的 QoS 事件。

接著，客戶必須輸入其應用程式的事件通知端點 URL，以指定 QSS 事件通知的目的地

此設定不需要僅限 Webhook 的應用程式。Zoom 建議建立一般應用程式。

2

訂閱 QSS Webhook 事件

若要訂閱 QSS 事件，客戶必須新增事件，並從可用的 QSS 事件類型清單中進行選擇。客戶可以在完成流程並啟用其應用程式之前，選擇一個或多個 QSS 事件。

您也可以透過 Marketplace UI 或使用 API 呼叫來管理訂閱：

• POST /marketplace/app/event_subscription – 建立

• PATCH /{id} – 訂閱使用者/帳戶

• DELETE /{id} – 取消訂閱/刪除

• GET /marketplace/app/event_subscription – 列出

若要透過 API 驗證，請使用來自 Client Credentials Grant 的權杖。

3

驗證 Webhook 事件

在設定事件訂閱之後，請確保 webhook URL 擁有權與事件真實性都已正確驗證。

• URL 驗證

  • 當您第一次啟用事件訂閱時，Zoom 會執行挑戰回應檢查（CRC），以驗證您的 webhook 端點擁有權。此程序可確保 Zoom 將資料傳送到由您的應用程式控制且合法的目的地。（如果您願意，也可以在較早的設定步驟中加入 CRC 處理。）

• 事件驗證

  • 應由您的應用程式驗證每個傳入的事件通知，以確認其是否來自 Zoom。應用程式可使用每個 webhook 事件中提供的簽章標頭來驗證傳入請求。偏好使用預設簽章方法以外驗證方式的開發者，可使用 Zoom 開發者文件中所述的其他支援驗證選項之一。

  • 使用 Get Webhook Logs API 檢閱最多七天的 webhook 傳遞資料，包括狀態、重試次數與追蹤 ID。

如需完整的實作細節，請參閱 QSS 實作指南 供開發者參考。若要查看技術細節，請參閱 Zoom 開發者文件中的 Event Subscription API、Webhook Logs API 與 Client Credentials Grant 驗證指南。