Tích hợp Zoom App
Ứng dụng ScribX cho Zoom kết nối tài khoản Zoom của bạn với ScribX để việc thu, phiên âm và tóm tắt cuộc họp bớt phiền toái hơn: trợ lý ghi chú ScribX có thể tự động nhận quyền ghi âm và tham gia thay mặt bạn.
Trang này có đầy đủ những gì bạn cần: thêm ứng dụng, dùng từng tính năng, gỡ ứng dụng và khắc phục sự cố.
Bạn không cần tích hợp này cho việc đó — gửi bot hoạt động ngay mà không cần kết nối tài khoản. Hãy kết nối Zoom app khi bạn muốn tự động nhận quyền ghi âm hoặc tham gia thay mặt bạn.
Thêm ứng dụng
Điều kiện cần
- Một tài khoản ScribX là thành viên của ít nhất một nhóm (đăng ký nếu bạn chưa có).
- Một tài khoản Zoom (gói nào cũng được). Nếu quản trị viên Zoom của bạn hạn chế việc cài ứng dụng, họ có thể cần phê duyệt trước ScribX trên Zoom Marketplace.
Các bước
- Đăng nhập ScribX và mở Cài đặt nhóm → Tích hợp.
- Trong mục Zoom, bấm Kết nối Zoom của bạn.
- Bạn được chuyển đến zoom.us để đăng nhập (nếu chưa) và xem các quyền mà ScribX yêu cầu.
- Xem lại các quyền rồi bấm Allow.
- Bạn được đưa trở lại ScribX. Tài khoản Zoom của bạn giờ hiển thị trong Tài khoản đã kết nối ở tab Tích hợp — thiết lập chỉ có vậy.
Mỗi đồng đội muốn ScribX thao tác trên tài khoản Zoom của chính họ sẽ lặp lại các bước trên bằng đăng nhập Zoom của họ; kết nối gắn với từng người dùng và hiển thị trên mọi nhóm của họ.
Gặp trục trặc khi thiết lập? Xem Khắc phục sự cố bên dưới.
Dành cho quản trị viên tổ chức
Quản trị viên tổ chức chọn tổ chức kết nối qua ứng dụng Zoom Marketplace nào, trong Cài đặt tổ chức → Nền tảng họp → Zoom:
- ScribX app (mặc định) — ứng dụng ScribX dùng chung được phát hành trên Zoom Marketplace. Không cần cấu hình gì; thành viên chỉ việc kết nối như hướng dẫn ở trên.
- Zoom app của bạn — dùng ứng dụng Zoom OAuth riêng của tổ chức: nhập Client ID, Client secret và (tuỳ chọn) webhook secret, rồi bấm Kết nối tài khoản. Các nhóm vẫn có thể ghi đè bằng ứng dụng cấp nhóm trong Cài đặt nhóm → Tích hợp.
Dùng tích hợp
Tự động nhận quyền ghi âm
Tình huống dùng: bình thường, khi bot tham gia cuộc họp Zoom, chủ trì phải cấp quyền ghi âm ngay trong cuộc họp. Với tài khoản Zoom đã kết nối, ScribX xin Zoom một local recording token, nên trợ lý ghi chú bắt đầu ghi mà không cần hỏi chủ trì — và có thể bỏ qua phòng chờ.
Điều kiện cần: cuộc họp do một người dùng đã kết nối tài khoản Zoom chủ trì (hoặc tạo bot), và gói Zoom của tài khoản đó hỗ trợ local recording token.
Kết quả mong đợi: trợ lý ScribX tham gia, vượt qua phòng chờ và bắt đầu ghi ngay lập tức — chủ trì không thấy hộp thoại xin quyền nào.
Tham gia thay mặt bạn
Tình huống dùng: ScribX có thể tham gia bằng token on-behalf gắn với tài khoản Zoom đã kết nối của bạn, giúp trợ lý ghi chú được nhận diện và cho vào họp thuận lợi hơn trong các cuộc họp bạn tham dự.
Điều kiện cần: tài khoản Zoom đã kết nối của bạn hỗ trợ token on-behalf (có huy hiệu OBF trong tab Tích hợp) và bạn là người tham dự cuộc họp. Khi nhiều đồng đội cùng kết nối, ScribX ưu tiên tài khoản của người đã lên lịch trợ lý, rồi đến chủ trì cuộc họp, rồi đến mặc định của nhóm.
Kết quả mong đợi: trợ lý tham gia với liên kết đến tài khoản của bạn thay vì hoàn toàn ẩn danh.
Nhận diện cuộc họp
Tình huống dùng: sau khi kết nối, ScribX nắm được các cuộc họp bạn tạo (qua sự kiện meeting.created của Zoom và đồng bộ định kỳ các cuộc họp sắp tới của bạn) để tự động khớp cuộc họp với tài khoản của bạn — đây chính là thứ giúp hai tính năng ở trên chọn đúng người.
Điều kiện cần: không cần gì ngoài một tài khoản đã kết nối; mọi thứ diễn ra ở nền.
Kết quả mong đợi: các cuộc họp bạn chủ trì được gán về kết nối của bạn; không có giao diện riêng nào ngoài việc các tính năng khác hoạt động đúng.
Gỡ ứng dụng
Bạn có thể ngắt kết nối bất cứ lúc nào từ phía Zoom:
- Đăng nhập Zoom App Marketplace.
- Bấm Manage → Added Apps (hoặc mở trang ứng dụng đã cài).
- Tìm ScribX và bấm Remove.
Điều gì xảy ra khi bạn gỡ ứng dụng — Zoom báo cho ScribX ngay khi bạn thu hồi quyền, và ScribX lập tức:
- Xoá token OAuth Zoom của bạn. ScribX không còn cách nào truy cập tài khoản Zoom của bạn nữa.
- Xoá các liên kết cuộc họp – tài khoản đã học được từ tài khoản Zoom của bạn.
- Xác nhận việc xoá dữ liệu với Zoom (thông báo tuân thủ dữ liệu của Zoom) trong vòng 24 giờ.
Sau đó kết nối trên ScribX hiển thị là Đã ngắt kết nối. Các bản ghi, bản phiên âm và tóm tắt đã thu trước đó không bị xoá khi gỡ Zoom app — chúng thuộc về không gian làm việc ScribX của bạn và tuân theo cài đặt lưu trữ dữ liệu của nhóm, nơi bạn có thể xoá bất cứ lúc nào. Các cuộc họp chỉ đơn giản là không còn những tính năng ở trên; gửi bot vẫn hoạt động mà không cần tích hợp.
Quản trị viên tổ chức đang dùng chế độ Zoom app của bạn cũng có thể gỡ ứng dụng cấp tổ chức trong Cài đặt tổ chức → Nền tảng họp → Zoom → Gỡ ứng dụng; các nhóm khi đó quay về ứng dụng ScribX được quản lý sẵn.
Muốn kết nối lại sau này, chỉ cần lặp lại phần Thêm ứng dụng.
Khắc phục sự cố
- Màn hình Allow báo lỗi hoặc chuyển đến trang hỏng — tổ chức của bạn có thể đang ở chế độ Zoom app của bạn với thông tin đăng nhập chưa đầy đủ. Nhờ quản trị viên tổ chức kiểm tra Cài đặt tổ chức → Nền tảng họp → Zoom, hoặc chuyển về chế độ ScribX app.
- Không thấy nút "Kết nối Zoom của bạn" — có thể bạn không có quyền vào tab Tích hợp của nhóm; hãy hỏi quản trị viên nhóm.
- Trợ lý vẫn xin chủ trì quyền ghi âm — chủ trì cuộc họp chưa kết nối tài khoản (hoặc gói Zoom của chủ trì không cấp local recording token). Hãy kết nối tài khoản Zoom của chủ trì, hoặc cấp quyền trong cuộc họp như bình thường.
- Vấn đề khác — xem hướng dẫn khắc phục sự cố chung hoặc email support@scribx.app.