# 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/
- 转到 开发 > 构建应用程序 → 选择 ** 服务器到服务器 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
