跳转到主要内容
版本要求:IM 集成需要 On-call 专业版及以上订阅。了解更多
Microsoft Teams 集成现处于 Beta 阶段,以下步骤需由 Microsoft Teams 管理员完成。
如需了解 Teams 应用处理 Teams 用户、团队、频道、群聊和故障卡片数据的规则,请参阅《Flashduty Microsoft Teams 应用隐私政策》和《Flashduty Microsoft Teams 应用使用条款》。

一、数据和权限说明

Flashduty Teams 应用只在发送告警通知、完成关联配置和处理故障卡片操作所需的范围内处理 Teams 数据。
数据或能力使用场景
Teams 用户 ID、Microsoft Entra ID(AAD Object ID)关联 Teams 用户与 Flashduty 用户;校验故障卡片操作人;向关联用户发送个人通知或操作反馈
Team ID、Team 名称、Channel ID关联 Teams 团队或频道;把告警和故障通知发送到指定 Teams 频道;查询指定 Team 的详情和频道列表
Group Chat ID、用户输入的 Chat 名称关联 Teams 群聊;把告警和故障通知发送到指定群聊
Conversation ID、Activity ID、Bot Framework 会话引用在应用安装后发送、更新或回复 Teams 通知卡片
Bot 指令和卡片动作处理 helplinkUserlinkTeamlinkChat 指令,以及认领、解决、暂缓、自定义操作等卡片按钮
Flashduty 告警和故障卡片数据在 Teams 中展示告警或故障详情,并把卡片操作结果同步回 Flashduty
Flashduty Teams 应用不会读取与 Flashduty 功能无关的普通 Teams 聊天内容。它只处理个人聊天中发送给 bot 的消息、团队或群聊中 @ bot 的消息、卡片按钮动作、应用安装和会话所需的引用信息,以及发送或更新 Flashduty 通知所需的数据。 当前应用包不申请用于读取全组织聊天内容的 Microsoft Graph 权限。如后续版本引入新的 Teams 权限或数据处理场景,Flashduty 将更新本文档和相关隐私说明。

二、安装与更新应用

1

下载应用

FlashdutyBot-v1.0.3.zip 下载到本地。
2

安装应用

进入 Microsoft Teams,导航至 +Apps → Manage your apps → Upload an app → Upload an app to your org’s app catalog,然后上传应用包 FlashdutyBot.zip2025-09-18-13-48-04
3

配置应用可见范围

进入 Microsoft Teams 管理中心,找到 Flashduty On-call 应用,将应用可见范围调整为所有人或您指定的范围。
如遇到应用状态为”已阻止”,请稍等片刻后刷新页面或手动修改。
2025-09-18-13-49-11
4

验证安装

等待几分钟,组织成员即可在 +Apps → Built for your org 找到此应用。2025-09-18-17-05-37

更新应用

若您已安装的应用版本低于 1.0.3,请按照以下流程更新。
1

进入管理中心

进入 Microsoft Teams 管理中心,找到并进入 Flashduty 应用详情页。2025-09-18-13-50-41
2

上传新版本

上传新版 FlashdutyBot.zip2025-09-18-13-51-56
3

等待更新

等待客户端内应用版本更新(可能需要几十分钟)。2025-09-18-13-52-56

三、关联团队 (Team)

1

查找应用

在应用市场中找到 Flashduty On-call 应用。
如无应用,请联系您的 Microsoft Teams 组织管理员。
2025-09-18-17-06-34
2

添加到团队

将应用添加到目标 Team。
此步骤必须选择目标 Team 的 General Channel,否则将无法发送故障到 Team 中。
2025-09-18-17-11-29
3

发送关联指令

在 Team 中 @Flashduty 并发送指令 linkTeam {ID},然后点击 立即关联2025-09-18-13-55-05

四、关联群聊 (Chat)

1

查找应用

在应用市场中找到 Flashduty On-call 应用。
如无应用,请联系您的 Microsoft Teams 组织管理员。
2025-09-18-17-06-34
2

添加到群聊

将应用添加到目标 Chat。2025-09-18-17-14-23
3

发送关联指令

在 Chat 中 @Flashduty 并发送指令 linkChat {ID} {ChatName},然后点击 立即关联2025-09-18-13-56-17

五、消息卡片操作

当故障通知推送到 Microsoft Teams 后,通知卡片可包含以下交互操作;具体可用按钮以您收到的 Flashduty 卡片和后台配置为准:
  • 认领(Acknowledge):标记您已开始处理该故障
  • 解决(Resolve):将故障标记为已解决并关闭
  • 暂缓(Snooze):暂时挂起故障,在指定时间后重新提醒
  • 自定义操作(Custom Actions):触发您预先配置的自定义操作(如重启服务、回滚变更等)
作战室(War Room)功能目前不支持 Microsoft Teams。如果您需要使用作战室功能,请考虑使用 Slack、飞书、钉钉或企业微信集成。

六、关联用户

1

查找应用

在应用市场中找到 Flashduty On-call 应用。
如无应用,请联系您的 Microsoft Teams 组织管理员。
2025-09-18-17-06-34
2

打开应用

点击 打开应用2025-09-18-13-56-55
3

发送关联指令

复制并发送指令 linkUser {} 到聊天中,然后点击 立即关联2025-09-18-13-57-13

七、常见问题

请前往 集成中心 → 即时消息 → Microsoft Teams,检查团队和用户是否已成功关联。
请前往 集成中心 → 即时消息 → Microsoft Teams,在 关联 Teams关联用户 中查看。
暂不支持此功能。