Phóng

  # Tích hợp bản ghi Zoom Dễ dàng nhận và tự động hóa bản ghi cuộc họp Zoom trong Botpress đối với các cuộc họp do người dùng Zoom cụ thể tổ chức. ## Cách thức hoạt động 1. **Cuộc họp Zoom kết thúc** → Zoom gửi một webhook khi bản ghi đã sẵn sàng. 2. **Bộ lọc tích hợp `host_id`** → Chỉ cho phép các sự kiện từ người dùng Zoom được chỉ định. 3. **Bản ghi được tải xuống và dọn dẹp** → Đã tải xuống từ Zoom và chuyển đổi thành văn bản thuần túy. 4. **Sự kiện được phát ra** → Sự kiện `transcriptReceived` với `meetingUUID` và `transcript` có sẵn cho các luồng của bạn. --- ## Cách sử dụng - **Kích hoạt quy trình làm việc** → Thêm thẻ "Lắng nghe sự kiện" cho `transcriptReceived`. - **Truy cập dữ liệu** → Sử dụng `event.payload.meetingUUID` và `event.payload.transcript` trong các luồng. - **Lưu trữ bản ghi** → Lưu vào bảng để phân tích hoặc báo cáo sau. --- ## Điều kiện tiên quyết Bạn phải là: - Chủ sở hữu tài khoản Zoom **, **quản trị viên** hoặc có vai trò **“Zoom dành cho nhà phát triển”** để có thể tạo Ứng dụng Zoom OAuth - Đang sử dụng **gói Zoom cao cấp** (gói miễn phí không hỗ trợ ghi âm đám mây) --- ## Thiết lập từng bước ### 1. Tạo Ứng dụng Zoom OAuth - Truy cập: [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Vào **Phát triển > Xây dựng ứng dụng** → Chọn **OAuth từ máy chủ đến máy chủ** → Đặt tên cho ứng dụng của bạn - Trên trang **Thông tin xác thực ứng dụng**, hãy sao chép: - **ID tài khoản** - **ID khách hàng** - **Bí mật khách hàng** Bạn sẽ sử dụng những thông tin này trong Botpress cấu hình tích hợp sau. - Trong **Thông tin**, điền thông tin cần thiết về bạn và ứng dụng. - Trong **Tính năng**, sao chép **Mã thông báo bí mật** - Trong **Phạm vi**, thêm: cloud_recording:read:list_user_recordings:admin cloud_recording:read:list_recording_files:admin cloud_recording:read:recording:admin - Kích hoạt ứng dụng trong tab **Kích hoạt** ### 2. Lấy `host_id` của Zoom Bạn có thể tìm thấy `host_id` của Zoom trực tiếp từ cổng thông tin web Zoom. #### Các bước: 1. Đăng nhập vào tài khoản Zoom của bạn và điều hướng đến: **Bảng điều khiển quản trị Zoom > Quản lý người dùng > Người dùng** 2. Nhấp vào tên người dùng mà bạn muốn lấy `host_id`. 3. Nhìn vào URL trên thanh địa chỉ của trình duyệt. Nó sẽ ở định dạng này: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile bạn muốn sao chép xxxxxxxxxxxx vì đó là host_id của bạn --- ### 3. Cấu hình Botpress Tích hợp - Cài đặt tích hợp này vào Bot của bạn - Dán: - `Zoom Client ID` - `Zoom Client Secret` - `Zoom Account ID` - `Secret Token` - `Allowed Zoom User IDs` → Dán `host_id` của bạn (bạn có thể bao gồm nhiều) Nhấp vào **Lưu cấu hình**. --- ### 4. Đặt Webhook trong Zoom Quay lại ứng dụng Zoom OAuth của bạn: - Đi tới **Tính năng** → Bật **Đăng ký sự kiện** - Tên: `Đã nhận bản ghi` (Cũng có thể chọn tên khác) - Phương pháp: ` Webhook ` - URL điểm cuối: sử dụng ** Botpress URL tích hợp** - Thêm sự kiện: - Trong **Ghi âm**: - `Tất cả các bản ghi đã hoàn tất` - `Các tệp bản ghi đã hoàn tất` - Nhấp vào **Xong** - Nhấp vào **Xác thực** bên cạnh URL điểm cuối (bạn sẽ thấy Đã xác thực) - Nhấp vào **Lưu** --- ## Xong! Của bạn Botpress bot hiện sẽ nhận được bản ghi cho những người dùng Zoom được phép khi quá trình ghi hình đám mây hoàn tất. Hãy đảm bảo: - Bạn **ghi hình lên đám mây** - Bạn đang sử dụng **gói Zoom trả phí** - Bạn đã thêm chính xác tất cả các `host_id` dự định