> ## Documentation Index
> Fetch the complete documentation index at: https://test-8ad8522e-feat-api-review-auto-fix.mintlify.site/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
**Plan requirement**: IM integration requires an On-call Pro or higher subscription. [Learn more](https://flashcat.cloud/flashduty/price/)
If your organization restricts third-party apps, ask a Microsoft Teams administrator to allow Flashduty before you add it.
To learn how the Teams app handles Teams users, teams, channels, group chats, and incident card data, see the [Flashduty Microsoft Teams app privacy policy](/en/compliance/microsoft-teams-app-privacy-policy) and [Flashduty Microsoft Teams app terms of use](/en/compliance/microsoft-teams-app-terms-of-use).
## 1. Data and permissions
The Flashduty Teams app processes Teams data only as needed to send alert notifications, complete linking configuration, and handle incident card actions.
| Data or capability | How it is used |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Teams user ID and Microsoft Entra ID (AAD Object ID) | Link a Teams user to a Flashduty user; verify the user taking an incident card action; send personal notifications or action feedback |
| Team ID, team name, and channel ID | Link a Teams team or channel; send alert and incident notifications to the selected Teams channel; retrieve the team details and channel list for a specified Team |
| Group chat ID and chat name entered by the user | Link a Teams group chat; send alert and incident notifications to the selected group chat |
| Conversation ID, activity ID, and Bot Framework conversation reference | Send, update, or reply to Teams notification cards after the app is installed |
| Bot commands and card actions | Handle `help`, `linkUser`, `linkTeam`, and `linkChat` commands, as well as acknowledge, resolve, snooze, and custom action buttons |
| Flashduty alert and incident card data | Show alert or incident details in Teams and sync card action results back to Flashduty |
The Flashduty Teams app does not read ordinary Teams chat content that is unrelated to Flashduty functionality. It processes only messages sent to the bot in personal chats, messages where the bot is mentioned in teams or group chats, card button actions, installation and conversation reference data required for the app to work, and data needed to send or update Flashduty notifications.
The current app package does not request Microsoft Graph permissions for reading organization-wide chat content. If a future version introduces new Teams permissions or data processing scenarios, Flashduty will update this documentation and the related privacy notice.
## 2. Get the App from Microsoft Teams
In Microsoft Teams, select **Apps**, search for **Flashduty**, and open its details page.
Select **Add**. Choose the destination that matches your use case: a team/channel, a group chat, or your personal chat.
In the commands below, replace `{ID}` with the Flashduty Microsoft Teams integration ID. Replace `{ChatName}` with the group chat name.
## 3. Link team
In Teams, open **Apps**, find **Flashduty**, and select **Add to a team**.
If you cannot find or add the app, contact your Microsoft Teams administrator.
Add the app to the target Team.
This step must select the target Team's General Channel, otherwise incidents cannot be sent to the Team.
In the Team's General channel, @Flashduty and send `linkTeam {ID}`, then select **Link Now**.
To remove this Team's link, in the same channel send `@Flashduty unlinkTeam {ID}`. After you select **Unlink in FlashDuty** in the response card, Flashduty removes the link automatically and shows a success message.
## 4. Link chat
In Teams, open **Apps**, find **Flashduty**, and select **Add to a chat**.
If you cannot find or add the app, contact your Microsoft Teams administrator.
Add the app to the target Chat.
In the group chat, @Flashduty and send `linkChat {ID} {ChatName}`, then select **Link Now**.
To remove this group's link, send `@Flashduty unlinkChat {ID}` in the same group chat. After you select **Unlink in FlashDuty** in the response card, Flashduty removes the link automatically and shows a success message.
## 5. Notification card actions
When incident notifications are pushed to Microsoft Teams, the notification cards may include the following interactive actions. The available buttons depend on the Flashduty card you receive and the backend configuration:
* **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.)
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.
## 6. Link user
In Teams, open **Apps**, find **Flashduty**, and select **Open**.
If you cannot find or open the app, contact your Microsoft Teams administrator.
Click **Open App**.
Send `linkUser {ID}` in your personal chat with Flashduty, then select **Link Now**.
To remove your Teams account link, send `unlinkUser {ID}` in the same personal chat. After you select **Unlink in FlashDuty** in the response card, Flashduty removes the link automatically and shows a success message. If your account is already linked, you can also go to **Integration Center → Instant Messaging → Microsoft Teams → Linked Users**, select **Unlink me**, and then select **Confirm** in the dialog.
## 7. FAQ
Go to Integration Center → Instant Messaging → **Microsoft Teams**, check if teams and users have been successfully linked.
Go to Integration Center → Instant Messaging → **Microsoft Teams**, view in **Linked Teams** and **Linked Users**.
Use the matching command in its original Teams context: `unlinkTeam {ID}` in a Team channel, `unlinkChat {ID}` in a group chat, or `unlinkUser {ID}` in your personal chat. After you select **Unlink in FlashDuty** in the response card, Flashduty removes the matching link automatically. If your account is already linked, you can also select **Unlink me** under **Linked Users**, then select **Confirm** in the dialog.