Skip to content

Commit ba4ea8c

Browse files
GraceWalkGraceWalk
committed
docs: update Teams Store integration flow
1 parent b59be15 commit ba4ea8c

2 files changed

Lines changed: 62 additions & 130 deletions

File tree

‎en/on-call/integration/instant-messaging/microsoft-teams.mdx‎

Lines changed: 31 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ description: "By integrating the Microsoft Teams third-party app, you can receiv
66
<Tip>**Plan requirement**: IM integration requires an On-call Pro or higher subscription. [Learn more](https://flashcat.cloud/flashduty/price/)</Tip>
77

88
<Warning>
9-
Microsoft Teams integration is currently in Beta stage. The following steps must be completed by a Microsoft Teams administrator.
9+
If your organization restricts third-party apps, ask a Microsoft Teams administrator to allow Flashduty before you add it.
1010
</Warning>
1111

1212
<Note>
@@ -30,73 +30,31 @@ The Flashduty Teams app does not read ordinary Teams chat content that is unrela
3030

3131
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.
3232

33-
## 2. Install and update app
33+
## 2. Get the App from Microsoft Teams
3434

3535
<Steps>
36-
<Step title="Download App">
37-
Download [FlashdutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) to your local machine.
36+
<Step title="Find Flashduty">
37+
In Microsoft Teams, select **Apps**, search for **Flashduty**, and open its details page.
3838
</Step>
3939

40-
<Step title="Install App">
41-
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`.
42-
43-
![2025-09-18-13-48-04](https://docs-cdn.flashcat.cloud/images/png/bfa4afaf489c3582e858cad99eb76ae5.png)
44-
</Step>
45-
46-
<Step title="Configure App Visibility">
47-
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.
48-
49-
<Tip>
50-
If the app status shows "Blocked", please wait a moment and refresh the page or modify manually.
51-
</Tip>
52-
53-
![2025-09-18-13-49-11](https://docs-cdn.flashcat.cloud/images/png/ea961e7965a2d0c69f8575c4252fb333.png)
54-
</Step>
55-
56-
<Step title="Verify Installation">
57-
Wait a few minutes, organization members can find this app in +Apps → **Built for your org**.
58-
59-
![2025-09-18-17-05-37](https://docs-cdn.flashcat.cloud/images/png/f7827638d1877005ca674cbbd2aaa4a3.png)
40+
<Step title="Add the App">
41+
Select **Add**. Choose the destination that matches your use case: a team/channel, a group chat, or your personal chat.
6042
</Step>
6143
</Steps>
6244

63-
### Update app
64-
65-
<Warning>
66-
If your installed app version is lower than 1.0.3, please follow the process below to update.
67-
</Warning>
68-
69-
<Steps>
70-
<Step title="Enter Admin Center">
71-
Go to [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/policies/manage-apps), find and enter the Flashduty app details page.
72-
73-
![2025-09-18-13-50-41](https://docs-cdn.flashcat.cloud/images/png/32a62878f9e765cd8b2eb79ceb00bb02.png)
74-
</Step>
75-
76-
<Step title="Upload New Version">
77-
Upload the new `FlashdutyBot.zip`.
78-
79-
![2025-09-18-13-51-56](https://docs-cdn.flashcat.cloud/images/png/f18ac3504516750c31f8357e65f6d680.png)
80-
</Step>
81-
82-
<Step title="Wait for Update">
83-
Wait for the app version to update in the client (may take tens of minutes).
84-
85-
![2025-09-18-13-52-56](https://docs-cdn.flashcat.cloud/images/png/290f609c30055031ab0ccf6636cdbb01.png)
86-
</Step>
87-
</Steps>
45+
<Note>
46+
In the commands below, replace `{ID}` with the Flashduty Microsoft Teams integration ID. Replace `{ChatName}` with the group chat name.
47+
</Note>
8848

8949
## 3. Link team
9050

9151
<Steps>
9252
<Step title="Find App">
93-
Find the Flashduty On-call app in the app marketplace.
53+
In Teams, open **Apps**, find **Flashduty**, and select **Add to a team**.
9454

9555
<Note>
96-
If app not found, please contact your Microsoft Teams organization administrator.
56+
If you cannot find or add the app, contact your Microsoft Teams administrator.
9757
</Note>
98-
99-
![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
10058
</Step>
10159

10260
<Step title="Add to Team">
@@ -110,23 +68,25 @@ This step must select the target Team's General Channel, otherwise incidents can
11068
</Step>
11169

11270
<Step title="Send Link Command">
113-
In the Team, @Flashduty and send command `linkTeam {ID}`, then click **Link Now**.
71+
In the Team's General channel, @Flashduty and send `linkTeam {ID}`, then select **Link Now**.
11472

11573
![2025-09-18-13-55-05](https://docs-cdn.flashcat.cloud/images/png/3192b5481b0595fcb58e5cc43abad125.png)
11674
</Step>
75+
76+
<Step title="Unlink the Team">
77+
To remove this Team's link, in the same channel send `@Flashduty unlinkTeam {ID}`. Select **Unlink in FlashDuty** in the response card, then confirm the removal in the Flashduty console.
78+
</Step>
11779
</Steps>
11880

11981
## 4. Link chat
12082

12183
<Steps>
12284
<Step title="Find App">
123-
Find the Flashduty On-call app in the app marketplace.
85+
In Teams, open **Apps**, find **Flashduty**, and select **Add to a chat**.
12486

12587
<Note>
126-
If app not found, please contact your Microsoft Teams organization administrator.
88+
If you cannot find or add the app, contact your Microsoft Teams administrator.
12789
</Note>
128-
129-
![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
13090
</Step>
13191

13292
<Step title="Add to Chat">
@@ -136,10 +96,14 @@ Add the app to the target Chat.
13696
</Step>
13797

13898
<Step title="Send Link Command">
139-
In the Chat, @Flashduty and send command `linkChat {ID} {ChatName}`, then click **Link Now**.
99+
In the group chat, @Flashduty and send `linkChat {ID} {ChatName}`, then select **Link Now**.
140100

141101
![2025-09-18-13-56-17](https://docs-cdn.flashcat.cloud/images/png/d0beee141db63714ccecb095affee79b.png)
142102
</Step>
103+
104+
<Step title="Unlink the Chat">
105+
To remove this group's link, send `@Flashduty unlinkChat {ID}` in the same group chat. Select **Unlink in FlashDuty** in the response card, then confirm the removal in the Flashduty console.
106+
</Step>
143107
</Steps>
144108

145109
## 5. Notification card actions
@@ -159,13 +123,11 @@ War room functionality is not currently supported for Microsoft Teams. If you ne
159123

160124
<Steps>
161125
<Step title="Find App">
162-
Find the Flashduty On-call app in the app marketplace.
126+
In Teams, open **Apps**, find **Flashduty**, and select **Open**.
163127

164128
<Note>
165-
If app not found, please contact your Microsoft Teams organization administrator.
129+
If you cannot find or open the app, contact your Microsoft Teams administrator.
166130
</Note>
167-
168-
![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
169131
</Step>
170132

171133
<Step title="Open App">
@@ -175,10 +137,14 @@ Click **Open App**.
175137
</Step>
176138

177139
<Step title="Send Link Command">
178-
Copy and send command `linkUser {}` to the chat, then click **Link Now**.
140+
Send `linkUser {ID}` in your personal chat with Flashduty, then select **Link Now**.
179141

180142
![2025-09-18-13-57-13](https://docs-cdn.flashcat.cloud/images/png/671ae7883bbba839419e539762db99de.png)
181143
</Step>
144+
145+
<Step title="Unlink Your Account">
146+
To remove your Teams account link, send `unlinkUser {ID}` in the same personal chat. Select **Unlink in FlashDuty** in the response card, then confirm the removal in the Flashduty console.
147+
</Step>
182148
</Steps>
183149

184150
## 7. FAQ
@@ -193,6 +159,6 @@ Go to Integration Center → Instant Messaging → **Microsoft Teams**, view in
193159
</Accordion>
194160

195161
<Accordion title="How to unlink teams and users?">
196-
This feature is not currently supported.
162+
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. The command opens the corresponding removal flow in Flashduty.
197163
</Accordion>
198164
</AccordionGroup>

‎zh/on-call/integration/instant-messaging/microsoft-teams.mdx‎

Lines changed: 31 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ keywords: ["Microsoft Teams", "Teams", "即时消息", "告警通知", "IM集成
77
<Tip>**版本要求**：IM 集成需要 On-call 专业版及以上订阅。[了解更多](https://flashcat.cloud/flashduty/price/)</Tip>
88

99
<Warning>
10-
Microsoft Teams 集成现处于 Beta 阶段，以下步骤需由 Microsoft Teams 管理员完成。
10+
如果您的组织限制第三方应用，请先联系 Microsoft Teams 管理员允许使用 Flashduty。
1111
</Warning>
1212

1313
<Note>
@@ -31,73 +31,31 @@ Flashduty Teams 应用不会读取与 Flashduty 功能无关的普通 Teams 聊
3131

3232
当前应用包不申请用于读取全组织聊天内容的 Microsoft Graph 权限。如后续版本引入新的 Teams 权限或数据处理场景，Flashduty 将更新本文档和相关隐私说明。
3333

34-
## 二、安装与更新应用
34+
## 二、从 Microsoft Teams 获取应用
3535

3636
<Steps>
37-
<Step title="下载应用">
38-
将 [FlashdutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) 下载到本地。
37+
<Step title="查找 Flashduty">
38+
在 Microsoft Teams 中选择 **Apps**，搜索 **Flashduty**，然后打开应用详情页。
3939
</Step>
4040

41-
<Step title="安装应用">
42-
进入 Microsoft Teams，导航至 +Apps → Manage your apps → Upload an app → **Upload an app to your org's app catalog**，然后上传应用包 `FlashdutyBot.zip`。
43-
44-
![2025-09-18-13-48-04](https://docs-cdn.flashcat.cloud/images/png/bfa4afaf489c3582e858cad99eb76ae5.png)
45-
</Step>
46-
47-
<Step title="配置应用可见范围">
48-
进入 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com/policies/manage-apps)，找到 Flashduty On-call 应用，将应用可见范围调整为所有人或您指定的范围。
49-
50-
<Tip>
51-
如遇到应用状态为"已阻止"，请稍等片刻后刷新页面或手动修改。
52-
</Tip>
53-
54-
![2025-09-18-13-49-11](https://docs-cdn.flashcat.cloud/images/png/ea961e7965a2d0c69f8575c4252fb333.png)
55-
</Step>
56-
57-
<Step title="验证安装">
58-
等待几分钟，组织成员即可在 +Apps → **Built for your org** 找到此应用。
59-
60-
![2025-09-18-17-05-37](https://docs-cdn.flashcat.cloud/images/png/f7827638d1877005ca674cbbd2aaa4a3.png)
41+
<Step title="添加应用">
42+
选择 **Add**。根据使用场景，选择添加到团队/频道、群聊或个人聊天。
6143
</Step>
6244
</Steps>
6345

64-
### 更新应用
65-
66-
<Warning>
67-
若您已安装的应用版本低于 1.0.3，请按照以下流程更新。
68-
</Warning>
69-
70-
<Steps>
71-
<Step title="进入管理中心">
72-
进入 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com/policies/manage-apps)，找到并进入 Flashduty 应用详情页。
73-
74-
![2025-09-18-13-50-41](https://docs-cdn.flashcat.cloud/images/png/32a62878f9e765cd8b2eb79ceb00bb02.png)
75-
</Step>
76-
77-
<Step title="上传新版本">
78-
上传新版 `FlashdutyBot.zip`。
79-
80-
![2025-09-18-13-51-56](https://docs-cdn.flashcat.cloud/images/png/f18ac3504516750c31f8357e65f6d680.png)
81-
</Step>
82-
83-
<Step title="等待更新">
84-
等待客户端内应用版本更新（可能需要几十分钟）。
85-
86-
![2025-09-18-13-52-56](https://docs-cdn.flashcat.cloud/images/png/290f609c30055031ab0ccf6636cdbb01.png)
87-
</Step>
88-
</Steps>
46+
<Note>
47+
以下指令中的 `{ID}` 请替换为 Flashduty Microsoft Teams 集成 ID；`{ChatName}` 请替换为群聊名称。
48+
</Note>
8949

9050
## 三、关联团队 (Team)
9151

9252
<Steps>
9353
<Step title="查找应用">
94-
在应用市场中找到 Flashduty On-call 应用。
54+
在 Teams 中打开 **Apps**，找到 **Flashduty**，然后选择 **Add to a team**。
9555

9656
<Note>
97-
如无应用，请联系您的 Microsoft Teams 组织管理员。
57+
如果无法找到或添加应用，请联系 Microsoft Teams 管理员。
9858
</Note>
99-
100-
![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
10159
</Step>
10260

10361
<Step title="添加到团队">
@@ -111,23 +69,25 @@ Flashduty Teams 应用不会读取与 Flashduty 功能无关的普通 Teams 聊
11169
</Step>
11270

11371
<Step title="发送关联指令">
114-
在 Team 中 @Flashduty 并发送指令 `linkTeam {ID}`，然后点击 **立即关联**。
72+
在 Team 的 General Channel 中 @Flashduty 并发送 `linkTeam {ID}`，然后选择 **立即关联**。
11573

11674
![2025-09-18-13-55-05](https://docs-cdn.flashcat.cloud/images/png/3192b5481b0595fcb58e5cc43abad125.png)
11775
</Step>
76+
77+
<Step title="解除团队关联">
78+
如需解除该 Team 的关联，请在同一频道中发送 `@Flashduty unlinkTeam {ID}`。在响应卡片中选择 **Unlink in FlashDuty**，然后在 Flashduty 控制台确认解除。
79+
</Step>
11880
</Steps>
11981

12082
## 四、关联群聊 (Chat)
12183

12284
<Steps>
12385
<Step title="查找应用">
124-
在应用市场中找到 Flashduty On-call 应用。
86+
在 Teams 中打开 **Apps**，找到 **Flashduty**，然后选择 **Add to a chat**。
12587

12688
<Note>
127-
如无应用，请联系您的 Microsoft Teams 组织管理员。
89+
如果无法找到或添加应用，请联系 Microsoft Teams 管理员。
12890
</Note>
129-
130-
![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
13191
</Step>
13292

13393
<Step title="添加到群聊">
@@ -137,10 +97,14 @@ Flashduty Teams 应用不会读取与 Flashduty 功能无关的普通 Teams 聊
13797
</Step>
13898

13999
<Step title="发送关联指令">
140-
在 Chat 中 @Flashduty 并发送指令 `linkChat {ID} {ChatName}`，然后点击 **立即关联**。
100+
在群聊中 @Flashduty 并发送 `linkChat {ID} {ChatName}`，然后选择 **立即关联**。
141101

142102
![2025-09-18-13-56-17](https://docs-cdn.flashcat.cloud/images/png/d0beee141db63714ccecb095affee79b.png)
143103
</Step>
104+
105+
<Step title="解除群聊关联">
106+
如需解除该群聊的关联，请在同一群聊中发送 `@Flashduty unlinkChat {ID}`。在响应卡片中选择 **Unlink in FlashDuty**，然后在 Flashduty 控制台确认解除。
107+
</Step>
144108
</Steps>
145109

146110
## 五、消息卡片操作
@@ -160,13 +124,11 @@ Flashduty Teams 应用不会读取与 Flashduty 功能无关的普通 Teams 聊
160124

161125
<Steps>
162126
<Step title="查找应用">
163-
在应用市场中找到 Flashduty On-call 应用。
127+
在 Teams 中打开 **Apps**，找到 **Flashduty**，然后选择 **Open**。
164128

165129
<Note>
166-
如无应用，请联系您的 Microsoft Teams 组织管理员。
130+
如果无法找到或打开应用，请联系 Microsoft Teams 管理员。
167131
</Note>
168-
169-
![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
170132
</Step>
171133

172134
<Step title="打开应用">
@@ -176,10 +138,14 @@ Flashduty Teams 应用不会读取与 Flashduty 功能无关的普通 Teams 聊
176138
</Step>
177139

178140
<Step title="发送关联指令">
179-
复制并发送指令 `linkUser {}` 到聊天中，然后点击 **立即关联**。
141+
在与 Flashduty 的个人聊天中发送 `linkUser {ID}`，然后选择 **立即关联**。
180142

181143
![2025-09-18-13-57-13](https://docs-cdn.flashcat.cloud/images/png/671ae7883bbba839419e539762db99de.png)
182144
</Step>
145+
146+
<Step title="解除个人账号关联">
147+
如需解除您的 Teams 账号关联，请在同一个人聊天中发送 `unlinkUser {ID}`。在响应卡片中选择 **Unlink in FlashDuty**，然后在 Flashduty 控制台确认解除。
148+
</Step>
183149
</Steps>
184150

185151
## 七、常见问题
@@ -194,6 +160,6 @@ Flashduty Teams 应用不会读取与 Flashduty 功能无关的普通 Teams 聊
194160
</Accordion>
195161

196162
<Accordion title="如何取消已关联的团队和用户？">
197-
暂不支持此功能。
163+
请在原始 Teams 上下文中使用对应指令：在 Team 频道中使用 `unlinkTeam {ID}`，在群聊中使用 `unlinkChat {ID}`，或在个人聊天中使用 `unlinkUser {ID}`。指令会打开 Flashduty 中对应的解除关联流程。
198164
</Accordion>
199165
</AccordionGroup>

0 commit comments

Comments
 (0)