连接 Microsoft Teams: 分步指南
将运行摘要发送到 Teams 频道;设置 NEXUS_TEAMS_NOTIFY=true 后,还会为每个失败的测试发送一条消息。本指南将带您从零开始完成连接并验证,同时列出您可能遇到的错误、原因及解决方法。
最后更新:
请妥善保管您的凭据。切勿将令牌、密钥、密码或 Webhook URL 粘贴到聊天中。请仅在 Studio → 设置 → 集成中输入,凭据会保存到工作区的 .env 文件中,并以圆点显示。对 AI 助手也是如此: 它可以指导您完成本指南中的步骤,但绝不需要您的令牌。
所需准备
- 一个您可以添加工作流的 Teams 频道。
- 该频道的一个 Workflows Webhook URL。
获取凭据
- 在 Teams 中,打开频道的 ··· 菜单 → 工作流,然后添加 "收到 Webhook 请求时发布到频道"。
- 复制提供的 Webhook URL。其域名以 logic.azure.com 结尾(旧版连接器:webhook.office.com)。此 URL 本身就是密钥。
- 将其保留在剪贴板中。除 Studio (下一步) 外,请勿粘贴到任何其他位置。
在 Studio 中连接
- 在 Studio 中,打开设置 → 集成 → Microsoft Teams。
- 粘贴 Webhook URL,然后点击保存 & 发送测试消息。测试消息将发送到该频道。
- 启用
TEAMS_ENABLED。如需每个失败的测试各发送一条消息,还需启用NEXUS_TEAMS_NOTIFY。
验证连接是否正常
- 点击发送测试消息后,系统会回复 "已发送。",消息会出现在频道中。
- 运行任意测试。运行摘要将发送到该频道。
常见错误
| 你看到的现象 | 原因 | 解决方法 |
|---|---|---|
| "未配置 Webhook" | TEAMS_WEBHOOK_URL 为空。 | 在设置 → 集成中粘贴 Webhook URL 并保存。 |
"TEAMS_WEBHOOK_URL 不是 Teams Webhook" | 该值不是 logic.azure.com 或 webhook.office.com 上的 https URL。 | 从工作流的 "收到 Webhook 请求时发布到频道" 触发器中重新复制 URL。 |
| Teams 返回 HTTP 4xx 或 5xx 响应 | 工作流已被关闭或删除,或者其所有者已离职或失去许可证,因此工作流不再运行。 | 在 Teams 中打开工作流(工作流 → 管理),将其启用或新建工作流,然后保存新 URL。 |
| "无法连接到 Teams (ENOTFOUND)" 或 "未在 20 秒内响应" | 此电脑无法连接到 Microsoft:可能是 VPN 或代理导致,也可能是没有网络连接。 | 在同一台电脑上检查网络,然后重试。 |
| 测试消息发送正常,但未发送失败通知 | TEAMS_ENABLED 为 false,或仅启用了运行摘要:要为每个测试发送消息,需设置 NEXUS_TEAMS_NOTIFY=true。 | 开启这两个开关。 |
设置键
| 键 | 功能 | 有效值 | 如何检查 |
|---|---|---|---|
TEAMS_ENABLED | 向 Microsoft Teams 发送警报 | true 或 false | 收到测试消息后再开启。 |
TEAMS_WEBHOOK_URL | 接收告警的 Teams 频道 (保密, 仅保存在此计算机上) | https://…logic.azure.com 或 …webhook.office.com URL | 点击发送测试消息,即可向该频道发送消息。 |
NEXUS_TEAMS_NOTIFY | 每次失败时发送 Teams 警报 | true 或 false | 每个失败的测试都会发送一条消息,而不只是发送运行摘要。 |
更多: 所有集成, 设置指南, 故障排查. 其他指南: Jira Cloud, Azure Boards, Slack, Telegram, GitHub Issues.
仍然遇到问题?请发送邮件至 [email protected],附上 Studio 显示的完整错误行。请勿包含令牌。