Microsoft Teams
Microsoft Teams 集成会把每条分享以 **Adaptive Card（自适应卡片）**的形式发到你指定的 Teams 频道：标题、页面、环境、诊断条数、带标注截图的链接，以及一个「查看完整报告」按钮。
第一步：在 Teams 创建 Workflows webhook
Section titled “第一步：在 Teams 创建 Workflows webhook”- 在 Teams 中打开要接收报告的团队和频道
- 点击频道旁的 ⋯ → Workflows
- 搜索并选择模板 「Post to a channel when a webhook request is received」
- 确认团队与频道后点击 Save
- 复制生成的 webhook 地址（Power Automate 托管），形如
https://prod-12.<region>.logic.azure.com/workflows/…/triggers/manual/paths/invoke?…
第二步：在 BugCapturer 添加集成
Section titled “第二步：在 BugCapturer 添加集成”- 登录后进入集成设置页
- 左侧平台列表选择 Microsoft Teams → 点击「添加集成」
- 填写名称，粘贴第一步的 Workflow webhook 地址
- 点击「保存」——服务端会校验地址属于 Power Automate 域名，并向该频道发送一张测试卡片
- 频道里出现卡片即表示配置成功
卡片包含什么
Section titled “卡片包含什么”| 元素 | 内容 |
|---|---|
| 标题 | 🐞 [类型] 描述首行 |
| 页面 | 反馈所在页面的标题，链接到脱敏后的 URL |
| 环境 | 浏览器 · 操作系统 · 分辨率 |
| 诊断 | 只有条数：控制台 2 · 网络 0 |
| 截图 | 带标注截图的链接 —— 平台能抓取图片时会直接内嵌显示 |
| 按钮 | 「查看完整报告」→ 分享页（含完整错误详情） |
Teams 侧要知道的限制
Section titled “Teams 侧要知道的限制”| 行为 | 说明 |
|---|---|
| 发送身份 | 卡片以 Workflows Bot（Flow bot） 身份发出，头像和名称无法自定义 |
| 工作流归属 | 工作流属于创建者个人账号。创建者离职且没有共同所有者时，流程会变成 orphan flow 而停止发送。建议用团队账号创建或添加共同所有者 |
| 消息大小 | 单条 28 KB 上限。BugCapturer 的描述截断远低于此 |
| 速率 | 约 4 请求/秒，超出返回 429；BugCapturer 会按退避策略重试 |
| 私有频道 | Workflows 对私有频道的支持到 2026 年 4 月才补齐。若发送失败，请改用标准频道或共享频道 |
| 卡片类型 | 发的是包在消息信封里的 Adaptive Card；按钮只用 OpenUrl 跳转，不带交互回调 |
投递、重试与失败
Section titled “投递、重试与失败”- 只认
2xx为成功 —— Workflows 正常返回202 Accepted - 失败自动重试 2 次（5s / 15s 退避），每次结果记录在投递日志中
- 连续失败 20 次自动停用集成并邮件提醒
- 常见失败原因：workflow 被关闭或删除、频道被移除、租户限制了 Power Automate 流程
- 该 webhook 地址本身就是凭证，任何拿到它的人都能往这个频道发消息
- 因此 BugCapturer 不回显完整地址：列表与卡片只显示末 6 位
- 需要更换时，在编辑集成时重新粘贴完整地址
- 需要吊销时，在 Teams 侧关闭或删除该 workflow
- 仅接受 Power Automate 域名（
*.logic.azure.com、*.powerplatform.com、*.powerautomate.com）
保存时提示「仅支持平台官方地址」？
地址必须是 Power Automate / Workflows webhook。连接器时代的 *.webhook.office.com 地址已失效，会被拒绝。
截图在哪里？ 卡片一定会带上带标注截图的链接。Teams 会自己去抓取并渲染图片；取不到我们的截图代理时，卡片仍会正常发出，链接也照常可用。
必须推到私有频道？ 目前建议改用标准频道或共享频道；Workflows 对私有频道的支持在各租户间还不一致。
会带上当前页地址与标题，直接提交给文档维护者