# Zoom 成绩单集成 在Botpress 中轻松接收由特定 Zoom 用户主持的会议的 Zoom 会议副本并将其自动化。 ## 工作原理 1.**Zoom 会议结束** → 当副本准备就绪时，Zoom 会发送一个webhook 。 2.**集成过滤器 `host_id`** → 只允许来自指定 Zoom 用户的事件。 3.**获取并清理记录稿** → 从 Zoom 下载并转换为纯文本。 4.发出**事件** → `transcriptReceived`事件包含`meetingUUID`和`transcript`，可供您的流程使用。 --- ## 使用方法 - 触发工作流** → 为 `transcriptReceived` 添加 "监听事件 "卡。 - 获取数据** → 在流程中使用 `event.payload.meetingUUID` 和 `event.payload.transcript` 。 - 存储记录誊本** → 保存到表中，以便稍后进行分析或报告。 --- ## 先决条件 您必须是 - Zoom **帳戶擁有者**、**管理員**，或擁有**「Zoom 開發者」角色**，才能建立 Zoom OAuth 應用程式 - 使用**Zoom 高级计划**（免费层级不支持云录音） --- ## 分步设置 ### 1.创建一个 Zoom OAuth 应用程序 - 访问：[https://marketplace.zoom.us/](https://marketplace.zoom.us/) - 转到 **开发 > 构建应用程序** → 选择 ** 服务器到服务器 OAuth** → 为应用程序命名 - 在 "**应用程序凭据**"页面，复制 - 账户 ID - 客户 ID - 客户端密文 稍后您将在Botpress 集成配置中使用这些内容。 - 在**信息**中，填写关于您自己和应用程序的必要信息。 - 在**特性**中，复制**秘密令牌** - 在**范围**中，添加 cloud_recording:read:list_user_recordings:admin 云录音:读取:录音文件列表:管理员 云录音:读取:录音:管理员 - 在**激活**选项卡下激活应用程序 ### 2.获取变焦 `host_id 您可以直接从 Zoom 门户网站找到您的 Zoom `host_id`。 #### 步骤： 1.登录您的 Zoom 帐户并导航至： **Zoom 管理面板 > 用户管理 > 用户** 2.单击要获取 `host_id` 的用户名。 3.查看浏览器地址栏中的 URL。格式如下 https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile 你要复制 xxxxxxxxxxxxxx，因为这是你的 host_id --- ### 3.配置Botpress 集成 - 将此集成安装到您的机器人中 - 粘贴 - Zoom 客户 ID - oom 客户秘密 - oom 帐户 ID - `秘密令牌 - 允许的 Zoom 用户 ID` → 粘贴您的 `host_id` (您可以包含多个) 单击 **保存配置**。 --- ### 4.在 Zoom 中设置Webhook 回到您的 Zoom OAuth 应用程序： - 转到 **功能** → 启用 **事件订阅** - 名称：已收到转录本"（也可选择其他名称） - 方法：`Webhook - 端点 URL：使用**Botpress 集成 URL** - 添加事件： - 在 **Recording** 下： - 所有录音已完成 - 录制副本文件已完成 - 点击**完成** - 单击端点 URL 旁边的**验证**（您应看到已验证） - 单击**保存** --- ## 完成！ 现在，当云录音完成时，你的Botpress 机器人将为允许的 Zoom 用户接收录音誊本。确保 - 您**在云端录音** - 您使用的是**付费的 Zoom 计划** - 您已正确添加了所有预定的 "host_id
