Giải thích về Gói đăng ký chất lượng dịch vụ

Gói đăng ký chất lượng dịch vụ là một sản phẩm tiện ích mở rộng cung cấp dữ liệu QoS của cuộc họp, hội thảo trực tuyến và Điện thoại tới điểm cuối bên thứ ba của khách hàng.

Gói đăng ký chất lượng dịch vụ là một sản phẩm tiện ích mở rộng truyền dữ liệu đo từ xa QoS gần theo thời gian thực cho Zoom Meetings, hội thảo trực tuyến và Zoom Phone thông qua các gói đăng ký sự kiện

Gói đăng ký chất lượng dịch vụ của Zoom (QSS) là một sản phẩm tiện ích mở rộng cung cấp dữ liệu chất lượng dịch vụ (QoS) gần theo thời gian thực cho Zoom Meetings, hội thảo trực tuyến và các cuộc gọi điện thoại. QSS mở rộng chức năng sản phẩm của Zoom bằng cách gửi các Sự kiện QoS ở cấp người tham gia theo các khoảng thời gian tính bằng phút (tốc độ và mức tổng hợp có thể thay đổi tùy theo Cấu hình). Khách hàng có thể sử dụng luồng dữ liệu phong phú này để xác định liệu môi trường mạng có ảnh hưởng đến các dịch vụ của Zoom hay không.

QSS cung cấp các chỉ số QoS cơ bản giống như được sử dụng trong Bảng điều khiển Zoom và API, nhưng việc lấy mẫu và thời gian thì khác nhau

Bảng điều khiển Zoom hiện có Bảng điều khiển Zoom cung cấp các chỉ số về hiệu suất mạng và mức sử dụng, có thể giúp Khách hàng hiểu Zoom đang hoạt động như thế nào trong môi trường mạng. QSS cung cấp cùng dữ liệu QoS của Zoom, nhưng với tốc độ nhanh hơn. Do tốc độ lấy mẫu nhanh hơn này, các chỉ số QoS tổng hợp sẽ Hiển thị các giá trị khác với Bảng điều khiển Zoom chính. Tuy nhiên, những chỉ số này vẫn Cho phép Khách hàng Cấu hình chúng vào các chế độ xem bảng điều khiển riêng của họ để đối chiếu dữ liệu Zoom với các hệ thống bổ sung.

Bảng dưới đây mô tả dữ liệu QoS được cung cấp tới các điểm cuối của khách hàng thông qua QSS.

	Dữ liệu QoS được cung cấp qua QSS
Các chỉ số chất lượng	Tốc độ bit, độ trễ, độ dao động, mất gói, độ phân giải, tốc độ khung hình, mức sử dụng CPU
Chỉ số sử dụng	Thiết bị, Mạng, Khu vực tín hiệu, Phiên bản khách hàng, Âm thanh (I/O), Video (I/O)
Tần suất	Khoảng 1 Sự kiện mỗi phút, cho mỗi người tham gia (cho mỗi chỉ số QoS hoặc tập hợp được tổng hợp tùy thuộc vào cài đặt tài khoản).
Lưu giữ dữ liệu	Nhật ký phân phối Sự kiện được lưu giữ trong 7 ngày thông qua API Nhật ký webhook; dữ liệu QoS lịch sử qua các điểm cuối API có thể được lưu lâu hơn (tùy thuộc vào giấy phép).

Dữ liệu của Zoom Bảng điều khiển không nên được so sánh với dữ liệu được phân phối qua QSS tới điểm cuối của bên thứ ba của khách hàng

QSS và Zoom Bảng điều khiển cung cấp hai cơ chế riêng biệt để truy cập dữ liệu QoS Zoom và không nên được so sánh. Mặc dù Zoom Bảng điều khiển và QSS lấy từ cùng một nguồn dữ liệu QoS, dữ liệu trong mỗi cơ chế sẽ không khớp do khác biệt về thời điểm truy xuất và tần suất phân phối dữ liệu.

QSS hỗ trợ dữ liệu Sự kiện theo thời gian thực cho Cuộc họp, Hội thảo trên web và các cuộc gọi Zoom Phone

QSS cung cấp dữ liệu Sự kiện QoS cho tất cả người dùng trên một tài khoản đối với Zoom Meetings và Hội thảo trên web, cũng như đối với các cuộc gọi Zoom Phone. Vì Zoom không quản lý chặng cuối của cuộc gọi, QSS chỉ cung cấp dữ liệu Sự kiện QoS ở cấp độ tài khoản cho các cuộc gọi Zoom Phone và do đó không thể cung cấp khả năng hiển thị đầy đủ vào dữ liệu người tham gia nâng cao đầu cuối.

Dữ liệu QSS không bao gồm dữ liệu cho người tham gia bên ngoài

QSS không cung cấp dữ liệu cho người tham gia cuộc họp bên ngoài. Tuy nhiên, QSS có thể giúp xác định chính xác người tham gia cuộc họp nội bộ nào đã gặp sự cố và sự cố đó là gì, cũng như các chỉ số chất lượng và mức sử dụng mà Khách hàng sẽ cần để khắc phục sự cố.

QSS cho phép Khách hàng đưa dữ liệu QoS thô từ Bảng điều khiển Zoom vào quy trình làm việc hiện có của họ

Mặc dù trước đây Khách hàng Zoom đã có thể sử dụng các công cụ như Bảng điều khiển Zoom hoặc API để xem hoặc truy xuất dữ liệu QoS Zoom, QSS cho phép bạn truyền dữ liệu đo từ xa QoS Zoom vào các nền tảng quản lý và giám sát mạng của mình thông qua đăng ký Sự kiện (webhook hoặc WebSocket).

QSS cung cấp các sự kiện QoS gần thời gian thực tới các điểm cuối đã đăng ký của bạn, giúp giảm việc thăm dò API và tác động của giới hạn tần suất

Khách hàng QSS có thể đăng ký các sự kiện và dữ liệu QoS theo thời gian thực, dữ liệu này sẽ được đẩy tới các điểm cuối của ứng dụng của họ, giúp giải phóng dung lượng API và tối ưu hóa việc sử dụng mạng. QSS là một phần bổ sung cho dịch vụ webhook tiêu chuẩn của Zoom dịch vụ webhook tiêu chuẩn vì nó có thể gửi dữ liệu QoS thô đến một điểm cuối với tốc độ gần thời gian thực là 4 đến 6 lần mỗi phút.

QSS cho phép Khách hàng truy cập dữ liệu QoS gần thời gian thực từ Bảng điều khiển Zoom mà không chạm tới giới hạn tần suất của API

Các dịch vụ API dựa trên yêu cầu và sử dụng cơ chế “kéo” để thu thập dữ liệu được một ứng dụng hoặc người dùng yêu cầu. API tiêu tốn nhiều tài nguyên hơn webhook vì chúng yêu cầu gọi lặp lại để kéo dữ liệu từ một điểm cuối API.

Khách hàng sử dụng Zoom API để kéo dữ liệu QoS từ Zoom Bảng điều khiển có thể gặp giới hạn tốc độ, nghĩa là họ đã đạt đến số lượng cuộc gọi API tối đa mà họ có thể thực hiện trong một khoảng thời gian nhất định. QSS không làm tăng giới hạn tốc độ API, nhưng nó giảm bớt lo ngại về giới hạn tốc độ của Khách hàng bằng cách đẩy dữ liệu QoS thô tới các điểm cuối của họ thay vì yêu cầu Khách hàng tự kéo dữ liệu.

QSS cho phép Khách hàng sử dụng dữ liệu QoS thô của Zoom và khắc phục sự cố bằng cách sử dụng hệ thống quản lý mạng mà họ ưa thích

Một số Khách hàng có thể cần đánh giá hiệu suất mạng của họ trên nhiều ứng dụng cùng lúc. QSS cho phép họ giám sát dữ liệu QoS của Zoom trong một Bảng điều khiển cùng với các dữ liệu khác trong bộ ứng dụng của họ, cung cấp một cách linh hoạt, có khả năng mở rộng để sử dụng dữ liệu QoS của Zoom và tích hợp liền mạch vào các Bảng điều khiển tùy chỉnh.

Dữ liệu QoS của Zoom được truyền qua TLS 1.2

Dữ liệu QSS được mã hóa trong quá trình truyền bằng TLS 1.2 hoặc cao hơn. Các điểm cuối phải sử dụng chứng chỉ Cơ quan Chứng thực (CA) hợp lệ. Các yêu cầu webhook bao gồm một tiêu đề chữ ký và kiểm tra xác nhận để Xác minh.

Để tăng cường bảo mật, Khách hàng sẽ được nhắc để Xác minh các điểm cuối webhook của họ bằng cách sử dụng Kiểm tra Thử thách-Đáp ứng (CRC). CRC sẽ xác nhận quyền sở hữu và bảo mật của URL điểm cuối Thông báo Sự kiện của họ.

Khách hàng có thể bắt đầu tiêu thụ dữ liệu QoS bằng cách tạo một ứng dụng có thể nhận các sự kiện QSS

Sau khi Khách hàng mua gói tiện ích mở rộng QSS, ít nhất một người dùng trên tài khoản phải được bật quyền nhà phát triển. Sau đó, Khách hàng có thể dùng ba bước sau để tạo một ứng dụng webhook có thể đăng ký nhận các sự kiện QSS.

Khách hàng cũng có thể theo đuổi Zoom Developer Pack với cờ QSS được bật, điều này gói QSS cùng với các công cụ dành cho nhà phát triển khác.

1

Tạo một ứng dụng Đăng ký Sự kiện (General hoặc Server-to-Server OAuth). Bật Đăng ký Sự kiện và Chọn các Sự kiện QoS

Khách hàng trước tiên phải tạo một ứng dụng OAuth General hoặc Server-to-Server trong Zoom App Marketplace. Sau đó, họ sẽ Bật Đăng ký Sự kiện và Chọn các Sự kiện QoS họ muốn nhận.

Tiếp, Khách hàng phải chỉ định điểm đến cho các thông báo sự kiện QSS bằng cách nhập URL điểm cuối Thông báo Sự kiện của ứng dụng của họ

Không cần một ứng dụng chỉ webhook cho cấu hình này. Zoom khuyến nghị tạo một ứng dụng Chung.

2

Đăng ký nhận sự kiện QSS webhook

Để đăng ký các sự kiện QSS, Khách hàng phải Thêm sự kiện và Chọn từ danh sách QSS Đang rảnh Các loại Sự kiện. Khách hàng có thể Chọn một hoặc nhiều sự kiện QSS trước khi hoàn tất quy trình và kích hoạt ứng dụng của họ.

Bạn cũng có thể quản lý các gói đăng ký thông qua giao diện Marketplace hoặc bằng cách sử dụng các lệnh gọi API:

• POST /marketplace/ứng dụng/Sự kiện_subscription – tạo

• PATCH /{id} – đăng ký người dùng/tài khoản

• DELETE /{id} – hủy đăng ký/xóa

• GET /marketplace/ứng dụng/Sự kiện_subscription – danh sách

Để xác thực qua API, hãy sử dụng một mã thông báo từ Client Credentials Grant.

3

Xác minh các sự kiện Webhook

Sau khi cấu hình các đăng ký Sự kiện, hãy đảm bảo rằng cả quyền sở hữu URL webhook và tính xác thực của sự kiện đều được xác minh đúng cách.

• Xác minh URL

  • Khi bạn lần đầu Bật đăng ký Sự kiện, Zoom sẽ thực hiện một Kiểm tra Thách thức–Phản hồi (CRC) để xác minh quyền sở hữu của điểm cuối webhook của bạn. Quy trình này đảm bảo rằng Zoom đang gửi dữ liệu đến một đích hợp lệ do ứng dụng của bạn kiểm soát. (Bạn có thể bao gồm xử lý CRC trong một bước thiết lập sớm hơn nếu muốn.)

• Xác minh Sự kiện

  • Mỗi thông báo Sự kiện đến phải được ứng dụng của bạn xác minh để xác nhận rằng nó xuất phát từ Zoom. ứng dụng có thể xác thực các yêu cầu đến bằng cách sử dụng tiêu đề chữ ký được cung cấp trong mỗi sự kiện webhook. Các nhà phát triển muốn dùng một phương án thay thế cho phương pháp chữ ký mặc định có thể sử dụng một trong các tùy chọn Xác minh được hỗ trợ khác được mô tả trong Tài liệu dành cho nhà phát triển Zoom.

  • Sử dụng API Nhật ký Webhook Get Webhook Logs để xem lại dữ liệu phân phối webhook trong tối đa bảy ngày, bao gồm trạng thái, số lần thử lại và trace ID.

Để biết đầy đủ chi tiết triển khai, vui lòng tham khảo Hướng dẫn triển khai QSS dành cho nhà phát triển. Để biết chi tiết kỹ thuật, hãy xem các hướng dẫn API Đăng ký Sự kiện, API Nhật ký webhook và hướng dẫn xác thực Client Credentials Grant trong Zoom Developer Docs.