管理 Teams 渠道
提示
功能可用性
Microsoft Teams 渠道可用于:
- n8n Cloud: 所有计划
- 自托管: n8n 2.32.3 起的所有计划
提示
预览状态
面向 agent 的 Microsoft Teams 渠道处于 Preview 阶段,未来版本中可能会变化。请避免在生产环境中依赖它。
连接 Teams 之后,你在渠道设置中更改它。打开 agent,前往 Channels 渠道,然后选择 Microsoft Teams。
渠道设置会显示:
- Where it works 可用范围: 来自用户可以在哪里使用 agent的选项,以及管理员是否已批准 Microsoft Graph 权限。
- Appearance in Teams Teams 中的外观: 应用的显示名称、描述和图标。使用推荐设置时,这里还有 Install app 安装应用 菜单。
- Azure Bot: 使用推荐设置时,显示 Linked to Azure Bot 已关联到 Azure Bot 和 Find it in Azure 在 Azure 中查找 链接。使用手动设置时,显示 Find your Azure Bot 查找你的 Azure Bot 链接。
上传应用或发布到组织
把应用放入 Teams 有两种方式:
| 为我安装(上传) | 发布到组织 | |
|---|---|---|
| 谁可以添加应用 | 你,以及所有拿到该 zip 文件的人 | 组织中的任何人,从 Teams 应用商店添加 |
| 谁来批准 | 不需要任何人,前提是你的 Teams 策略允许上传自定义应用 | Teams administrator,除非你本人就是该角色 |
| 需要多久 | 立即 | Microsoft 列出该应用最多需要一天;如果还在等待批准,则更久 |
| 更新如何送达用户 | 每个人都重新上传新的 zip 文件 | 你再次发布,Teams 会为所有人更新应用 |
| 适用于 | 推荐设置和手动设置 | 推荐设置 |
为我安装
Install for me 为我安装 会下载应用包。在 Teams 中前往 Apps > Manage your apps > Upload an app 上传该包,然后将其添加到团队或聊天。在手动设置中,这是 Download app package 下载应用包 步骤。
如果看不到 Upload an app,请 Teams administrator 允许上传自定义应用,或者改为发布应用。
发布到组织
Publish to organization 发布到组织 会把应用添加到 Teams 中你组织的应用目录。你可以在推荐设置的 Install app 安装应用 步骤中找到它,之后也可以在渠道设置的 Install app 安装应用 菜单中找到它。
- 如果你是 Teams administrator, n8n 会立即发布应用,但 Microsoft 列出它最多可能需要一天。根据你组织的应用策略,Teams administrator 可能仍需要在 Teams 管理中心将它提供给所有人。
- 如果你不是, n8n 会提交应用以供批准。它会在 Teams 管理中心的 Teams apps > Manage apps 下等待,状态为 Pending approval。在管理员批准之前,没有人可以添加该应用。在设置中,选择 Copy a request for your administrator 复制给管理员的请求,以复制包含应用名称和该页面链接的消息。
如果应用正在等待批准,或者管理员拒绝了它,渠道设置会说明情况。如果管理员拒绝,Microsoft 不会分享原因,请直接询问他们。
在手动设置中,n8n 无法代你发布应用。请改为让 Teams administrator 在 Teams 管理中心上传应用包。
更改可用范围或外观
在渠道设置中,你可以更改 Where it works 可用范围 和 Appearance in Teams Teams 中的外观,例如显示名称和描述。在你发送新版本之前,Teams 会保留应用的上一版本:
- 手动设置: 选择 Save and download package 保存并下载包,然后在 Teams 中前往 Apps > Manage your apps > Upload an app 上传新包。
- 推荐设置: 打开 Install app 安装应用 菜单,选择 Publish to organization 发布到组织,或选择 Install for me 为我安装 以下载并上传新包。
应用使用 agent 的名称和图标。如果以后更改 agent 的名称或图标,渠道设置会显示 Changes to the agent aren't in Teams yet. agent 的更改尚未同步到 Teams。 再次安装或发布应用以更新它。
切换到其他凭据或登录
不同的凭据或 Microsoft 登录对应不同的 bot,因此 n8n 无法在已连接的渠道中直接替换。如果你在渠道设置中另选一个,n8n 会询问 Set up Microsoft Teams again? 重新设置 Microsoft Teams? 选择 Set up again 重新设置,即可移除当前的 Teams 连接及其设置,并从头开始设置。在你完成新设置之前,agent 会停止在 Teams 中回复。
续订客户端密钥
客户端密钥会过期。密钥过期后,agent 会停止在 Teams 中回复。
- 推荐设置: n8n 会以你的组织允许的最长有效期创建密钥,最长 24 个月。当 Create Teams app 创建 Teams 应用 步骤再次运行时,n8n 会复用应用注册;如果当前密钥将在七天内过期,则会创建新密钥。
- 手动设置: 在 Microsoft Entra 中创建新的客户端密钥,然后在 n8n 中更新凭据。
断开 Teams 连接
要断开 Teams,请从 agent 中移除该渠道,并用 Yes, remove 是的,移除 确认。已经发送的消息会保留在 Teams 中。以后要重新连接,需要再次设置渠道。
当你断开 Teams 渠道或删除 agent 时,n8n 不会删除 Microsoft 中的任何内容。用户可能仍安装了该应用,但 agent 不再响应。对于推荐设置创建的应用,n8n 会显示一条提醒,其中包含指向 Teams 管理中心的 Open Teams 打开 Teams 链接。如果不再需要这些资源,请自行移除:
- 应用注册,位于 Microsoft Entra 的 App registrations 下。
- Azure Bot,位于 Azure 门户。使用推荐设置时,它在
n8n-agents资源组中。 - Teams 应用,如果你发布过它,位于 Teams 管理中心 的 Teams apps > Manage apps 下。
排查问题
你的组织不允许你注册应用
你的 Microsoft 账户无法创建应用注册。请管理员授予该权限,或使用管理员为你创建的应用注册进行手动设置。
Teams 应用需要工作或学校账户
你使用了个人 Microsoft 账户登录。请使用组织的工作或学校账户重新登录。
你的账户无法在 Azure 订阅中创建资源
你需要在所选 Azure 订阅上拥有 Contributor 角色。请向 Azure 管理员申请访问权限,或选择另一个订阅。
凭据与 Microsoft Entra 中的应用不匹配
凭据的详细信息与应用注册不匹配。请检查:
- 租户 ID 和客户端 ID 属于同一个应用注册。
- 客户端密钥是密钥的 Value,而不是 Secret ID。
- 客户端密钥尚未过期。
Teams bot 需要 HTTPS 消息终结点
Microsoft 只向 HTTPS URL 发送消息。在自托管 n8n 上,将 N8N_WEBHOOK_URL 设置为实例的公开 HTTPS URL。
Teams 中没有 Upload an app 选项
你的 Teams 策略不允许上传自定义应用。请 Teams administrator 允许上传,或改为把应用发布到组织。
agent 不在频道中回复
请检查:
- 你已经发布了 agent。
- Team channels 团队频道 已开启,并且最新的应用包已在 Teams 中。
- 有人在线程中 @提及了 agent,或者已开启 Read all channel messages 读取所有频道消息。
agent 无法读取附加文件
频道和群聊中的文件需要 Files.Read.All 应用程序权限。管理员通过管理员同意,将其与其他 Graph 权限一起一次性授予。生效最多可能需要一小时。请参阅批准访问。
agent 找不到人员或频道
按电子邮件查找人员需要 User.ReadBasic.All,按名称查找频道需要 Team.ReadBasic.All 和 Channel.ReadBasic.All。管理员在批准访问中批准它们。在此之前,请在频道中 @提及 agent 一次,或把该用户的 Teams ID 提供给 agent。
agent 无法发送私聊消息或帖子
Teams 只会在用户已添加应用的位置,投递 agent 主动发起的消息。对于私聊消息,对方必须已在 Teams 中添加该应用。对于帖子,该应用必须已在该团队或群聊中。请该用户或 team owner 添加应用,然后重试。