如何向您的 Zoom 与会者发送 Fyrebox 测验

0开始之前

在将 Fyrebox 连接到 Zoom 之前，有几件事需要准备好。请确保您拥有：

• 一个 Fyrebox 账户，并且至少已经创建好一个准备发送的测验。如果您还没有账户，可以免费注册并使用我们的任意模板。
• 一个 Pro 或更高级别的 Zoom 账户。Zoom 不会向 Basic（免费）账户开放与会者列表，因此会后测验发送仅适用于 Pro、Business 或 Enterprise 套餐。
• Zoom 账户中至少安排了一个即将进行的会议或网络研讨会 — 这样 Fyrebox 才知道要将测验关联到哪一场会话。

1在 Fyrebox 中打开“集成”面板

登录 Fyrebox 并进入“账户 → 集成”。您会看到 Fyrebox 可以连接的第三方服务列表。找到 Zoom 卡片，点击「连接 Zoom」。这将在新标签页中打开 Zoom 的安全授权窗口。

2在 Zoom 中授权 Fyrebox

Zoom 会请您确认是否允许 Fyrebox 访问您的账户。查看所请求的权限，如果尚未登录，请使用您的 Zoom 凭据登录，然后点击「允许」。您将被重定向回 Fyrebox，集成会被标记为已连接。这一步只需进行一次。

Fyrebox 请求的权限及原因

• user:read:user —检测您的 Zoom 套餐级别（Basic / Pro / Business），以便编辑器在您的账户无法使用该功能时提醒您。
• meeting:read:list_upcoming_meetings —help_zoom_scope_meeting_list
• meeting:read:list_past_participants —help_zoom_scope_meeting_participants
• webinar:read:list_webinars —help_zoom_scope_webinar_list
• webinar:read:list_past_participants —help_zoom_scope_webinar_participants

3将测验附加到会议或网络研讨会

打开您想要发送给 Zoom 与会者的测验，并在测验编辑器中点击“集成”选项卡。您会看到已连接的 Zoom 账户，以及即将进行的会议和网络研讨会列表。在任意会议旁勾选复选框，即可将该测验附加到该会议。您也可以勾选「每次会议结束后发送」，一键将测验应用到您未来所有的 Zoom 会议。

4照常主持您的会议

会议进行时您无需做任何额外操作。请像往常一样主持您的 Zoom 会议或网络研讨会。一旦 Zoom 将会议标记为结束，它就会通知 Fyrebox，Fyrebox 从 Zoom 获取与会者列表，并向每位注册参与者发送带有测验链接的邮件。整个后续流程通常在通话结束后一分钟内完成。

5查看结果

在 Fyrebox 中打开您的测验，点击“结果”选项卡。您会看到每位完成测验的与会者及其分数、答案和所用时间。利用这些数据可以发现培训差距、筛选网络研讨会的潜在客户或衡量满意度 — 取决于您设计测验的目的。结果会随着参与者完成测验实时更新。

故障排除

如果测验邮件没有按预期发送，问题几乎总是以下几种情况之一：

• 会议结束后没有发送任何邮件。
  这通常意味着该会议未启用注册（因此 Zoom 没有可分享的与会者邮件），或者您的 Zoom 账户处于 Basic 套餐（会阻止获取与会者列表）。打开测验编辑器查看警告，或在 zoom.us/account 查看您的 Zoom 套餐。
• 一些与会者收到了测验，另一些没有。
  Zoom 只将已注册的参与者纳入与会者列表。任何未经注册直接加入会议的人都不会出现在列表中，因此 Fyrebox 无法向他们发送邮件。主持人（您本人）也会被有意排除 — 您不需要在自己的收件箱中收到您创建的测验。
• 我的测验编辑器中的 Zoom 部分是空的。
  您可能已断开此集成，或者您的 Zoom 令牌已过期。请进入“账户 → 集成”并重新连接 Zoom，之后连接会自动刷新。
• 我没有看到我的网络研讨会被列出。
  网络研讨会是 Zoom 的付费附加组件，只有在您的账户拥有 Webinars 许可证时才会出现。如果您只有普通会议也没有关系 — 大多数用户实际使用的就是会议列表。
• 我还是没解决 — 接下来怎么办？
  请通过支持页面给我们发送消息，附上您的 Zoom 会议名称及大致的结束时间。我们会在我们这一侧检查集成日志，并在一个工作日内回复您。

如何断开连接或卸载

您可以在两个地方断开此集成 — Fyrebox 和 Zoom App Marketplace。任一操作都会切断连接；如需彻底清理，建议两边都执行。

在 Fyrebox 内断开连接

进入“账户 → 集成”，找到 Zoom 卡片，点击「断开连接」。这会立即从 Fyrebox 数据库中删除您的 Zoom 访问令牌。已附加到 Zoom 会议的测验仍会保留在您的账户中 — 只会移除触发器。

从 Zoom App Marketplace 卸载

进入 marketplace.zoom.us → Manage → Installed Apps，在列表中找到 Fyrebox，点击「Uninstall」。Zoom 将向 Fyrebox 发送取消授权信号，我们会自动删除您的令牌并移除我们这一侧的集成。如需完全干净地卸载，建议使用此方式。

隐私和数据处理

Fyrebox 仅读取交付测验所需的内容，其他内容都会回归给您。以下是我们具体接触到的数据：

Fyrebox 从 Zoom 读取的内容

• 您即将进行的会议和网络研讨会列表，以便您选择由哪些触发测验。
• 会议结束后的与会者列表 — 姓名、邮件地址以及加入/离开的时间戳 — 用于确定向谁发送测验。
• 您的 Zoom 用户资料（姓名、邮件、套餐类型），以便编辑器在您的账户无法使用会后功能时进行提醒。

Fyrebox 存储的内容

• 您的 Zoom OAuth 令牌（以便集成在会话之间持续工作）。令牌在静态存储时是加密的。
• 一份记录，说明哪个测验在哪场会议后发送给了哪位与会者 — 以便我们去重重试并让您查看谁完成了测验。除集成正常工作所必需的内容外，我们不会存储任何与会者数据。

Fyrebox 永远不会访问的内容

• 会议录制、转录或任何视频/音频内容。
• 会议内聊天消息或共享文件。
• 除连接集成的主持人之外的任何其他会议、网络研讨会或联系人。