> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

> 通过集成 Microsoft Teams 第三方应用，您可以在 Microsoft Teams 内接收和响应告警

<Tip>**版本要求**：IM 集成需要 On-call 专业版及以上订阅。[了解更多](https://flashcat.cloud/flashduty/price/)</Tip>

<Warning>
  Microsoft Teams 集成现处于 Beta 阶段，以下步骤需由 Microsoft Teams 管理员完成。
</Warning>

## 一、安装与更新应用

<Steps>
  <Step title="下载应用">
    将 [FlashdutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) 下载到本地。
  </Step>

  <Step title="安装应用">
    进入 Microsoft Teams，导航至 +Apps → Manage your apps → Upload an app → **Upload an app to your org's app catalog**，然后上传应用包 `FlashdutyBot.zip`。

    ![2025-09-18-13-48-04](https://docs-cdn.flashcat.cloud/images/png/bfa4afaf489c3582e858cad99eb76ae5.png)
  </Step>

  <Step title="配置应用可见范围">
    进入 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com/policies/manage-apps)，找到 Flashduty On-call 应用，将应用可见范围调整为所有人或您指定的范围。

    <Tip>
      如遇到应用状态为"已阻止"，请稍等片刻后刷新页面或手动修改。
    </Tip>

    ![2025-09-18-13-49-11](https://docs-cdn.flashcat.cloud/images/png/ea961e7965a2d0c69f8575c4252fb333.png)
  </Step>

  <Step title="验证安装">
    等待几分钟，组织成员即可在 +Apps → **Built for your org** 找到此应用。

    ![2025-09-18-17-05-37](https://docs-cdn.flashcat.cloud/images/png/f7827638d1877005ca674cbbd2aaa4a3.png)
  </Step>
</Steps>

### 更新应用

<Warning>
  若您已安装的应用版本低于 1.0.3，请按照以下流程更新。
</Warning>

<Steps>
  <Step title="进入管理中心">
    进入 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com/policies/manage-apps)，找到并进入 Flashduty 应用详情页。

    ![2025-09-18-13-50-41](https://docs-cdn.flashcat.cloud/images/png/32a62878f9e765cd8b2eb79ceb00bb02.png)
  </Step>

  <Step title="上传新版本">
    上传新版 `FlashdutyBot.zip`。

    ![2025-09-18-13-51-56](https://docs-cdn.flashcat.cloud/images/png/f18ac3504516750c31f8357e65f6d680.png)
  </Step>

  <Step title="等待更新">
    等待客户端内应用版本更新（可能需要几十分钟）。

    ![2025-09-18-13-52-56](https://docs-cdn.flashcat.cloud/images/png/290f609c30055031ab0ccf6636cdbb01.png)
  </Step>
</Steps>

## 二、关联团队 (Team)

<Steps>
  <Step title="查找应用">
    在应用市场中找到 Flashduty On-call 应用。

    <Note>
      如无应用，请联系您的 Microsoft Teams 组织管理员。
    </Note>

    ![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
  </Step>

  <Step title="添加到团队">
    将应用添加到目标 Team。

    <Warning>
      此步骤必须选择目标 Team 的 General Channel，否则将无法发送故障到 Team 中。
    </Warning>

    ![2025-09-18-17-11-29](https://docs-cdn.flashcat.cloud/images/png/01fa86b63d01d2735aa6c4a53efb3c69.png)
  </Step>

  <Step title="发送关联指令">
    在 Team 中 @Flashduty 并发送指令 `linkTeam {ID}`，然后点击 **立即关联**。

    ![2025-09-18-13-55-05](https://docs-cdn.flashcat.cloud/images/png/3192b5481b0595fcb58e5cc43abad125.png)
  </Step>
</Steps>

## 三、关联群聊 (Chat)

<Steps>
  <Step title="查找应用">
    在应用市场中找到 Flashduty On-call 应用。

    <Note>
      如无应用，请联系您的 Microsoft Teams 组织管理员。
    </Note>

    ![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
  </Step>

  <Step title="添加到群聊">
    将应用添加到目标 Chat。

    ![2025-09-18-17-14-23](https://docs-cdn.flashcat.cloud/images/png/6e56d7de341737fe495e5ff18eb1af34.png)
  </Step>

  <Step title="发送关联指令">
    在 Chat 中 @Flashduty 并发送指令 `linkChat {ID} {ChatName}`，然后点击 **立即关联**。

    ![2025-09-18-13-56-17](https://docs-cdn.flashcat.cloud/images/png/d0beee141db63714ccecb095affee79b.png)
  </Step>
</Steps>

## 四、消息卡片操作

当故障通知推送到 Microsoft Teams 后，通知卡片支持以下交互操作，您可以直接在 Teams 中快速响应故障，无需切换到 Flashduty 控制台：

* **认领（Acknowledge）**：标记您已开始处理该故障
* **解决（Resolve）**：将故障标记为已解决并关闭
* **暂缓（Snooze）**：暂时挂起故障，在指定时间后重新提醒
* **自定义操作（Custom Actions）**：触发您预先配置的自定义操作（如重启服务、回滚变更等）

<Note>
  作战室（War Room）功能目前不支持 Microsoft Teams。如果您需要使用作战室功能，请考虑使用 Slack、飞书、钉钉或企业微信集成。
</Note>

## 五、关联用户

<Steps>
  <Step title="查找应用">
    在应用市场中找到 Flashduty On-call 应用。

    <Note>
      如无应用，请联系您的 Microsoft Teams 组织管理员。
    </Note>

    ![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
  </Step>

  <Step title="打开应用">
    点击 **打开应用**。

    ![2025-09-18-13-56-55](https://docs-cdn.flashcat.cloud/images/png/2e6862103d718a913d2b3c449cbf2366.png)
  </Step>

  <Step title="发送关联指令">
    复制并发送指令 `linkUser {}` 到聊天中，然后点击 **立即关联**。

    ![2025-09-18-13-57-13](https://docs-cdn.flashcat.cloud/images/png/671ae7883bbba839419e539762db99de.png)
  </Step>
</Steps>

## 六、常见问题

<AccordionGroup>
  <Accordion title="团队或个人收不到消息？">
    请前往 集成中心 → 即时消息 → **Microsoft Teams**，检查团队和用户是否已成功关联。
  </Accordion>

  <Accordion title="如何查看已关联的团队和用户？">
    请前往 集成中心 → 即时消息 → **Microsoft Teams**，在 **关联 Teams** 和 **关联用户** 中查看。
  </Accordion>

  <Accordion title="如何取消已关联的团队和用户？">
    暂不支持此功能。
  </Accordion>
</AccordionGroup>