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

# Microsoft Teams

> By integrating the Microsoft Teams third-party app, you can receive and respond to alerts within Microsoft Teams

<Tip>**Plan requirement**: IM integration requires an On-call Pro or higher subscription. [Learn more](https://flashcat.cloud/flashduty/price/)</Tip>

<Warning>
  Microsoft Teams integration is currently in Beta stage. The following steps must be completed by a Microsoft Teams administrator.
</Warning>

## 1. Install and Update App

<Steps>
  <Step title="Download App">
    Download [FlashdutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) to your local machine.
  </Step>

  <Step title="Install App">
    Go to Microsoft Teams, navigate to +Apps → Manage your apps → Upload an app → **Upload an app to your org's app catalog**, then upload the app package `FlashdutyBot.zip`.

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

  <Step title="Configure App Visibility">
    Go to [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/policies/manage-apps), find the Flashduty On-call app, adjust app visibility to everyone or your specified scope.

    <Tip>
      If the app status shows "Blocked", please wait a moment and refresh the page or modify manually.
    </Tip>

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

  <Step title="Verify Installation">
    Wait a few minutes, organization members can find this app in +Apps → **Built for your org**.

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

### Update App

<Warning>
  If your installed app version is lower than 1.0.3, please follow the process below to update.
</Warning>

<Steps>
  <Step title="Enter Admin Center">
    Go to [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/policies/manage-apps), find and enter the Flashduty app details page.

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

  <Step title="Upload New Version">
    Upload the new `FlashdutyBot.zip`.

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

  <Step title="Wait for Update">
    Wait for the app version to update in the client (may take tens of minutes).

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

## 2. Link Team

<Steps>
  <Step title="Find App">
    Find the Flashduty On-call app in the app marketplace.

    <Note>
      If app not found, please contact your Microsoft Teams organization administrator.
    </Note>

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

  <Step title="Add to Team">
    Add the app to the target Team.

    <Warning>
      This step must select the target Team's General Channel, otherwise incidents cannot be sent to the Team.
    </Warning>

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

  <Step title="Send Link Command">
    In the Team, @Flashduty and send command `linkTeam {ID}`, then click **Link Now**.

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

## 3. Link Chat

<Steps>
  <Step title="Find App">
    Find the Flashduty On-call app in the app marketplace.

    <Note>
      If app not found, please contact your Microsoft Teams organization administrator.
    </Note>

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

  <Step title="Add to Chat">
    Add the app to the target Chat.

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

  <Step title="Send Link Command">
    In the Chat, @Flashduty and send command `linkChat {ID} {ChatName}`, then click **Link Now**.

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

## 4. Notification Card Actions

When incident notifications are pushed to Microsoft Teams, the notification cards support the following interactive actions, allowing you to respond to incidents directly in Teams without switching to the Flashduty console:

* **Acknowledge**: Mark that you have started handling the incident
* **Resolve**: Mark the incident as resolved and close it
* **Snooze**: Temporarily suspend the incident and receive a reminder after a specified time
* **Custom Actions**: Trigger your pre-configured custom actions (such as restarting services, rolling back changes, etc.)

<Note>
  War room functionality is not currently supported for Microsoft Teams. If you need to use the war room feature, consider using Slack, Feishu/Lark, Dingtalk, or WeCom integration instead.
</Note>

## 5. Link User

<Steps>
  <Step title="Find App">
    Find the Flashduty On-call app in the app marketplace.

    <Note>
      If app not found, please contact your Microsoft Teams organization administrator.
    </Note>

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

  <Step title="Open App">
    Click **Open App**.

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

  <Step title="Send Link Command">
    Copy and send command `linkUser {}` to the chat, then click **Link Now**.

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

## 6. FAQ

<AccordionGroup>
  <Accordion title="Team or individual not receiving messages?">
    Go to Integration Center → Instant Messaging → **Microsoft Teams**, check if teams and users have been successfully linked.
  </Accordion>

  <Accordion title="How to view linked teams and users?">
    Go to Integration Center → Instant Messaging → **Microsoft Teams**, view in **Linked Teams** and **Linked Users**.
  </Accordion>

  <Accordion title="How to unlink teams and users?">
    This feature is not currently supported.
  </Accordion>
</AccordionGroup>