Skip to content

Commit 140b00b

Browse files
author
niuweili
committed
Merge branch 'main' into test
2 parents 683ddcb + 877c0eb commit 140b00b

3 files changed

Lines changed: 123 additions & 52 deletions

File tree

flashduty/en/1. On-call/8. Integrations/8.3 IM integration/8.3.5 Microsoft Teams Integration Guide.md

Lines changed: 65 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -7,80 +7,113 @@ url: "https://docs.flashcat.cloud/en/flashduty/microsoft-teams-integration-guide
77

88
Integrate Microsoft Teams as a third-party application to receive and respond to alerts within Microsoft Teams.
99

10-
## I. Install the Application
10+
## I. Install/Update Application
1111
---
1212

13-
Microsoft Teams integration is currently in Beta. Before connecting, you need to complete the following steps:
13+
Microsoft Teams integration is currently in Beta. Before associating, you need to complete the following operations:
1414

1515
::: caution
1616
These steps must be completed by a Microsoft Teams administrator
1717
:::
1818

19-
### 1. Download the Application Package
20-
Download [FlashDutyBot.zip](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/FlashDutyBot.zip) to your local machine
19+
### 1. Download Application
20+
Download [FlashDutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) to your local machine
2121

22-
### 2. Upload the Application Package
22+
### 2. Install Application
2323
Go to **Microsoft Teams, navigate to [+Apps] - [Manage your apps] - [Upload an app] - [Upload an app to your org's app catalog]** and upload the FlashDutyBot.zip package
2424

2525
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/upload-app.png)
2626

27-
### 3. Configure Application Visibility
28-
Go to Microsoft Teams Admin Center, locate the FlashDuty app, and set the app visibility to everyone (or your custom scope)
27+
#### Configure Application Visibility
28+
Go to [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/policies/manage-apps), find the FlashDuty application, and adjust the application visibility to everyone (or your custom scope)
2929

3030
::: tip
31-
If the app status shows [Blocked], please wait a moment and refresh the page or modify it manually
31+
If the application status shows [Blocked], please wait a moment and refresh the page or modify it manually
3232
:::
33-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/manage-app.png)
33+
![](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/install-bot-2.png)
3434

35-
### 4. Verify Installation
36-
Wait a few minutes, and organization members should be able to find the app under [+Apps] - [Built for your org]
35+
#### Check if Installation is Successful
36+
Wait a few minutes, and organization members can find this application integration under [+Apps] - [Built for your org]
3737

38-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/find-app.png)
38+
![](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/find-bot.png)
39+
40+
### 3. Update Application
41+
::: caution
42+
If you have installed an application version lower than 1.0.3, please follow the steps below to update
43+
:::
44+
45+
Go to [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/policies/manage-apps), find and enter the FlashDuty application details page
46+
47+
![update-bot-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-1.png)
48+
49+
Upload the new version FlashdutyBot.zip
50+
51+
![update-bot-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-2.png)
52+
53+
Wait for the application version to update in the client (may take several tens of minutes)
54+
55+
![update-bot-3](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-3.png)
3956

4057
## II. Associate Teams
4158

42-
### 1. Add FlashDuty App to Target Team
59+
### 1. Add FlashDuty Application to Target Team
4360

44-
#### 1.1 Find the FlashDuty App
45-
If the app is not available, please contact your Microsoft Teams organization administrator
46-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/find-app.png)
61+
#### 1.1 Find the FlashDuty Application
62+
If there is no application, please contact your Microsoft Teams organization administrator
63+
64+
![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
4765

4866
#### 1.2 Add to Target Team
4967
::: caution
50-
Note: You must select the General Channel of the target Team, otherwise incidents cannot be sent to the Team
68+
Note: This step must select the General Channel of the target Team, otherwise incidents cannot be sent to the Team
5169
:::
5270

53-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/link-team-1.png)
71+
![link-bot-team-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-team-1.png)
5472

5573
### 2. Send Association Command
5674
@FlashDuty and send linkTeam {ID} to the added Team, then click Associate Now
5775

58-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/link-team-3.png)
76+
![link-bot-team-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-team-2.png)
5977

60-
## III. Associate Users
78+
## III. Associate Chats
6179

62-
### 1. Add FlashDuty App
80+
### 1. Add FlashDuty Application to Target Chat
6381

64-
#### 1.1 Find the FlashDuty App
65-
If the app is not available, please contact your Microsoft Teams organization administrator
66-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/find-app.png)
82+
#### 1.1 Find the FlashDuty Application
83+
If there is no application, please contact your Microsoft Teams organization administrator
6784

68-
#### 1.2 Click Add Button
69-
::: caution
70-
Note: You must select the General Channel of the target Team, otherwise incidents cannot be sent to the Team
71-
:::
85+
![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
86+
87+
#### 1.2 Add to Target Chat
88+
89+
![link-bot-chat-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-chat-1.png)
90+
91+
### 2. Send Association Command
92+
@FlashDuty and send linkChat {ID} {ChatName} to the added Team, then click Associate Now
93+
94+
![link-bot-chat-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-chat-2.png)
95+
96+
## IV. Associate Users
97+
98+
### 1. Add FlashDuty Application
99+
100+
#### 1.1 Find the FlashDuty Application
101+
If there is no application, please contact your Microsoft Teams organization administrator
102+
103+
![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
72104

73-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/link-user-1.png)
105+
#### 1.2 Click to Open Application
106+
![link-bot-user-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-user-1.png)
74107

75108
### 2. Send Association Command
76109
Copy the command: linkUser {} and send it to the chat, then click Associate Now
77110

78-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/link-user-2.png)
111+
![link-bot-user-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-user-2.png)
79112

80113
## Common Issues
81114
<details>
82115
<summary>Team or individual not receiving messages</summary>
83-
Please check if the team and users are successfully associated in Integration Center => Instant Messaging => Microsoft Teams
116+
Please check if the teams and users are successfully associated in Integration Center => Instant Messaging => Microsoft Teams
84117
</details>
85118

86119
<details>
@@ -89,7 +122,7 @@ Please check in Integration Center => Instant Messaging => Microsoft Teams under
89122
</details>
90123

91124
<details>
92-
<summary>How to remove team and user associations</summary>
125+
<summary>How to cancel associated teams and users</summary>
93126
Currently not supported
94127
</details>
95128

flashduty/en/4. Terms/2. User Agreement.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -268,6 +268,8 @@ Flashcat Cloud only provides corresponding security measures according to existi
268268

269269
6.10.1 To provide you with better services, our application integrates the following third-party SDKs:
270270

271+
| Third-party Tool Name | Third-party Name | **User Information Collected** | Purpose and Usage | Information Collection Method | Privacy Policy Link |
272+
|----------------------|------------------|---------------------------|------------------|---------------------------|----------------------|
271273
| Mobile Push-android | Hangzhou Alibaba Cloud Intelligence Technology Co., Ltd. | **Device identifier (Android ID), network status information** | To implement message push functionality, ensuring you receive important alert notifications in a timely manner | Self-collected by SDK | https://terms.aliyun.com/legal-agreement/terms/suit_bu1_ali_cloud/suit_bu1_ali_cloud202112071754_83380.html |
272274
| Huawei Push SDK | Huawei Software Technologies Co., Ltd. | **Application basic information, in-app device identifiers (AAID, Push Token), device hardware information, system basic information and system settings information** | 1. Provide push message services; 2. Statistics of Huawei Push SDK interface call success rate | Self-collected by SDK | https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/sdk-data-security-0000001050042177 |
273275
| Honor Push SDK | Shenzhen Honor Software Technology Co., Ltd. | **Device information, application basic information (AAID, Token)** | For message push on Honor phones | Self-collected by SDK | https://developer.honor.com/cn/docs/11002/guides/sdk-data-security |

flashduty/zh/1. On-call/5. 集成引导/8.3 即时消息/8.3.5 Microsoft Teams 集成指引.md

Lines changed: 56 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/microsoft-teams-integration-guide
66
---
77

88
通过集成 Microsoft Teams 第三方应用,实现在 Microsoft Teams 内接收和响应告警的能力。
9-
## 一、安装应用
9+
## 一、安装/更新应用
1010
---
1111

1212
Microsoft Teams 集成现处于 Beta 阶段,在关联前您需要先完成以下操作:
@@ -15,67 +15,103 @@ Microsoft Teams 集成现处于 Beta 阶段,在关联前您需要先完成以
1515
此步骤需由 Microsoft Teams 管理员完成
1616
:::
1717

18-
### 1. 下载应用包
19-
[FlashDutyBot.zip](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/FlashDutyBot.zip) 下载到本地
18+
### 1. 下载应用
19+
[FlashDutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) 下载到本地
2020

21-
### 2. 上传应用包
21+
### 2. 安装应用
2222
进入 **Microsoft Teams,跳转 [+Apps] - [Manage your apps] - [Upload an app] - [Upload an app to your org's app catalog]** 上传应用包 FlashDutyBot.zip
2323

2424

2525
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/upload-app.png)
2626

27-
### 3. 配置应用可见范围
28-
进入 Microsoft Teams 管理中心,找到 FlashDuty 应用,将应用可见范围调整为所有人(或者您自定义的范围)
27+
#### 配置应用可见范围
28+
进入 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com/policies/manage-apps),找到 FlashDuty 应用,将应用可见范围调整为所有人(或者您自定义的范围)
2929

3030
::: tip
3131
如遇到应用状态为 [已阻止],请稍等片刻后刷新页面或手动修改
3232
:::
33-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/manage-app.png)
33+
![](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/install-bot-2.png)
3434

35-
### 4. 查看是否添加成功
35+
#### 查看是否添加成功
3636
等待几分钟,组织成员即可在 [+Apps] - [Built for your org] 找到此应用集成
3737

38-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/find-app.png)
38+
![](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/find-bot.png)
39+
40+
### 3. 更新应用
41+
::: caution
42+
若您已安装应用版本低于 1.0.3,请按照以下流程更新
43+
:::
44+
45+
进入 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com/policies/manage-apps),找到并进入 FlashDuty 应用详情页
46+
47+
![update-bot-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-1.png)
48+
49+
上传新版 FlashdutyBot.zip
50+
51+
![update-bot-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-2.png)
52+
53+
等待客户端内应用版本更新(可能需要几十分钟)
54+
55+
![update-bot-3](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-3.png)
3956

4057
## 二、关联团队
4158

4259
### 1. 添加 FlashDuty 应用到目标 Team 中
4360

4461
#### 1.1 找到 FlashDuty 应用
4562
如无应用,请联系您的 Microsoft Teams 组织管理员
46-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/find-app.png)
63+
64+
![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
4765

4866
#### 1.2 添加到目标 Team
4967
::: caution
5068
注意:此步必须选择目标 Team 的 General Channel,否则将无法发送故障到 Team 中
5169
:::
5270

53-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/link-team-1.png)
71+
![link-bot-team-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-team-1.png)
5472

5573
### 2. 发送关联指令
5674
@FlashDuty 并发送 linkTeam {ID} 到添加的 Team 中,点击立即关联
5775

58-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/link-team-3.png)
76+
![link-bot-team-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-team-2.png)
77+
78+
## 三、关联团队
5979

60-
## 三、关联用户
80+
### 1. 添加 FlashDuty 应用到目标 Chat 中
81+
82+
#### 1.1 找到 FlashDuty 应用
83+
如无应用,请联系您的 Microsoft Teams 组织管理员
84+
85+
![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
86+
87+
#### 1.2 添加到目标 Chat
88+
89+
![link-bot-chat-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-chat-1.png)
90+
91+
92+
### 2. 发送关联指令
93+
@FlashDuty 并发送 linkChat {ID} {ChatName} 到添加的 Team 中,点击立即关联
94+
95+
![link-bot-chat-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-chat-2.png)
96+
97+
98+
99+
## 四、关联用户
61100

62101
### 1. 添加 FlashDuty 应用
63102

64103
#### 1.1 找到 FlashDuty 应用
65104
如无应用,请联系您的 Microsoft Teams 组织管理员
66-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/find-app.png)
67105

68-
#### 1.2 点击添加按钮
69-
::: caution
70-
注意:此步必须选择目标 Team 的 General Channel,否则将无法发送故障到 Team 中
71-
:::
106+
![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
72107

73-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/link-user-1.png)
108+
#### 1.2 点击打开应用
109+
![link-bot-user-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-user-1.png)
74110

75111
### 2. 发送关联指令
76112
复制指令:linkUser {} 发送到聊天中,再点击立即关联
77113

78-
![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/link-user-2.png)
114+
![link-bot-user-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-user-2.png)
79115

80116
## 常见问题
81117
<details>

0 commit comments

Comments
 (0)