跳到主要内容

Zoom Team Chat 配置手册

最近更新 2026/10/07

一、前置条件​

  • 拥有 Zoom 账号的 Owner 或 Admin 权限，可以创建和安装应用
  • 拥有 Agentic Engine 平台的管理员权限
  • Agentic Engine 已配置 Zoom 可访问的公网 HTTPS 地址
  • 一个已有的 Zoom Team Chat 频道，用于测试群聊消息

二、创建 Zoom App 并获取凭证​

前往 Zoom App Marketplace，按以下步骤操作：

  1. 进入 Develop → Build App，创建 General App
  2. 组织内部使用时选择 Admin-managed；开发测试阶段可先使用 Development 环境
  3. 填写应用名称、描述和开发者联系方式
  4. 在应用功能中启用 Zoom Team Chat / Chat Subscription
  5. 创建一个 Slash Command。命令名称可以自定义，例如 /ae；Bot Endpoint URL 暂时保留，完成下一章的平台渠道配置后再填写
  6. 在 Scopes 中确认应用包含 imchat:bot 权限；如果没有，请手动添加
  7. 记录当前应用环境中的以下信息：
凭证说明
Client IDZoom 应用的客户端标识
Client Secret与 Client ID 配套的客户端密钥
Secret Token用于验证 Zoom 回调请求
Bot JIDChatbot 的身份标识，通常形如 robot_xxxxx@xmpp.zoom.us
Account ID当前 Zoom 账号的标识
提示

Client Secret 和 Secret Token 属于敏感凭证，请勿提交到代码仓库或发送到聊天、工单中。Development 与 Production 的凭证必须成套使用，不能混用。

三、在平台中添加 Zoom Team Chat 渠道​

管理员登录 Agentic Engine，进入「系统管理」→「Agent 管理」→「渠道管理」：

  1. 点击「新建渠道」，渠道类型选择 Zoom Team Chat
  2. 填写以下配置项：
配置项是否必填说明
渠道名称必填显示名称，如「Zoom Team Chat」
Client ID必填Zoom 应用的 Client ID
Client Secret必填Zoom 应用的 Client Secret
Secret Token必填Zoom 应用 Chat Subscription 的 Secret Token
Bot JID必填Zoom Chatbot 的 Bot JID
Account ID必填Zoom 应用所属账号的 Account ID
绑定模型可选不填则使用系统默认模型
系统提示词可选针对此渠道的 Agent 专属 System Prompt
  1. 保存渠道，回到渠道列表点击「验证凭证」
  2. 验证成功后启用渠道
  3. 再次编辑渠道，复制只读的 Bot Endpoint URL
  4. 返回 Zoom App Marketplace，将该地址粘贴到 Chat Subscription 的 Bot Endpoint URL，完成 Endpoint URL Validation 后保存
  5. 按 Zoom 页面要求，把应用安装到当前账号或测试范围
提示

Endpoint URL Validation 前，Agentic Engine 渠道必须已经完成凭证验证并处于启用状态。编辑已有渠道时，Client Secret 和 Secret Token 留空表示保留原值。

四、用户绑定 Zoom 账号​

普通用户首次使用前，需要把自己的 Zoom 账号与 Agentic Engine 账号绑定：

  1. 进入「个人设置」→「渠道绑定」，选择要使用的 Zoom Team Chat 渠道
  2. 复制系统生成的一次性绑定码，例如 +bind ABC234
  3. 打开 Zoom Workplace → Team Chat，找到管理员安装的 Chatbot，并进入机器人私聊
  4. 使用管理员实际配置的 Slash Command 发送绑定码。假设命令为 /ae，则发送 /ae +bind ABC234
  5. 收到绑定成功提示后即可使用；如需解绑，可回到「渠道绑定」页面操作

绑定码有效期为 10 分钟，并且只能成功使用一次。绑定命令只能在机器人私聊中使用；在频道中发送不会完成绑定，也不会消耗绑定码。

提示

同一个 Zoom 账号不能同时绑定给多个 Agentic Engine 用户。如果提示账号已被其他用户绑定，请先在原用户侧解绑。

五、群聊消息分发​

群聊消息分发可以让同一个 Zoom Chatbot 按规则把不同问题交给不同的 Agent 或 Team。规则配置在当前 Zoom 应用和 Account ID 对应的入口上，对已经加入该 Chatbot 的 Team Chat 频道生效。用户必须已绑定 Agentic Engine 账号，并通过管理员配置的 Slash Command 发起任务；普通频道消息或单纯 @机器人不会进入 Agentic Engine。

新增权限检查​

应用需要包含 imchat:bot 权限，并且已经安装到当前 Zoom 账号。要在某个频道中使用，还必须由有权限的成员把应用加入该 Team Chat 频道。

管理员配置​

  1. 把 Chatbot 加入需要使用的 Team Chat 频道，并确认成员可以看到实际配置的 Slash Command
  2. 进入「系统管理 → Agent 管理 → 渠道管理」，在对应 Zoom Team Chat 渠道上打开「消息分发」
  3. 选择默认使用的 Agent/Team。启用群聊分发前必须配置默认项
  4. 按需添加最多 19 条规则。每条规则选择一个 Agent/Team，填写必填的「调用指令」，还可以填写最多 10 个关键词，然后打开启用开关并保存
  5. 在频道中发送 /ae +help 做验收；如果实际 Slash Command 不是 /ae，请替换为管理员设置的命令
配置项规则
默认 Agent/Team启用前必须配置；未指定调用指令、且未命中关键词时使用
调用指令必填，1～32 个字符；可使用字母、数字、- 和 _，不能使用系统保留命令。大小写以及全角、半角差异不视为不同指令
关键词可不填；每条规则最多 10 个，每个 2～32 个字符。多个关键词同时命中时优先更长的关键词；同长度无法唯一判断时使用默认 Agent/Team
可选范围可选择已启用且可运行的系统/企业 Agent，以及当前企业的 Team；个人 Agent 不会出现在候选中

频道中的使用方式​

下表示例假设 Zoom 中配置的 Slash Command 为 /ae。

用途示例说明
查看可用能力/ae +help展示当前用户可使用且当前可运行的能力
指定 Agent/Team/ae +analysis 分析本周数据analysis 为管理员配置的调用指令
按关键词分发/ae 帮我检查埋点方案命中关键词时使用对应规则，未命中时使用默认项
取消任务/ae +cancel必须整条命令精确发送
兼容旧写法/ae +agent analysis 分析本周数据仍可使用，但推荐直接使用 +analysis

命令边界：群聊分发不支持 +new；机器人私聊仍支持 +new、+agent 和 +cancel。频道中的每条新任务都要使用实际 Slash Command。

公开上下文与个人数据：频道任务使用独立的新会话，不读取机器人私聊内容或个人记忆。频道中的问题和回答对频道成员可见，敏感信息请在机器人私聊中发送。

六、常见问题​

凭证验证失败​

  • 确认 Client ID、Client Secret、Secret Token、Bot JID 和 Account ID 来自同一个 Zoom 应用环境
  • 确认 Zoom 应用已启用 Chat Subscription，并包含 imchat:bot 权限
  • 确认没有混用 Development 和 Production 凭证

Endpoint URL Validation 失败​

  • 确认 Agentic Engine 渠道已完成「验证凭证」并已启用
  • 确认 Zoom 中填写的 Bot Endpoint URL 与平台显示的地址完全一致
  • 确认 Agentic Engine 的公网 HTTPS 地址可以被 Zoom 访问
  • 确认 Secret Token 来自当前 Zoom 应用环境

用户无法绑定 Zoom 账号​

  • 确认绑定码是在机器人私聊中通过实际 Slash Command 发送
  • 确认绑定码仍在 10 分钟有效期内，并且没有使用过
  • 确认该 Zoom 账号没有绑定给其他 Agentic Engine 用户

Bot 收不到频道消息​

  • 确认使用的是 Zoom Slash Command，而不是普通消息或单纯 @机器人
  • 确认应用已经加入目标 Team Chat 频道；仅安装到账号或能看到命令候选，不代表应用已加入频道
  • 确认用户已在机器人私聊中完成账号绑定

Slash Command 发送后消失​

  • Zoom 不会把 Slash Command 显示成普通频道消息，这是正常现象
  • 稍等片刻，机器人会发送包含提问者、原问题和回答的消息

Bot 能收到命令但无法回复​

  • 确认 Bot JID、Account ID 和 imchat:bot 权限配置正确
  • 确认渠道仍处于启用状态，应用仍在当前 Zoom 账号的安装或测试范围内

相关页面与下一步

这篇文档对你有帮助吗？
本页内容