flashduty-knowledge-base 1.3.3 → 1.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/iife/en.js CHANGED
@@ -310,7 +310,7 @@ attachment_stripped = true
310
310
  ---
311
311
 
312
312
  Currently, all alerts pushed to Flashduty through the email integration are set to Warning severity. However, you can customize the severity using the [alert pipeline](https://docs.flashcat.cloud/en/flashduty/alert-pipelines).
313
- `,i=`---
313
+ `,o=`---
314
314
  title: "Nightingale/Flashcat Integration"
315
315
  description: "Push alert events from Nightingale (n9e) or Flashcat to Flashduty via webhook. When an alert is triggered, send a trigger event to Flashduty; when an alert recovers, send a recovery event to Flashduty"
316
316
  date: "2025-05-19T10:00:00+08:00"
@@ -506,7 +506,7 @@ Nightingale/Flashcat to Flashduty alert severity mapping:
506
506
 
507
507
  </details>
508
508
 
509
- `,o=`---
509
+ `,i=`---
510
510
  title: "Prometheus Integration Guide"
511
511
  description: "Push Prometheus alert events to Flashduty through AlertManager using webhooks. When an alert is triggered, it sends a trigger event to Flashduty, and when the alert recovers, it sends a recovery event."
512
512
  date: "2025-05-19T10:00:00+08:00"
@@ -1369,7 +1369,7 @@ Alibaba Cloud Monitor event alert to Flashduty severity level mapping:
1369
1369
  | WARNING | Warning | Warning |
1370
1370
  | INFO | Info | Info |
1371
1371
 
1372
- </div>`,u=`---
1372
+ </div>`,h=`---
1373
1373
  title: "Alibaba Cloud Monitor CM Metrics Integration"
1374
1374
  description: "Sync Alibaba Cloud Monitor alert events to Flashduty via webhook for automated alert noise reduction"
1375
1375
  date: "2025-05-19T10:00:00+08:00"
@@ -1594,7 +1594,7 @@ Alibaba Cloud SLS monitoring to Flashduty alert severity mapping:
1594
1594
  | 2 | Info | Info |
1595
1595
 
1596
1596
  </div>
1597
- `,h={CustomAlert:t,Email:a,N9e:i,Prometheus:o,Grafana:s,Zabbix:r,UptimeKuma:l,AliyunARMS:d,AliyunCmEvent:c,AliyunCm:u,AliyunSLS:e,AWSCW:e,AzureMonitor:`---
1597
+ `,u={CustomAlert:t,Email:a,N9e:o,Prometheus:i,Grafana:s,Zabbix:r,UptimeKuma:l,AliyunARMS:d,AliyunCmEvent:c,AliyunCm:h,AliyunSLS:e,AWSCW:e,AzureMonitor:`---
1598
1598
  title: "AWS CloudWatch Integration"
1599
1599
  description: "Sync AWS CloudWatch alert events to Flashduty via webhook to achieve automated alert noise reduction"
1600
1600
  date: "2025-05-19T10:00:00+08:00"
@@ -4811,558 +4811,662 @@ Please contact Flashduty if you wish to modify this mapping.
4811
4811
 
4812
4812
  </div>
4813
4813
  `,Lark:`---
4814
- title: Contributing to our documentation — Meilisearch documentation
4815
- description: The Meilisearch documentation is open-source. Learn how to help make it even better.
4816
- sidebarDepth: 3
4817
- ---
4818
-
4819
- Integrate with Feishu(Lark) custom application to receive and respond to alerts within Feishu/Lark.
4820
-
4821
- <!--
4822
- ## Video Tutorial
4814
+ title: "Feishu/Lark Integration"
4815
+ description: "By integrating a custom Feishu/Lark application, you can receive and respond to alerts within Feishu/Lark."
4816
+ date: "2025-05-19T10:00:00+08:00"
4817
+ url: "https://docs.flashcat.cloud/en/flashduty/lark-integration-guide?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5"
4823
4818
  ---
4824
- <Video src="https://download.flashcat.cloud/flashduty/video/feishu.mp4"></Video>
4825
- -->
4819
+ By integrating a custom Feishu/Lark application, you can receive and respond to alerts within Feishu/Lark.
4826
4820
 
4827
- ## I. Create Feishu/Lark Application
4821
+ ## 1. Create Feishu/Lark application
4828
4822
  ---
4829
4823
 
4830
- ### 1. Create Custom Application
4824
+ ### 1. Create a custom application
4831
4825
 
4832
- Visit [Feishu/Lark Developer Console](https://open.feishu.cn/app) to create an internal custom application. (For details, see Feishu/Lark development documentation - [Create Enterprise Custom Application](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step1#132c1aac))
4826
+ Visit [Feishu/Lark Developer Console](https://open.feishu.cn/app) and create an internal custom application. You can use the [official Flashduty icon](https://download.flashcat.cloud/flashcat_logo_circular.png) for the application icon.
4833
4827
 
4834
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-1.png" alt="drawing" width="400"/>
4828
+ For details, see the Feishu/Lark development documentation [Create an internal custom application](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step1#132c1aac).
4835
4829
 
4836
- You can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) as the application icon.
4830
+ ![2025-09-17-19-20-33](https://docs-cdn.flashcat.cloud/images/png/9af11beec76ef03b935e5ba71ac2f5f5.png)
4831
+ ### 2. Copy credential information
4837
4832
 
4838
- ### 2. Copy Credentials
4833
+ Go to the **Credentials and Basic Information** page and copy the \`App ID\` and \`App Secret\` for later use.
4839
4834
 
4840
- Go to the **Credentials & Basic Info** page, copy the \`App ID\` and \`App Secret\` for later use.
4841
4835
 
4842
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-2.png" alt="drawing" width="800"/>
4836
+ ![2025-09-17-19-24-11](https://docs-cdn.flashcat.cloud/images/png/9b72a772eaa94a7115e8568e9ae7b496.png)
4843
4837
 
4844
- ### 3. Copy Event Callback Token Information
4838
+ ### 3. Copy the event callback Token information
4845
4839
 
4846
- Go to **Development Configuration - Events & Callbacks - Encryption Configuration** page, copy the \`Encrypt Key\` (recommended for better security) and \`Verification Token\` for later use.
4840
+ Go to Development Configuration Events & Callbacks **Encryption Strategy** page, generate and copy the \`Encrypt Key\` (recommended for better security) and \`Verification Token\` for later use.
4847
4841
 
4848
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-2.png" alt="drawing" width="800"/>
4842
+ ![2025-09-17-19-27-24](https://docs-cdn.flashcat.cloud/images/png/48d8ef62cef639cb433078c878c3a4a0.png)
4849
4843
 
4850
- ## II. Add Feishu/Lark Integration
4844
+ ## 2. Add Feishu/Lark integration
4851
4845
  ---
4852
4846
 
4853
- Return to Flashduty **Integration Center** page, select **Instant Messaging => Feishu/Lark**, fill in the \`Name\` and the previously copied \`App ID\`, \`App Secret\`, \`Verification Token\`, and \`Encrypt Key\`, then click save to create.
4847
+ Return to the Flashduty **Integration Center** page, select IM **Feishu/Lark**, fill in the \`Name\` and the \`App ID\`, \`App Secret\`, \`Verification Token\`, and \`Encrypt Key\` copied in the previous step, then click **Save** to complete the creation.
4854
4848
 
4855
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-4.png" alt="drawing" width="800"/>
4849
+ After successful creation, you will see the added Feishu/Lark integration in the list. Click its name to enter the details page, where you can view the **Web Configuration** address, **Redirect URL**, and **Message Card Request URL**, which will be used in subsequent steps.
4856
4850
 
4857
- After creation, you'll see the newly added Feishu/Lark integration in the list. Click on the name to enter details, where you'll find the **Web Configuration** URL, **Redirect URL**, and **Message Card Request URL** information, which will be used in later steps.
4851
+ ![2025-09-17-19-32-56](https://docs-cdn.flashcat.cloud/images/png/b4bfa3d7fdf1af9b8006be168d454700.png)
4858
4852
 
4859
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-5.png" alt="drawing" width="800"/>
4860
-
4861
- ## III. Configure Feishu/Lark Application
4853
+ ## 3. Configure Feishu/Lark application
4862
4854
  ---
4863
4855
 
4864
- ### 1. Enable and Configure Application Capabilities
4856
+ ### 1. Enable and configure application capabilities
4865
4857
 
4866
- 1). Return to the Feishu/Lark Developer Console, enter the newly created application, go to **Add Capabilities - Add by Capability** page, and enable both **Web Application** and **Bot** capabilities.
4858
+ 1. Return to the Feishu/Lark Developer Console, enter the created Feishu/Lark application, go to Add Application Capabilities **Add by Capability** page, and enable both **Web Application** and **Bot** capabilities.
4867
4859
 
4868
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-6.png" alt="drawing" width="800"/>
4860
+ ![2025-09-17-19-42-32](https://docs-cdn.flashcat.cloud/images/png/b12ddbeed2b8d7f508eccc1078c2c12c.png)
4869
4861
 
4870
- 2). Go to **Web Application** page, configure both \`Desktop Homepage\` and \`Mobile Homepage\` with the **Web Configuration** URL from the integration details.
4862
+ 2. Go to the **Web app** page and configure the \`Desktop Homepage\` and \`Mobile Homepage\`, both using the **Web configuration** address from the integration details.
4871
4863
 
4872
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-7.png" alt="drawing" width="800"/>
4864
+ For details, see the Feishu/Lark development documentation [Configure application homepage address](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step1#8366b844).
4873
4865
 
4874
- (See Feishu/Lark development documentation - [Configure Application Homepage URL](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step1#8366b844))
4866
+ ![2025-09-17-19-49-19](https://docs-cdn.flashcat.cloud/images/png/393e7629de652d1793b69af7d4f3831c.png)
4875
4867
 
4876
- 3). Go to **Event Callbacks - Callback Configuration** page, configure the \`Message Card Request URL\` (using the **Message Card Request URL** from integration details) and add the callback.
4868
+ 3. Go to Event Callbacks **Callback Configuration** page, configure the \`Subscription Method\` (using the **Message Card Request URL** from the integration details). Then, subscribe to the following two callback events:
4877
4869
 
4878
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-8.png" alt="drawing" width="800"/>
4879
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-9.png" alt="drawing" width="800"/>
4870
+ - \`im.message.receive_v1\`
4871
+ - \`im.chat.disbanded_v1\`
4880
4872
 
4881
- ### 2. Add Redirect URL to Feishu/Lark Application
4873
+ ![2025-09-17-19-53-14](https://docs-cdn.flashcat.cloud/images/png/c42542dc49930c2e20f5921749bf3565.png)
4882
4874
 
4883
- Go to **Security Settings** page, configure the \`Redirect URL\` using the **Redirect URL** from integration details.
4875
+ ### 2. Add redirect URL to Feishu/Lark application
4884
4876
 
4885
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-10.png" alt="drawing" width="800"/>
4877
+ Go to the **Security Settings** page and configure the \`Redirect URL\` using the **Redirect URL** from the integration details.
4886
4878
 
4887
- (See Feishu/Lark development documentation - [Configure Redirect URL](https://open.feishu.cn/document/uYjL24iN/uYjN3QjL2YzN04iN2cDN?lang=zh-CN#c863e533))
4879
+ For details, see the Feishu/Lark development documentation [Configure redirect URL](https://open.feishu.cn/document/uYjL24iN/uYjN3QjL2YzN04iN2cDN?lang=zh-CN#c863e533).
4888
4880
 
4889
- ### 3. Request Application Permissions
4881
+ ![2025-09-17-19-55-04](https://docs-cdn.flashcat.cloud/images/png/6f97810d9542514c40c276588179e04f.png)
4890
4882
 
4891
- Go to **Permission Management** page, request \`im:chat\` and \`im:message\` permissions. These permissions will allow the application to access its group chat information and send messages to groups or individuals.
4883
+ ### 3. Apply for application permissions
4892
4884
 
4893
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-11.png" alt="drawing" width="800"/>
4885
+ Go to the **Permission Management** page and apply for the following permissions for the group application created in the previous steps:
4894
4886
 
4895
- ## IV. Application Publication and Usage
4896
- ---
4887
+ - \`im:chat\`: Get and update group information
4888
+ - \`im:message\`: Get and send single chat and group messages
4889
+ - \`contact:user.id:readonly\`: Get user ID by phone number or email (for configuring war rooms)<span id="war-room-scope"></span>
4897
4890
 
4898
- After completing the above steps, proceed with application publication and usage. The application can be used after administrator approval.
4899
- Note: **Available Range** needs special configuration, recommended for **All Employees**.
4891
+ ![2025-09-17-19-59-38](https://docs-cdn.flashcat.cloud/images/png/61cb9fbc295e94b4d9acd7e44ac75e13.png)
4900
4892
 
4901
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-12.png" alt="drawing" width="800"/>
4893
+ ## 4. Application release
4894
+ ---
4902
4895
 
4903
- See Feishu/Lark development documentation - [Application Publication and Usage](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step-4).
4896
+ After completing all the above configurations, please release the application. It can be used after administrator approval.
4904
4897
 
4905
- Once published, you can access the application via mobile/PC client. First-time access requires login and account association (Feishu/Lark 《-》 Flashduty), subsequent uses will be login-free.
4898
+ For details, see the Feishu/Lark development documentation [Application release and usage](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step-4).
4906
4899
 
4907
- 1. Mobile: Access the web application through Feishu/Lark > Workspace > Search application name > Open application.
4908
- 2. PC: Access the web application through Feishu/Lark > Workspace > Search application name > Open application.
4900
+ > To ensure that everyone can use the application, adjust the application **visibility** to all employees before releasing the application.
4909
4901
 
4910
- ## V. Common Issues
4911
- ---
4902
+ ![2025-09-17-20-01-46](https://docs-cdn.flashcat.cloud/images/png/af3d458ed4c1a3e3346c91dc6a8fa667.png)
4912
4903
 
4913
- 1. **Unable to deliver messages to individuals**, operation record shows \`Application Not Associated\`?
4914
4904
 
4915
- - Go to Feishu/Lark > Workspace > Search application name > Open application, complete one login and account association (Feishu/Lark 《-》 Flashduty) for the system to obtain user identity for message pushing
4905
+ After the application is released, you can access it via **mobile** or **PC**. The first access requires login to link your Feishu/Lark and Flashduty accounts. Subsequent access will be login-free.
4916
4906
 
4917
- 2. **Message card buttons not working or showing errors**?
4907
+ - **Mobile**: Access via Feishu/Lark Workplace Search for application name → **Open Application** to use the web application.
4908
+ - **PC**: Access via Feishu/Lark → Workplace → Search for application name → **Open Application** to use the web application.
4918
4909
 
4919
- - Ensure account association is completed. Go to Feishu/Lark > Workspace > Search application name > Open application, complete one login and account association (Feishu/Lark 《-》 Flashduty). If already logged in, try clicking the top-right menu to switch accounts and re-login to bind the account
4920
- - Ensure sufficient licenses are purchased. You can check license usage in Console > Billing Center
4910
+ ![2025-09-17-20-05-01](https://docs-cdn.flashcat.cloud/images/png/1da64327149790ceb45ff3b66476be7f.png)
4921
4911
 
4922
- 3. **Empty Feishu/Lark group chat list in escalation rule**?
4912
+ ## 5. Configure war room
4923
4913
 
4924
- - Go to Feishu/Lark, select group chat conversation, add the created Flashduty bot as shown below:
4925
- - Return to the escalation rule configuration page, refresh and reselect the group chat list
4914
+ > Ensure the application has been authorized with the [additional permissions](#war-room-scope) required for the war room feature.
4926
4915
 
4927
- <img alt="drawing" width="800" src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-13.png" />
4928
- <img src="https://download.flashcat.cloud/flashduty/doc/en/feishu/feishu-14.png" alt="drawing" width="800"/>
4916
+ After completing the previous steps, in the **Enhanced Features** module of the Flashduty integration configuration page, check **Enable War Room** to enable this feature without additional configuration.
4929
4917
 
4930
- 4. **Feishu/Lark Custom Application API Limits:** [Feishu/Lark Documentation](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/platform-updates-/custom-app-api-call-limit)
4918
+ ## 6. FAQ
4919
+ ---
4931
4920
 
4932
- **Call Volume Limits:**
4921
+ 1. **Messages cannot be delivered to individuals, and the operation log shows \`app not linked\`?**
4922
+ - Go to Feishu/Lark → Workplace → Search for application name → **Open Application**, complete login once to link your Feishu/Lark and Flashduty accounts, so the system can obtain user identity for message push.
4923
+ 2. **Message card buttons are unresponsive or show errors?**
4924
+ - Ensure the account has been linked. You can go to Feishu/Lark → Workplace → Search for application name → **Open Application** to complete login once. If you have already logged in, try clicking the menu in the upper right corner, switch accounts, and log in again to bind the account.
4925
+ - Ensure you have purchased sufficient licenses. You can check the license usage in Console → **Billing Center**.
4926
+ 3. **The Feishu/Lark group chat list in escalation rules is empty?**
4927
+ - Go to Feishu/Lark and add the created Flashduty bot to the specified group chat.
4928
+ - Return to the escalation rule configuration page, refresh and reselect the group chat list.
4933
4929
 
4934
- | Feishu/Lark Version | Total Calls/Month | Reset Time |
4935
- | :----------: | :--: | :----: |
4936
- |Basic Free Version|10,000 calls|1st of each month|
4937
- |Other Versions|Unlimited|-|
4930
+ ![2025-09-18-14-26-32](https://docs-cdn.flashcat.cloud/images/png/a5878acb02929c9f660c549577de5c17.png)
4938
4931
 
4939
- **Frequency Control Limits:**
4932
+ 4. **Feishu/Lark custom application API limits?**
4933
+ - **Call volume limits:**
4940
4934
 
4941
- | Scenario | Limit |
4942
- | :----------: | :--: |
4943
- |All APIs|Maximum 50 calls/second per application|
4944
- |Message Sending API|Maximum 1000 calls/minute per application|
4945
- |Group Bot Webhook|Maximum 100 calls/minute|
4946
- |Sending messages to the same user or group|Maximum 5 calls/second|
4935
+ | **Feishu/Lark Version** | **Total Calls/Month** | **Refresh Time** |
4936
+ | :---: | :---: | :---: |
4937
+ | Basic Free | 10,000 | 1st of each month |
4938
+ | Other Versions | Unlimited | - |
4947
4939
 
4948
- **Note:** Messages cannot be pushed normally when exceeding limits, please use notification channels reasonably`,Dingtalk:`---
4940
+ - **Rate limits:**
4941
+
4942
+ | **Scenario** | **Limit** |
4943
+ | :---: | :--- |
4944
+ | All APIs | Max 50 calls/second per app |
4945
+ | Send message APIs | Max 1000 calls/minute per app |
4946
+ | Group bot webhook | Max 100 calls/minute |
4947
+ | Send to same user or group | Max 5 calls/second |
4948
+
4949
+ > After exceeding API call limits, the Feishu/Lark application will not be able to push messages normally. It is recommended to use notification channels reasonably. See [Feishu/Lark official documentation](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/platform-updates-/custom-app-api-call-limit) for details.
4950
+ 5. **Why is the war room feature not working as expected?**
4951
+ - Please check again whether you have configured the [required permissions](#war-room-scope) for the war room feature.
4952
+ - Please refer to the **FAQ** section of the Flashduty [War Room Introduction](https://docs.flashcat.cloud/en/flashduty/war-room?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5).`,Dingtalk:`---
4949
4953
  title: "Dingtalk Integration"
4950
- description: "Integrate with Dingtalk custom application to receive and respond to alerts within Dingtalk"
4954
+ description: "By integrating a custom Dingtalk application, you can receive and respond to alerts within Dingtalk."
4951
4955
  date: "2025-05-19T10:00:00+08:00"
4952
- url: "https://docs.flashcat.cloud/en/flashduty/dingtalk-integration-guide"
4956
+ url: "https://docs.flashcat.cloud/en/flashduty/dingtalk-integration-guide?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5"
4953
4957
  ---
4954
4958
 
4955
- Integrate with Dingtalk custom application to receive and respond to alerts within Dingtalk.
4959
+ By integrating a custom Dingtalk application, you can receive and respond to alerts within Dingtalk.
4960
+
4961
+ > This document uses the new version of the Dingtalk Open Platform as an example.
4962
+
4963
+
4964
+ ## I. Create Dingtalk Application and Add Dingtalk Integration
4956
4965
 
4957
- **(This guide uses the new version of Dingtalk Open Platform as an example)**
4958
- <!--
4959
- ## Video Tutorial
4960
- ---
4961
- <Video src="https://download.flashcat.cloud/flashduty/video/dingding.mp4"></Video>
4962
- -->
4963
- ## I. Create Dingtalk Application
4964
4966
  ---
4965
4967
 
4966
- ### 1. Create Custom Application
4968
+ ### 1. Create a Custom Application
4969
+
4970
+ Visit the [Dingtalk Developer Console](https://open-dev.dingtalk.com/fe/app) → Application Development → **Internal Enterprise Development** to create an application.
4971
+
4972
+ For details, please refer to the Dingtalk development documentation [Create an in-house application-H5 micro-application](https://open.dingtalk.com/document/orgapp/microapplication-creation-and-release-process#title-ovn-666-1ty).
4973
+
4974
+ ![2025-09-18-15-02-55](https://docs-cdn.flashcat.cloud/images/png/3a66cc08c2a9ecb5669c985e05deb129.png)
4967
4975
 
4968
- Visit [Dingtalk Developer Console](https://open-dev.dingtalk.com/fe/app) - Application Development - Internal Enterprise Development to create an application. (See Dingtalk development documentation - [Create Internal Enterprise Application - H5 Microapp](https://open.dingtalk.com/document/orgapp/microapplication-creation-and-release-process#title-ovn-666-1ty))
4976
+ You can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) for the application icon.
4969
4977
 
4970
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-1.png" alt="drawing" width="400"/>
4978
+ ### 2. Copy the Enterprise \`CorpId\`
4971
4979
 
4972
- You can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) as the application icon.
4980
+ Click on the enterprise avatar in the top right corner of the page and copy the \`CorpId\` from the dropdown menu.
4973
4981
 
4974
- ### 2. Copy Enterprise CorpId
4982
+ ![2025-09-18-15-03-12](https://docs-cdn.flashcat.cloud/images/png/3abe7ce647a78264290a8d311b62a842.png)
4975
4983
 
4976
- Click on the enterprise in the upper right corner of the page, copy the \`CorpId\` from the dropdown menu for later use.
4984
+ Return to the Flashduty integration configuration page and fill in the corresponding \`CorpId\` in the form.
4977
4985
 
4978
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-2.png" alt="drawing" width="500"/>
4986
+ ### 3. Copy Application Credential Information
4979
4987
 
4980
- ### 3. Copy Application Credentials
4988
+ Enter the application details interface you created, go to the Application Capability → **Credentials and Basic Information** page via the left menu bar, and copy the \`AgentId\`, \`Client ID\`, and \`Client Secret\`.
4981
4989
 
4982
- Go to the **Credentials and Basic Information** page, copy \`AgentID\`, \`ClientID\`, and \`ClientSecret\` for later use.
4990
+ ![2025-09-18-15-04-39](https://docs-cdn.flashcat.cloud/images/png/075fc5989770ef3e76aa39320fe55bdf.png)
4983
4991
 
4984
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-3.png" alt="drawing" width="500"/>
4992
+ Return to the Flashduty integration configuration page and fill in the corresponding \`AgentId\`, \`Client ID\`, and \`Client Secret\` in the form.
4985
4993
 
4986
4994
  ### 4. Copy Event Subscription Information
4987
4995
 
4988
- Go to **Development Configuration - Events and Callbacks** page.
4996
+ Go to Development Configuration **Events and Callbacks** page. Set the push method to \`HTTP Push\`, then click the button to generate an \`Encryption aes_key\` and a \`Signature Token\`, and copy them.
4989
4997
 
4990
- Generate \`Encryption aes_key\` and \`Signature Token\` for later use.
4998
+ ![2025-09-18-15-05-10](https://docs-cdn.flashcat.cloud/images/png/0369b205a2fcf0f798267a4573e54996.png)
4991
4999
 
4992
- **(Note: After generating aes_key and Token, please temporarily save the information elsewhere, as it will disappear after leaving the page)**
5000
+ Return to the Flashduty integration configuration page, fill in the corresponding \`Encryption aes_key\` and \`Signature Token\` in the form, and click the **Save** button.
4993
5001
 
4994
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-4.png" alt="drawing" width="500"/>
5002
+ ### 5. Configure Event Subscription
4995
5003
 
4996
- ## II. Add Dingtalk Integration
4997
- ---
5004
+ Go to the Development Configuration → **Event Subscription** page.
4998
5005
 
4999
- Return to Flashduty **Integration Center** page, select Instant Messaging > Dingtalk, fill in the \`Integration Name\` and application information copied in the previous step, then click save to create.
5006
+ Configure the **Event Subscription Request URL** using the \`Event Subscription Request URL\` from the Flashduty integration details. **Save** after configuration.
5000
5007
 
5001
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-5.png" alt="drawing" width="400"/>
5008
+ ![2025-09-18-15-05-34](https://docs-cdn.flashcat.cloud/images/png/4f2f07c6bfd852b5c47ce2ae63559212.png)
5002
5009
 
5003
- After saving, you will see information such as **Web Configuration** address, **Server Outbound IP** address, and **Event Subscription Request URL**, which will be used in later steps.
5010
+ Below the **Save** button, select the three group session events: \`Group chat name is changed\`, \`Install the cool application in the group\`, and \`Uninstall the cool application in the group\`. Click **Save** after configuration.
5004
5011
 
5005
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-6.png" alt="drawing" width="400"/>
5012
+ ![2025-09-18-15-08-07](https://docs-cdn.flashcat.cloud/images/png/e4fadf912cdad71dbfcc8c3d678f3277.png)
5006
5013
 
5007
- ## III. Configure Dingtalk Application
5008
- ---
5014
+ ### 6. Add Application Capabilities
5009
5015
 
5010
- ### 1. Add Cool App, Web App, and Bot
5011
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-7.png" alt="drawing" width="500"/>
5016
+ Create a Cool App. Go to Development Configuration → Add Application Capability → Cool App → **Cool App List** page, click the **Create Cool App** button, and select **Extend to group sessions**.
5012
5017
 
5013
- 1) Create Cool App: On the **Cool Apps - Cool App List** page, click **Create Cool App** button, select **Extend to Group Chat**
5018
+ Enter the **Edit Cool App** page and complete the following steps:
5014
5019
 
5015
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-8.png" alt="drawing" width="500"/>
5020
+ 1. Fill in the basic information. You can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) for the icon.
5016
5021
 
5017
- 2) Enter the **Edit Cool App** page, complete the following steps:
5022
+ ![2025-09-18-15-11-03](https://docs-cdn.flashcat.cloud/images/png/d5191000378f4df25bb96bc1f19b0db2.png)
5018
5023
 
5019
- 2.1) First step, fill in basic information, you can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) as the icon.
5024
+ 2. Configure the functional design. Select **Group Quick Access** and **Message Card** on the left. You can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) for the group quick access icon. For the desktop and mobile access addresses, please copy the **Cool App Web URL** from the integration details.
5020
5025
 
5021
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-9.png" alt="drawing" width="500"/>
5026
+ ![2025-09-18-15-13-08](https://docs-cdn.flashcat.cloud/images/png/88385f8c5aa382d13bc9f5c0d0b8b18f.png)
5022
5027
 
5023
- 2.2) Second step, configure functionality design, select **Group Quick Access** and **Message Card** on the left. For the group quick access icon, you can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png). Copy the **Cool App Web URL** from the integration details for both desktop and mobile access URLs.
5028
+ 3. Skip the third step of functional development, proceed to the fourth step **Preview & Release**, click the **Release** button and confirm.
5024
5029
 
5025
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-10.png" alt="drawing" width="500"/>
5030
+ ### 7. Configure Bot and Message Push
5026
5031
 
5027
- 2.3) Skip the third step of function development, proceed to the fourth step **Preview and Release**, click the **Release** button and confirm.
5032
+ Go to the Application Capability **Bot** page, enable the bot configuration, fill in the name and upload an icon, then click **Save**. You can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) for the icon.
5028
5033
 
5029
- ### 2. Configure Bot and Message Push
5034
+ ![2025-09-18-15-17-17](https://docs-cdn.flashcat.cloud/images/png/62f4d4582baa0b446876e41e1a9d8eca.png)
5030
5035
 
5031
- Enter the **Application Capabilities - Bot** page, enable bot configuration, fill in the name and upload an icon. You can use the [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png), then save.
5036
+ ### 8. Configure Application URLs
5032
5037
 
5033
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-11.png" alt="drawing" width="500"/>
5038
+ Go to the Application Capability → **Web Application** page.
5034
5039
 
5035
- ### 3. Configure Application URLs
5040
+ Configure the **Application Homepage URL** and **PC Homepage URL** with the \`Application Homepage URL\` and \`PC Homepage URL\` from the Flashduty integration details. Click **Save** when done.
5036
5041
 
5037
- Enter the **Application Capabilities - Web Application** page
5042
+ ![2025-09-18-15-20-13](https://docs-cdn.flashcat.cloud/images/png/9c430307d54f27eaedb009235540f6c5.png)
5038
5043
 
5039
- 1) Configure **Application Homepage URL** and **PC Homepage URL** with the content from the integration details' **Application Homepage URL** and **PC Homepage URL**.
5044
+ ### 9. Apply for Application Permissions
5040
5045
 
5041
- 2) Click **Save** in the upper right corner.
5046
+ Go to the Development Configuration → **Permissions** page and apply for the following permissions for the group application created in the previous steps:
5042
5047
 
5043
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-12.png" alt="drawing" width="500"/>
5048
+ - \`qyapi_chat_manage\`: Get group chat information
5049
+ - \`qyapi_robot_sendmsg\`: Send messages to group chats or individuals
5044
5050
 
5045
- ### 4. Configure Event Subscription
5051
+ ![2025-09-18-15-20-36](https://docs-cdn.flashcat.cloud/images/png/4417440194002a011e2feca5fa5c9469.png)
5046
5052
 
5047
- 1) On the **Development Configuration - Event Subscription** page, configure the **Request URL** with the content from the integration details' **Event Subscription Request URL**, then **Save**.
5053
+ ## II. Configure War Room
5048
5054
 
5049
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-13.png" alt="drawing" width="500"/>
5055
+ > If you do not need to configure the War Room feature, you can skip this step and proceed directly to [**Application Release and Usage**](#publish).
5050
5056
 
5051
- 2) Below the **Save** button, select three group chat events: \`Group Chat Name Change\`, \`Cool App Installation in Group\`, and \`Cool App Uninstallation in Group\`, then **Save**.
5057
+ <span id="war-room-scope"></span>
5052
5058
 
5053
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-14.png" alt="drawing" width="500"/>
5059
+ ### 1. Apply for Application Permissions
5054
5060
 
5055
- ### 5. Apply for Application Permissions
5061
+ Go to the Development Configuration → **Permissions** page and apply for the following permissions for the group application created in the previous steps:
5056
5062
 
5057
- Enter the Permission Management page, apply for \`qyapi_chat_manage\` and \`qyapi_robot_sendmsg\` permissions. These two permissions will allow the current application to obtain its own group chat information and send messages to groups or individuals.
5063
+ - \`qyapi_chat_read\`: Get group chat information
5064
+ - \`qyapi_chat_base_read\`: Get group chat information
5065
+ - \`qyapi_get_member_by_mobile\`: Allows the current application to get Dingtalk user information based on mobile numbers to invite users to join group chats
5058
5066
 
5059
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-15.png" alt="drawing" width="500"/>
5067
+ ![2025-09-18-15-21-28](https://docs-cdn.flashcat.cloud/images/png/39142395390ce09726e3a95991549116.png)
5060
5068
 
5061
- ## IV. Application Release and Usage
5062
- ---
5069
+ ### 2. Configure Group Template
5063
5070
 
5064
- After completing the above steps, go to **Application Release - Version Management and Release**, create a new version, then proceed with the release (make sure to adjust the visibility to all employees, otherwise others cannot use it)
5071
+ Go to Open Capability **Scene Group** from the top menu bar of the Dingtalk Open Platform.
5065
5072
 
5066
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-16.png" alt="drawing" width="500"/>
5067
- <img src="https://download.flashcat.cloud/flashduty/doc/en/ding/ding-17.png" alt="drawing" width="500"/>
5073
+ 1. Configure **Group Bot**. Select **Bot** from the left menu bar, then click **Create group bot**.
5068
5074
 
5069
- After the application is released, you can access it via mobile/PC client. First-time access requires login and account association (Dingtalk 《-》 Flashduty), subsequent uses will be login-free.
5075
+ > The **Group Bot** configured in this step and the **Application Bot** are two different concepts. The group bot is used to automatically create a group bot when a group chat is generated. The group bot and the application bot have different **Bot IDs**. To enable the War Room feature for Dingtalk, you must configure an additional **Group Bot**.
5070
5076
 
5071
- 1. Mobile: Access the web application through Dingtalk > Workspace > Search application name > Open application.
5072
- 2. PC: Access the web application through Dingtalk > Workspace > Search application name > Open application.
5077
+ Fill in the group bot configuration. The **Message Callback URL**, **Message Callback Token**, and **Information Source Website** configurations have no practical effect in Flashduty's application scenario; you can configure them with any values that meet the requirements.
5078
+
5079
+ **Example Configuration**:
5080
+
5081
+ | **Configuration Item** | **Value** |
5082
+ | -------------- | --------------------------------------------------------------------------------- |
5083
+ | Bot Name | Flashduty |
5084
+ | Bot Avatar | [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) |
5085
+ | Introduction | Flashduty |
5086
+ | Message Preview Image | [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) |
5087
+ | Detailed Description | Flashduty message push bot. |
5088
+ | Message Callback URL | \`https://flashcat.cloud/\` |
5089
+ | Message Callback Token | \`token\` |
5090
+ | Information Source Website | \`https://flashcat.cloud/\` |
5091
+
5092
+ After completing the configuration, click **Create**, then click **Approve**. After the "Submission successful" pop-up appears in the top right corner, Dingtalk has automatically completed the approval of the group bot.
5093
+
5094
+ ![2025-09-18-15-22-05](https://docs-cdn.flashcat.cloud/images/png/75e853ae6c420d69916e17f5d8922945.png)
5095
+
5096
+ 2. Configure **Group Template**. Select **Group Template** from the left menu bar, and click **Create group template**.
5097
+
5098
+ Set the **Enterprise Type** to \`Internal Enterprise\` and the **Optional Application** to the custom application created in the previous steps. Then, fill in the template information in the next step.
5099
+
5100
+ Introductory information such as **Template Name**, **Icon**, **Description**, **Copywriting Introduction**, **Template Description**, and **Image Introduction** will not affect the use of the group template feature; you can configure them with any values that meet the requirements.
5101
+
5102
+ **Example Configuration**:
5103
+
5104
+ | **Configuration Item** | **Value** |
5105
+ | ---------- | --------------------------------------------------------------------------------- |
5106
+ | Template Name | Flashduty War Room |
5107
+ | Icon | [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) |
5108
+ | Description | Create a war room for active incidents with one click. |
5109
+ | Copywriting Introduction | Create a war room for active incidents with one click. |
5110
+ | Template Description | Create a war room for active incidents with one click. |
5111
+ | Image Introduction | [Flashduty official icon](https://download.flashcat.cloud/flashcat_logo_circular.png) |
5112
+
5113
+ In the **Select Bot** configuration item, click **Select created bot** and choose the group bot created in the previous step. Keep other configuration items at their default settings. Finally, click **Save Edit**.
5114
+
5115
+ ![2025-09-18-15-22-35](https://docs-cdn.flashcat.cloud/images/png/9292a8418a96fcb3fee1d424a41d33a2.png)
5116
+ ![2025-09-18-15-23-06](https://docs-cdn.flashcat.cloud/images/png/c76433b0962fb0f0531b4f56b60ce903.png)
5117
+
5118
+ In the **Fill in grayscale group** step, click **Create grayscale group**, then click **Publish grayscale**.
5119
+
5120
+ Finally, click **Group Template** in the left menu bar again, then click to enter the group template you just created. Click **Submit for Review**, and after Dingtalk automatically approves it, finally click **Publish**.
5121
+
5122
+ 3. In the published group template details page, copy the **Template ID** and **Bot ID**.
5123
+
5124
+ ![2025-09-18-15-23-46](https://docs-cdn.flashcat.cloud/images/png/315acf0b5951100781f96cd4d854d0c6.png)
5125
+
5126
+ Return to the Flashduty integration configuration page, fill in the corresponding \`Template ID\` and \`Bot ID\` in the form, and click the **Save** button.
5127
+
5128
+ <span id="publish"></span>
5129
+
5130
+ ## III. Application Release and Usage
5073
5131
 
5074
- ## V. Common Issues
5075
5132
  ---
5076
- 1. **Cannot deliver messages to individuals**, operation record shows \`Application Not Associated\`?
5077
5133
 
5078
- - Go to Dingtalk > Workspace > Search application name > Open application, complete one login and account association (Dingtalk 《-》 Flashduty), so the system can obtain user identity for message pushing
5134
+ After completing the above steps, go to Application Release **Version Management and Release**, create a new version, and publish it.
5135
+
5136
+ > To ensure that everyone can use the application, you need to adjust the **Visible Scope** of the application to all employees before publishing.
5137
+
5138
+ ![2025-09-18-16-08-17](https://docs-cdn.flashcat.cloud/images/png/86df5b6148cf1264745d957bd2d43fcf.png)
5139
+
5140
+ After the application is published, you can access it via the **mobile client** or **PC client**. The first time you access it, you need to log in and associate your Dingtalk and Flashduty accounts. Subsequent uses will be login-free.
5079
5141
 
5080
- 2. **Message card buttons are ineffective or show errors?**
5142
+ - **Mobile Client**: Access the web application through Dingtalk → Workbench → Search for application name → **Open Application**.
5143
+ - **PC Client**: Access the web application through Dingtalk → Workbench → Search for application name → **Open Application**.
5081
5144
 
5082
- - Go to Dingtalk > Workspace > Search application name > Open application, complete one login and account association (Dingtalk 《-》 Flashduty). If already logged in, try clicking the menu in the upper right corner, switch accounts, and log in again to bind the account
5083
- - Ensure you have purchased sufficient licenses. You can check license usage in Console > Billing Center
5145
+ ## IV. FAQ
5146
+
5147
+ ---
5084
5148
 
5085
- 3. **Escalation rule Dingtalk group chat list is empty?**
5149
+ 1. **Why can't messages be delivered to individuals, and the operation record shows \`app not linked\`?**
5150
+ - Go to Dingtalk → Workbench → Search for application name → **Open Application**, and complete a login to associate your Dingtalk and Flashduty accounts. The system needs to obtain your user identity to push messages.
5151
+ 2. **Why are the message card buttons not working or showing an error?**
5152
+ - Go to Dingtalk → Workbench → Search for application name → **Open Application**, and complete a login to associate your Dingtalk and Flashduty accounts. If you have already logged in, try clicking the menu in the upper right corner, switching accounts, and logging in again to bind your account.
5153
+ - Ensure you have purchased enough licenses. You can check your used license status in Console → [**Billing Center**](https://console.flashcat.cloud/wallet).
5154
+ 3. **Why is the Dingtalk group chat list in the escalation rule empty?**
5155
+ - Go to Dingtalk, select a group chat session, and install the Cool App. Otherwise, the group chat list cannot be obtained.
5086
5156
 
5087
- - Go to Dingtalk, select group chat and install the Cool App, otherwise the group chat list cannot be obtained
5088
- - Return to the escalation rule configuration page, refresh and reselect the group chat list
5089
- - If still unable to get the group chat list, try uninstalling the Cool App from the group and repeat the above steps. If it still doesn't work, please contact customer or dedicated technical support
5157
+ ![2025-09-18-15-34-37](https://docs-cdn.flashcat.cloud/images/png/7f1e931df0ae740a37ce6615ac3b18ba.png)
5158
+ ![2025-09-18-15-35-44](https://docs-cdn.flashcat.cloud/images/png/367dfd391bf4d57c22088d20a4844e33.png)
5090
5159
 
5091
- <img src="https://download.flashcat.cloud/flashduty/doc/en/dingtalk-install-1.png" alt="drawing" width="500"/>
5160
+ - Return to the escalation rule configuration page, refresh, and reselect the group chat list.
5161
+ - If you still cannot get the group chat list, try uninstalling the Cool App in the group and then repeating the above steps. If the problem persists, please contact customer or dedicated technical support.
5092
5162
 
5093
- <img src="https://download.flashcat.cloud/flashduty/doc/en/dingtalk-install-2.png" alt="drawing" width="500"/>
5163
+ 4. **Why is the War Room feature not working as expected?**
5164
+ - Please double-check if you have configured the [required permissions](#war-room-scope) for the application's War Room feature.
5165
+ - Please refer to the **FAQ** section of the Flashduty [War Room Introduction](https://docs.flashcat.cloud/en/flashduty/war-room?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5) document.
5094
5166
 
5095
- 4. **Dingtalk Custom Application API Call Limits:** [Dingtalk Documentation](https://open.dingtalk.com/document/orgapp/descriptions-about-adjusting-limit-and-frequency-of-api-calls?spm=ding_open_doc.document.0.0.6f6b21d9WtkxJI)
5167
+ 5. **Dingtalk Custom Application API Call Limits**
5096
5168
 
5097
- | Dingtalk Version | Total Calls/Month | QPS| Refresh Time |
5098
- | :----------: | :--: | :----: | :----:|
5099
- |Standard|10,000|20|1st of each month|
5100
- |Professional|500,000|40|1st of each month|
5101
- |Enterprise|5,500,000|60|1st of each month|
5169
+ | **Dingtalk Version** | **Total Calls/Month** | **QPS** | **Refresh Time** |
5170
+ | :----------: | :-------------: | :-----: | :----------: |
5171
+ | Standard | 10,000 | 20 | 1st of each month |
5172
+ | Professional | 500,000 | 40 | 1st of each month |
5173
+ | Exclusive | 5,500,000 | 60 | 1st of each month |
5102
5174
 
5103
- **Note:** Messages cannot be pushed normally after exceeding limits, please use notification channels reasonably
5104
- `,Wecom:`---
5175
+ > After exceeding the API call limit, the Dingtalk application will not be able to push messages normally. It is recommended to use notification channels reasonably. For details, see the [official Dingtalk documentation](https://open.dingtalk.com/document/orgapp/descriptions-about-adjusting-limit-and-frequency-of-api-calls?spm=ding_open_doc.document.0.0.6f6b21d9WtkxJI).`,Wecom:`---
5105
5176
  title: "WeCom Integration"
5106
- description: "Integrate WeCom third-party application to receive and respond to alerts within WeCom"
5177
+ description: "By integrating a WeCom application, you can receive and respond to alerts within WeCom."
5107
5178
  date: "2025-05-19T10:00:00+08:00"
5108
- url: "https://docs.flashcat.cloud/en/flashduty/wecom-integration-guide"
5179
+ url: "https://docs.flashcat.cloud/en/flashduty/wecom-integration-guide?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5"
5109
5180
  ---
5110
5181
 
5111
- Integrate WeCom third-party application to receive and respond to alerts within WeCom.
5182
+ By integrating a WeCom application, you can receive and respond to alerts within WeCom.
5112
5183
 
5113
- <!-- >
5114
- ## Video Guide
5115
- ---
5116
- <Video src="https://download.flashcat.cloud/flashduty/video/wechat.mp4"></Video>
5117
- -->
5184
+ This document supports both [integrating third-party applications](#third-party) and [integrating custom enterprise applications](#self).
5118
5185
 
5119
- ## I. Install the Application
5120
- ---
5121
5186
 
5122
- 1. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps) - \`App Management\` - \`Third-party\`, and select Add Third-party App
5187
+ > You only need to configure one of the two methods: **Integrate third-party application** or **Integrate custom application**.
5123
5188
 
5124
- <img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-1.png" alt="drawing" width="500"/>
5189
+ <span id="third-party"></span>
5125
5190
 
5126
- 2. Search for \`flashduty\` in the search bar, locate the app, and click the \`Add\` button
5191
+ ## 1. Integrate third-party application
5127
5192
 
5128
- <img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-2.png" alt="drawing" width="500"/>
5193
+ ---
5129
5194
 
5130
- 3. Modify the app's \`Visibility\`, recommend setting it to all members or specific departments to avoid modifying settings when adding new members. Click \`Agree and Add\` to complete installation
5195
+ > As a WeCom service provider, Flashduty offers a long-term free version of the Flashduty application. This application requires WeCom API permissions to function (passwordless login + message sending).
5196
+ >
5197
+ > This license currently supports **up to 60 days** free of charge. After exceeding this usage period, Flashduty needs to purchase a WeCom license for you to continue using it.
5131
5198
 
5132
- <img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-3.png" alt="drawing" width="500"/>
5199
+ 1. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps), go to Application Management → **Applications** page, and click **Add Third-party Application**.
5133
5200
 
5134
- 4. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps) - \`My Enterprise\` page, copy the \`Corp ID\` and paste it into the integration configuration as \`Corp ID\`, click save to complete the setup
5201
+ ![2025-09-18-12-59-55](https://docs-cdn.flashcat.cloud/images/png/783157a331b4b1246c1941dc53874d27.png)
5135
5202
 
5136
- <img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-4.png" alt="drawing" width="500"/>
5203
+ 2. Enter \`Flashduty\` in the search bar, and click the **Add** button after finding the application.
5137
5204
 
5138
- 5. **Please Note: As a WeCom service provider, Flashduty offers a long-term free version of the \`FlashDuty\` application. The app requires WeCom API access license for functionality (passwordless login + messaging). This license is free for up to \`60 days\`, after which we must purchase a WeCom license for continued use.**
5205
+ ![2025-09-18-13-00-54](https://docs-cdn.flashcat.cloud/images/png/2b36bb53b8a6de1738a626ad00c5fd6e.png)
5139
5206
 
5140
- ## II. FAQ
5141
- ---
5207
+ 3. Modify the application **visibility range**. It is recommended to select all employees or specific department nodes to avoid needing to modify when new enterprise members are added. Then click **Agree to the above authorization and add** to complete the installation.
5142
5208
 
5143
- 1. **Clicking the integration save button returns \`authorize app first\` error?**
5209
+ ![2025-09-18-13-14-47](https://docs-cdn.flashcat.cloud/images/png/4e1bd7ecaedc799ca0a2889f59cf8c00.png)
5144
5210
 
5145
- - Check if you've completed the app installation steps, such as whether you can see the \`FlashDuty\` app in your workspace
5146
- - Verify if you've correctly configured the \`Corp ID\`
5211
+ 4. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps), go to **My Enterprise** page, and obtain the \`Enterprise ID\`.
5147
5212
 
5148
- 2. **How to complete account linking? Or message sending shows \`App Not Linked\`?**
5213
+ ![2025-09-18-13-05-43](https://docs-cdn.flashcat.cloud/images/png/11887f4892a2ed05ee13efdca936845f.png)
5149
5214
 
5150
- - Log into WeCom client (desktop or mobile), go to \`Workspace\`, find and enter the \`FlashDuty\` app
5151
- - First-time access requires login, choose member account - password or SSO, successful login completes account linking between \`Flashduty\` and \`WeCom\`
5152
- - Subsequent access will be passwordless
5215
+ 5. Return to the Flashduty integration configuration page, fill in the \`Enterprise ID\` obtained in the previous step, and click **Save** to complete the integration.
5153
5216
 
5154
- 3. **How to send incident notifications?**
5217
+ <span id="self"></span>
5155
5218
 
5156
- - Must complete account linking as per Question 1 before sending notifications
5157
- - Go to channel details page - escalation rule, select WeCom integration in personal channels to complete notification setup
5158
- - Supports customizing WeCom notification content through template management page. Note: **Custom area supports maximum 8 lines**, excess content will be truncated by WeCom
5219
+ ## 2. Integrate custom enterprise application
5159
5220
 
5160
- <img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-5.png" alt="drawing" width="500"/>
5221
+ ---
5161
5222
 
5162
- 4. **How to handle alerts in WeCom?**
5223
+ 1. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps), go to Application Management **Applications** page, and click **Create Application**.
5163
5224
 
5164
- - Click the card message to directly access alert details
5165
- - Click \`Start Processing\` to set alert status to \`In Progress\`
5166
- - Click \`Close Directly\` to set alert status to \`Closed\`
5167
- - Click \`Snooze 2h\` to snooze the alert for 2 hours, click \`...\` in top-right corner for more snooze options
5225
+ ![2025-09-18-13-06-26](https://docs-cdn.flashcat.cloud/images/png/166b4c18de5677d1fd686a5953dda6a7.png)
5168
5226
 
5169
- 5. **Why is there a \`Refresh Status\` button on card messages?**
5227
+ 2. Configure **Application Logo**, **Application Name**, and **Application Visibility Range**.
5170
5228
 
5171
- - WeCom limits card updates to once per 72 hours after interaction. Each button operation counts as an interaction
5172
- - Flashduty requests card content updates when alert status changes
5173
- - When alert status changes frequently, updates might fail due to update limit, use refresh button for one additional update opportunity
5229
+ ![2025-09-18-13-07-17](https://docs-cdn.flashcat.cloud/images/png/c0373856679ae5a37d13dd36562f0c61.png)
5174
5230
 
5175
- 6. **How to open card messages in \`System Default Browser\` on Mac desktop?**
5231
+ 3. Return to the Flashduty integration configuration page and select whether WeCom is a \`non-private deployment version\` based on your actual situation.
5176
5232
 
5177
- - Mac desktop client defaults to internal browser for links
5178
- - Try keyboard shortcut \`ctrl\` + \`command\` + \`shift\` + \`d\` to enable debug mode, then select \`Debug - Browser & WebView Related - Open in System Browser\` to change link opening behavior. Use the same shortcut to exit debug mode and retain settings
5233
+ If your WeCom is a private deployment version, you need to fill in the \`Endpoint\` in the configuration page. This address needs to be accessible by the Flashduty service. You may consider setting up **whitelist authorization** for it.
5179
5234
 
5180
- 7. **Incident notification fails with \`WeCom License Not Activated\`?**
5235
+ 4. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps), go to **My Enterprise** page, obtain the \`Enterprise ID\`, and fill it in the Flashduty integration configuration page.
5181
5236
 
5182
- - Contact Flashduty customer service or dedicated support for license purchase and activation
5183
- `,Slack:`---
5184
- title: "Slack Integration"
5185
- description: "Integrate with Slack to receive and respond to alerts within Slack"
5186
- date: "2025-05-19T10:00:00+08:00"
5187
- url: "https://docs.flashcat.cloud/en/flashduty/slack-integration-guide"
5188
- ---
5237
+ 5. Return to [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps), go to **Application Management** page, click on the application you created to enter the details page. Obtain the \`AgentId\` from the page and fill it in the Flashduty integration configuration page.
5189
5238
 
5190
- Integrate with Slack to receive and respond to alerts within Slack.
5239
+ 6. On the application details page, obtain the \`Secret\` and fill it in the Flashduty integration configuration page.
5191
5240
 
5192
- ## I. Install the App
5193
- ---
5241
+ 7. On the application details page, go to **Web Authorization and JS-SDK** page, click **Set Trusted Domain**, and configure **Callback domain for application OAuth 2.0 web authorization** as required.
5194
5242
 
5195
- 1. Go to FlashDuty \`Integration Center\` - \`Instant Messaging\` - \`Slack\` - \`Add\`
5243
+ > The trusted domain needs to point to Flashduty's backend address \`{api_host}\` (can be achieved through CNAME or proxy forwarding).
5244
+ >
5245
+ > For trusted domain requirements, see the official WeCom documentation [《Internal Development Domain Configuration Guide》](https://open.work.weixin.qq.com/wwopen/common/readDocument/40754).
5196
5246
 
5197
- 2. You will be redirected to Slack. Select your \`Workspace\` in the top right corner, then click \`Allow\`
5247
+ ![2025-09-18-13-08-43](https://docs-cdn.flashcat.cloud/images/png/8509e75449c933c3f750c93ce621e641.png)
5198
5248
 
5199
- <img src="https://download.flashcat.cloud/flashduty/integration/slack/slack_app_options.png" alt="drawing" width="400"/>
5249
+ Return to the Flashduty integration configuration page, fill in this domain, and complete the verification.
5200
5250
 
5201
- 3. Enter the integration name and click \`Save\`
5251
+ 8. On the application details page, go to **Receive Messages** page and **Set API Reception**. Click **Random Generation** for both \`Token\` and \`EncodingAESKey\`, then copy and save the generated values.
5202
5252
 
5253
+ ![2025-09-18-13-10-03](https://docs-cdn.flashcat.cloud/images/png/ced9137a2fe74afa34d118ce279579e2.png)
5203
5254
 
5204
- ## II. Common Issues
5205
- ---
5255
+ Return to the Flashduty integration configuration page, fill in the saved \`Token\` and \`EncodingAESKey\`, and click **Save** to complete the integration.
5206
5256
 
5207
- 1. **Cannot find desired private channel in escalation rule channel list**
5208
- - Adding the app to a channel requires Step 1 \`Install App\` to complete without errors
5209
- - In the Slack channel, run \`/invite @FlashDuty\`. A message saying \`has joined\` or \`has been added by xx to xxx\` indicates successful addition
5257
+ 9. Copy the \`Callback Address\` from the Flashduty integration details page, return to the **Receive Messages** page in WeCom. In the **API Reception** settings, fill in the \`Callback Address\` and the \`Token\` and \`EncodingAESKey\` saved in the previous step, then click **Save**.
5210
5258
 
5211
- 2. **Cannot find desired public channel in escalation rule channel list**
5212
- - Add the app authorizer to the public channel
5213
- - Or follow \`Common Issue 1\` to add the app to the channel
5259
+ ![2025-09-18-13-10-56](https://docs-cdn.flashcat.cloud/images/png/9a1bee272010ceaa38d2f39025215379.png)
5214
5260
 
5215
- 3. **Error when clicking Allow button in Step 2 of installation**
5216
- - Try again, as there might be communication issues between the server and Slack causing authorization problems. Return to the add integration page and retry
5217
- - If the error persists, contact customer support
5261
+ ## 3. Configure war room
5218
5262
 
5219
- 4. **Error when clicking Save button in Step 3 of installation**
5220
- - Try again, as there might be communication issues when FlashDuty attempts to obtain the permanent authorization code. Return to the add integration page and retry
5221
- - If the error persists, contact customer support
5263
+ ---
5222
5264
 
5223
- 5. **Slack App shows not_authed error**
5224
- - Try again, as there might be issues with Slack service
5225
- - If the error persists, contact customer support
5265
+ > The war room feature is only supported when **custom enterprise application** mode is enabled.
5226
5266
 
5227
- 6. **Slack App shows Operation timed out error**
5228
- - Try again, as there might be communication timeout issues between the server and Slack
5229
- - If the error persists, contact customer support
5267
+ After completing the previous steps, in the **Enhanced Features** module of the Flashduty integration configuration page, check **Enable War Room** to enable this feature without additional configuration.
5230
5268
 
5231
- 7. **Slack App shows This app responded with Status Code 500 error**
5232
- - Try again, as there might be server errors, such as the integration being disabled
5233
- - If the error persists, contact customer support
5269
+ ## 4. FAQ
5234
5270
 
5235
- 8. **Slack App shows Other questions error**
5236
- - Try again, as this might be an unrecorded issue
5237
- - If the error persists, contact customer support`,MicrosoftTeams:`---
5238
- title: "Microsoft Teams Integration"
5239
- description: "Integrate Microsoft Teams as a third-party application to receive and respond to alerts within Microsoft Teams"
5271
+ ---
5272
+
5273
+ 1. **After clicking the integration save button, the system reports \`authorize app first\`?**
5274
+ - Please check if you have completed the application installation steps. For example, can you see the Flashduty application in the WeCom workplace?
5275
+ - Please check if you have correctly configured the \`Corp ID\`.
5276
+ 2. **How to complete account linking or message sending prompts \`app not linked\`?**
5277
+ - Log in to the WeCom client (both desktop and mobile are acceptable), go to **Workplace**, find and open the Flashduty application.
5278
+ - The first time you enter the application, you need to log in. Select your member account and log in successfully through password or single sign-on to complete the linking of your Flashduty account and WeCom account.
5279
+ - Subsequent entries to the application will automatically log in without a password.
5280
+ 3. **How to send incident notifications?**
5281
+ - Before sending notifications, you must complete account linking as described in the previous question.
5282
+ - Enter the specified channel, navigate to \`Escalation Rules\` → **Personal Channels**, and select \`WeCom\` as the notification method.
5283
+ - Flashduty supports customizing WeCom notification content. You can go to the **Template Management** page to set custom templates. **The custom area can display up to 8 lines**, and excess content will be truncated by WeCom.
5284
+ ![2025-09-18-12-02-26](https://docs-cdn.flashcat.cloud/images/png/9cb6a325b4b16875fec3e0c5054be25b.png)
5285
+ 4. **How to handle alerts within WeCom?**
5286
+ - Click on the card message to directly enter the alert details page.
5287
+ - Click **Start Processing** to directly set the alert to \`Processing\` status.
5288
+ - Click **Close Directly** to directly set the alert to \`Closed\` status.
5289
+ - Click **Snooze for 2 hours** to directly snooze the alert for 2 hours. If you want to snooze for longer, click the \`...\` in the upper right corner of the card to see more snooze options.
5290
+ 5. **Why does the card message provide a \`Status Refresh\` button?**
5291
+ - According to WeCom's restrictions, after one card interaction, it can only be updated once within 72 hours. Each button operation is considered an interaction.
5292
+ - When the alert status changes, Flashduty will request to update the card content.
5293
+ - When the alert status changes frequently, the card may not be updated in real-time due to exceeding the update limit. At this time, you can click the **Refresh** button to manually get a chance to update the card status.
5294
+ 6. **On Mac desktop, how to set clicking card messages to open with the \`system default browser\`?**
5295
+ - Mac desktop uses WeCom's built-in browser to open links by default.
5296
+ - You can try using the shortcut \`ctrl\` + \`command\` + \`shift\` + \`d\` to enable debug mode, then select **Debug** → **Browser, WebView Related** → **Open Web Page with System Browser** to change how links are opened. Use the same shortcut to close debug mode, and the settings will be retained.
5297
+ 7. **Incident notification failed with prompt \`WeCom license not activated\`?**
5298
+ - Please contact Flashduty customer service or your dedicated technical support to purchase and activate the license for you.
5299
+ 8. **Why is the war room feature not working as expected?**
5300
+ - Please refer to the **FAQ** section of the Flashduty [War Room Introduction](https://docs.flashcat.cloud/en/flashduty/war-room?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5).`,Slack:`---
5301
+ title: "Slack Integration"
5302
+ description: "By integrating the Slack third-party application, you can receive and respond to alerts within Slack."
5240
5303
  date: "2025-05-19T10:00:00+08:00"
5241
- url: "https://docs.flashcat.cloud/en/flashduty/microsoft-teams-integration-guide"
5304
+ url: "https://docs.flashcat.cloud/en/flashduty/slack-integration-guide?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5"
5242
5305
  ---
5243
5306
 
5244
- Integrate Microsoft Teams as a third-party application to receive and respond to alerts within Microsoft Teams.
5307
+ By integrating the Slack third-party application, you can receive and respond to alerts within Slack.
5245
5308
 
5246
- ## I. Install/Update Application
5247
- ---
5309
+ <span id="install-app"></span>
5248
5310
 
5249
- Microsoft Teams integration is currently in Beta. Before associating, you need to complete the following operations:
5311
+ ## 1. Install application
5250
5312
 
5251
- ::: caution
5252
- These steps must be completed by a Microsoft Teams administrator
5253
- :::
5313
+ ---
5254
5314
 
5255
- ### 1. Download Application
5256
- Download [FlashDutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) to your local machine
5315
+ 1. Visit Flashduty Integration Center → IM → **Slack**, and click **Add**.
5316
+ 2. On the redirected Slack page, select **Workspace** in the upper right corner, then click **Allow**.
5317
+ ![2025-09-18-15-58-05](https://docs-cdn.flashcat.cloud/images/png/c241bc7f7a657bd552bfe3b03bdb2e3b.png)
5318
+ 3. Enter the data source name and click **Save**.
5257
5319
 
5258
- ### 2. Install Application
5259
- 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
5320
+ ## 2. Configure war room
5260
5321
 
5261
- ![](https://fcpub-1301667576.cos.ap-nanjing.myqcloud.com/flashduty/integration/microsoft-teams/upload-app.png)
5322
+ After completing the previous steps, in the **Enhanced Features** module of the Flashduty integration configuration page, check **Enable War Room** to enable this feature without additional configuration.
5262
5323
 
5263
- #### Configure Application Visibility
5264
- 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)
5324
+ ## 3. FAQ
5265
5325
 
5266
- ::: tip
5267
- If the application status shows [Blocked], please wait a moment and refresh the page or modify it manually
5268
- :::
5269
- ![](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/install-bot-2.png)
5326
+ ---
5270
5327
 
5271
- #### Check if Installation is Successful
5272
- Wait a few minutes, and organization members can find this application integration under [+Apps] - [Built for your org]
5328
+ 1. **The private channel I want is not in the group chat list of escalation rules?**
5329
+ - Ensure the [**Install Application**](#install-app) step has been completed successfully without errors.
5330
+ - Enter the relevant Slack channel and execute the \`/invite @Flashduty\` command. When you see the prompt \`has joined\` or \`has been added by xxx to xxx\`, it means the addition was successful.
5331
+ 2. **The public channel I want is not in the group chat list of escalation rules?**
5332
+ - Add the application authorizer to the public channel.
5333
+ - Refer to the method in **Question 1** to add the application to the channel.
5334
+ 3. **Error after clicking the \`Allow\` button in installation step 2?**
5335
+ - Please retry. This may be due to abnormal communication between the server and Slack causing authorization failure. Please return to the add data source page and try again.
5336
+ - If the error persists after retrying, please contact customer service.
5337
+ 4. **Error after clicking the \`Save\` button in installation step 3?**
5338
+ - Please retry. This may be due to abnormal communication between the Flashduty server and Slack when obtaining the permanent authorization code. Please return to the add data source page and try again.
5339
+ - If the error persists after retrying, please contact customer service.
5340
+ 5. **Slack App prompts \`not_authed\` error?**
5341
+ - Please retry, this may be a temporary issue with Slack service.
5342
+ - If the error persists after retrying, please contact customer service.
5343
+ 6. **Slack App prompts \`Operation timed out\` error?**
5344
+ - Please retry. This may be due to communication timeout between the server and Slack.
5345
+ - If the error persists after retrying, please contact customer service.
5346
+ 7. **Slack App prompts \`This app responded with Status Code 500\` error?**
5347
+ - Please retry. This may be an error on the Flashduty server side (for example, the data source is closed).
5348
+ - If the error persists after retrying, please contact customer service.
5349
+ 8. **Slack App prompts other unknown errors?**
5350
+ - Please retry.
5351
+ - If the error persists after retrying, please contact customer service to record and resolve new issues.
5352
+ 9. **Why is the war room feature not working as expected?**
5353
+ - For previously authorized Slack IM integrations, you need to manually reauthorize Slack in the Flashduty integration configuration page to grant the application the additional permissions required for the war room feature.
5354
+ - Please refer to the **FAQ** section of the Flashduty [War Room Introduction](https://docs.flashcat.cloud/en/flashduty/war-room?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5).`,MicrosoftTeams:`---
5355
+ title: "Microsoft Teams Integration"
5356
+ description: "By integrating the Microsoft Teams third-party application, you can receive and respond to alerts within Microsoft Teams."
5357
+ date: "2025-05-19T10:00:00+08:00"
5358
+ url: "https://docs.flashcat.cloud/en/flashduty/microsoft-teams-integration-guide?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5"
5359
+ ---
5360
+ By integrating the Microsoft Teams third-party application, you can receive and respond to alerts within Microsoft Teams.
5273
5361
 
5274
- ![](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/find-bot.png)
5362
+ ## 1. Install and update application
5363
+ ---
5364
+
5365
+ The Microsoft Teams integration is currently in Beta. You need to complete the following operations before linking.
5275
5366
 
5276
- ### 3. Update Application
5277
5367
  ::: caution
5278
- If you have installed an application version lower than 1.0.3, please follow the steps below to update
5368
+ This step needs to be completed by a Microsoft Teams administrator.
5279
5369
  :::
5280
5370
 
5281
- Go to [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/policies/manage-apps), find and enter the FlashDuty application details page
5282
-
5283
- ![update-bot-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-1.png)
5371
+ ### 1. Download application
5372
+ Download [FlashDutyBot-v1.0.3.zip](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/docs/FlashdutyBot-v1.0.3.zip) to your local device.
5284
5373
 
5285
- Upload the new version FlashdutyBot.zip
5374
+ ### 2. Install application
5375
+ In Microsoft Teams, navigate to +Apps → Manage your apps → Upload an app → **Upload an app to your org's app catalog**, then upload the application package \`FlashDutyBot.zip\`.
5286
5376
 
5287
- ![update-bot-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-2.png)
5377
+ ![2025-09-18-13-48-04](https://docs-cdn.flashcat.cloud/images/png/bfa4afaf489c3582e858cad99eb76ae5.png)
5288
5378
 
5289
- Wait for the application version to update in the client (may take several tens of minutes)
5379
+ #### Configure application visibility
5380
+ 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 specified scope.
5290
5381
 
5291
- ![update-bot-3](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/update-bot-3.png)
5292
-
5293
- ## II. Associate Teams
5382
+ ::: tip
5383
+ If the application status is "Blocked", please wait a moment and refresh the page or manually modify it.
5384
+ :::
5385
+ ![2025-09-18-13-49-11](https://docs-cdn.flashcat.cloud/images/png/ea961e7965a2d0c69f8575c4252fb333.png)
5294
5386
 
5295
- ### 1. Add FlashDuty Application to Target Team
5296
5387
 
5297
- #### 1.1 Find the FlashDuty Application
5298
- If there is no application, please contact your Microsoft Teams organization administrator
5388
+ #### Check if successfully added
5389
+ After waiting a few minutes, organization members can find this application in +Apps → **Built for your org**.
5299
5390
 
5300
- ![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
5391
+ ![2025-09-18-13-49-58](https://docs-cdn.flashcat.cloud/images/png/199728ab0b1f9f24db80da0b3ecc8cd2.png)
5301
5392
 
5302
- #### 1.2 Add to Target Team
5393
+ ### 3. Update application
5303
5394
  ::: caution
5304
- Note: This step must select the General Channel of the target Team, otherwise incidents cannot be sent to the Team
5395
+ If your installed application version is lower than 1.0.3, please follow this process to update.
5305
5396
  :::
5306
5397
 
5307
- ![link-bot-team-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-team-1.png)
5398
+ 1. Go to [Microsoft Teams Admin Center](https://admin.teams.microsoft.com/policies/manage-apps), find and enter the Flashduty application details page.
5399
+ ![2025-09-18-13-50-41](https://docs-cdn.flashcat.cloud/images/png/32a62878f9e765cd8b2eb79ceb00bb02.png)
5308
5400
 
5309
- ### 2. Send Association Command
5310
- @FlashDuty and send linkTeam {ID} to the added Team, then click Associate Now
5401
+ 2. Upload the new version \`FlashdutyBot.zip\`.
5402
+ ![2025-09-18-13-51-56](https://docs-cdn.flashcat.cloud/images/png/f18ac3504516750c31f8357e65f6d680.png)
5311
5403
 
5312
- ![link-bot-team-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-team-2.png)
5404
+ 3. Wait for the application version to update in the client (may take tens of minutes).
5405
+ ![2025-09-18-13-52-56](https://docs-cdn.flashcat.cloud/images/png/290f609c30055031ab0ccf6636cdbb01.png)
5313
5406
 
5314
- ## III. Associate Chats
5407
+ ## 2. Link Team
5408
+ ---
5409
+ ### 1. Add Flashduty application
5410
+ 1. Find the Flashduty application in the app marketplace.
5411
+ > If there is no application, please contact your Microsoft Teams organization administrator.
5315
5412
 
5316
- ### 1. Add FlashDuty Application to Target Chat
5413
+ ![2025-09-18-13-53-57](https://docs-cdn.flashcat.cloud/images/png/8942fdf4327c96abcf31f4a9b7bf12d2.png)
5317
5414
 
5318
- #### 1.1 Find the FlashDuty Application
5319
- If there is no application, please contact your Microsoft Teams organization administrator
5415
+ 2. Add the application to the target Team.
5416
+ ::: caution
5417
+ This step must select the General Channel of the target Team, otherwise incidents cannot be sent to the Team.
5418
+ :::
5320
5419
 
5321
- ![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
5420
+ ![2025-09-18-13-54-41](https://docs-cdn.flashcat.cloud/images/png/8618dfd0f89507a6424e40d898d66fbd.png)
5322
5421
 
5323
- #### 1.2 Add to Target Chat
5422
+ ### 2. Send link command
5423
+ In the Team, @Flashduty and send the command \`linkTeam {ID}\`, then click **Link Now**.
5324
5424
 
5325
- ![link-bot-chat-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-chat-1.png)
5425
+ ![2025-09-18-13-55-05](https://docs-cdn.flashcat.cloud/images/png/3192b5481b0595fcb58e5cc43abad125.png)
5326
5426
 
5327
- ### 2. Send Association Command
5328
- @FlashDuty and send linkChat {ID} {ChatName} to the added Team, then click Associate Now
5427
+ ## 3. Link Chat
5428
+ ---
5429
+ ### 1. Add Flashduty application
5430
+ 1. Find the Flashduty application in the app marketplace.
5431
+ > If there is no application, please contact your Microsoft Teams organization administrator.
5329
5432
 
5330
- ![link-bot-chat-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-chat-2.png)
5433
+ ![2025-09-18-13-53-57](https://docs-cdn.flashcat.cloud/images/png/8942fdf4327c96abcf31f4a9b7bf12d2.png)
5331
5434
 
5332
- ## IV. Associate Users
5435
+ 2. Add the application to the target Chat.
5333
5436
 
5334
- ### 1. Add FlashDuty Application
5437
+ ![2025-09-18-13-56-17](https://docs-cdn.flashcat.cloud/images/png/d0beee141db63714ccecb095affee79b.png)
5335
5438
 
5336
- #### 1.1 Find the FlashDuty Application
5337
- If there is no application, please contact your Microsoft Teams organization administrator
5439
+ ### 2. Send link command
5440
+ In the Chat, @Flashduty and send the command \`linkChat {ID} {ChatName}\`, then click **Link Now**.
5338
5441
 
5339
- ![link-bot](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-1.png)
5442
+ ![2025-09-18-13-56-17](https://docs-cdn.flashcat.cloud/images/png/d0beee141db63714ccecb095affee79b.png)
5340
5443
 
5341
- #### 1.2 Click to Open Application
5342
- ![link-bot-user-1](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-user-1.png)
5444
+ ## 4. Link user
5445
+ ---
5446
+ ### 1. Add Flashduty application
5447
+ 1. Find the Flashduty application in the app marketplace.
5448
+ > If there is no application, please contact your Microsoft Teams organization administrator.
5343
5449
 
5344
- ### 2. Send Association Command
5345
- Copy the command: linkUser {} and send it to the chat, then click Associate Now
5450
+ ![2025-09-18-13-53-57](https://docs-cdn.flashcat.cloud/images/png/8942fdf4327c96abcf31f4a9b7bf12d2.png)
5346
5451
 
5347
- ![link-bot-user-2](https://flashduty-docs.oss-cn-beijing.aliyuncs.com/imges/png/link-bot-user-2.png)
5452
+ 2. Click **Open Application**.
5348
5453
 
5349
- ## Common Issues
5350
- <details>
5351
- <summary>Team or individual not receiving messages</summary>
5352
- Please check if the teams and users are successfully associated in Integration Center => Instant Messaging => Microsoft Teams
5353
- </details>
5454
+ ![2025-09-18-13-56-55](https://docs-cdn.flashcat.cloud/images/png/2e6862103d718a913d2b3c449cbf2366.png)
5354
5455
 
5355
- <details>
5356
- <summary>How to view associated teams and users</summary>
5357
- Please check in Integration Center => Instant Messaging => Microsoft Teams under Associated Teams and Associated Users
5358
- </details>
5456
+ ### 2. Send link command
5457
+ Copy and send the command \`linkUser {}\` to the chat, then click **Link Now**.
5359
5458
 
5360
- <details>
5361
- <summary>How to cancel associated teams and users</summary>
5362
- Currently not supported
5363
- </details>
5459
+ ![2025-09-18-13-57-13](https://docs-cdn.flashcat.cloud/images/png/671ae7883bbba839419e539762db99de.png)
5364
5460
 
5365
- `,AlertWebhook:`Configure alert webhooks to receive HTTP callbacks at your specified URL when alerts have specific actions (such as triggering or closing). The callback content includes the latest key information about the alert, allowing integration with your custom tools.
5461
+ ## 5. FAQ
5462
+ ---
5463
+
5464
+ 1. **Team or individual cannot receive messages?**
5465
+ - Please go to Integration Center → IM → **Microsoft Teams** to check if teams and users have been successfully linked.
5466
+ 2. **How to view linked teams and users?**
5467
+ - Please go to Integration Center → IM → **Microsoft Teams** to view in **Linked Teams** and **Linked Users**.
5468
+ 3. **How to cancel linked teams and users?**
5469
+ - This feature is not currently supported.`,AlertWebhook:`Configure alert webhooks to receive HTTP callbacks at your specified URL when alerts have specific actions (such as triggering or closing). The callback content includes the latest key information about the alert, allowing integration with your custom tools.
5366
5470
 
5367
5471
  <span id="EventTypes"></span>
5368
5472
 
@@ -6233,7 +6337,36 @@ CloseTime | int64 | No | Close time, EndTime is alert recovery time, CloseTime i
6233
6337
  {{jsonGet .Labels.rule_note "#(userId==7777)#.instanceId" }}
6234
6338
 
6235
6339
  \`\`\`
6236
- 10. **如何使用逻辑与、或等条件进行内容显示判断?**
6340
+
6341
+ 10. **How to Retrieve the Image URL via the Src Attribute of [Image](#Image)**
6342
+ - The imageSrcToURL function can be implemented, accepting parameters: $root and Src
6343
+ - If Src is an image_key from the Image Upload API, it should be converted into a short-term accessible URL
6344
+ - If Src is an accessible http/https address, the address should be returned directly
6345
+ - Dingtalk/Slack Apps employ this method to render images
6346
+ \`\`\`go
6347
+ {{ $root := . }}
6348
+ {{ range $i, $v := .Images }}
6349
+ {{ $imageURL := imageSrcToURL $root $v.Src }}
6350
+ {{ if $imageURL }}![]({{$imageURL}}){{ end }}{{end}}
6351
+ \`\`\`
6352
+
6353
+ 11. **How to Convert and Upload Images to a Third-Party Notification Platform**
6354
+ - The transferImage function can be implemented, accepting parameters: $root and Src
6355
+ - Src can be an image_key from the Image Upload API or an accessible http/https image URL
6356
+ - Image size must not exceed 10 MB
6357
+ - Supported image formats include JPG, JPEG, PNG, WEBP, GIF, BMP, ICO, TIFF, HEIC
6358
+ - Requires enabling the application permission to access and upload image or file resources
6359
+ - Lark/Feishu Apps employ this method to render images
6360
+
6361
+ \`\`\`go
6362
+ {{ $root := . }}
6363
+ {{ range $i, $v := .Images }}
6364
+ {{ $transferURL := transferImage $root $v.Src }}
6365
+ {{ if $transferURL }}![]({{$transferURL}}){{ end }}
6366
+ {{ end }}
6367
+ \`\`\`
6368
+
6369
+ 12. **How to use logical AND, OR, and other conditions for conditional rendering/content display judgment?**
6237
6370
 
6238
6371
  \`\`\`
6239
6372
  # Supported functions
@@ -6266,7 +6399,7 @@ CloseTime | int64 | No | Close time, EndTime is alert recovery time, CloseTime i
6266
6399
 
6267
6400
  \`\`\`
6268
6401
 
6269
- 11. **How do I find more functions and their usage examples?**
6402
+ 13. **How do I find more functions and their usage examples?**
6270
6403
  - Function list: https://github.com/flashcatcloud/sprig/blob/master/functions.go#L97
6271
6404
  - Usage examples: Check corresponding _test.go files, e.g., date function test cases at https://github.com/flashcatcloud/sprig/blob/master/date_test.go
6272
6405
 
@@ -6279,10 +6412,15 @@ Below are specific instructions for each notification channel.
6279
6412
  You need to configure \`Integration Center-Instant Message-Feishu\` integration first to send message cards. If custom content is not set, the system default template will be used, rendering all label information:
6280
6413
 
6281
6414
  \`\`\`go
6282
- {{if .Description}}**description** :{{toHtml .Labels.body_text .Description}}{{end}}
6283
- {{if .Labels.resource}}**resource** : {{toHtml (joinAlertLabels . "resource" ", ")}}{{end}}
6415
+ {{if .Labels.body_text}}{{.Labels.body_text}}{{else if .Description}}{{.Description}}{{end}}
6416
+ {{if .Labels.resource}}**resource** : {{(joinAlertLabels . "resource" ", ")}}{{end}}
6284
6417
  {{range $k, $v := .Labels}}
6285
- {{if not (in $k "resource" "body_text")}}**{{$k}}** : {{toHtml $v}}{{end}}{{end}}
6418
+ {{if not (in $k "resource" "body_text" "body_text_with_table")}}**{{$k}}** : {{$v}}{{end}}{{end}}
6419
+ {{ $root := . }}
6420
+ {{ range $i, $v := .Images }}
6421
+ {{ $transferURL := transferImage $root $v.Src }}
6422
+ {{ if $transferURL }}![]({{$transferURL}}){{ end }}
6423
+ {{ end }}
6286
6424
  \`\`\`
6287
6425
 
6288
6426
  As shown below:
@@ -6329,6 +6467,10 @@ You need to configure \`Integration Center-Instant Message-Dingtalk\` integratio
6329
6467
  {{if .Labels.resource}}**resource** : {{toHtml (joinAlertLabels . "resource" ", ")}}{{end}}
6330
6468
  {{range $k, $v := .Labels}}
6331
6469
  {{if not (in $k "resource" "body_text")}}**{{$k}}** : {{toHtml $v}}{{end}}{{end}}
6470
+ {{ $root := . }}
6471
+ {{ range $i, $v := .Images }}
6472
+ {{ $imageURL := imageSrcToURL $root $v.Src }}
6473
+ {{ if $imageURL }}![]({{$imageURL}}){{ end }}{{ end }}
6332
6474
  \`\`\`
6333
6475
 
6334
6476
  As shown below:
@@ -6407,13 +6549,22 @@ As shown below:
6407
6549
 
6408
6550
  ## Slack App
6409
6551
  ---
6552
+
6410
6553
  You need to configure \`Integration Center-Instant Message-Slack\` integration first to send message cards. If custom content is not set, the system default template will be used, rendering only common label information:
6411
6554
 
6412
6555
  \`\`\`go
6413
- {{if .Description}}*description* :{{toHtml .Labels.body_text .Description}}{{end}}
6414
- {{if .Labels.resource}}*resource* : {{toHtml (joinAlertLabels . "resource" ", ")}}{{end}}
6556
+ {{if .Labels.body_text}}{{.Labels.body_text}}{{else if .Description}}{{.Description}}{{end}}
6557
+ {{if .Labels.resource}}*resource* : {{(joinAlertLabels . "resource" ", ")}}{{end}}
6415
6558
  {{range $k, $v := .Labels}}
6416
- {{if not (in $k "resource" "body_text")}}*{{$k}}* : {{toHtml $v}}{{end}}{{end}}
6559
+ {{if not (in $k "resource" "body_text" "body_text_with_table")}}*{{$k}}* : {{$v}}{{end}}{{end}}
6560
+ {{ $root := . }}
6561
+ {{ range $i, $v := .Images }}
6562
+ {{ $imageURL := imageSrcToURL $root $v.Src }}
6563
+ {{ if $imageURL }}
6564
+ ---
6565
+ ![{{$v.Alt}}]({{$imageURL}})
6566
+ {{ end }}
6567
+ {{ end }}
6417
6568
  \`\`\`
6418
6569
 
6419
6570
  As shown below:
@@ -6425,6 +6576,7 @@ If you want to display only key label information, you can refer to the code seg
6425
6576
  - We've listed some common labels, you can add or remove as needed
6426
6577
  - Messages can be around 15000 characters long, content beyond this will be truncated
6427
6578
  - In Slack app, the system will automatically remove empty rendered lines (due to non-existent labels), so you can configure freely
6579
+ - To display images, use three consecutive hyphens \`---\` to separate it from other content. The image syntax must begin with \`![\` format, as demonstrated in the ​​FAQ​​ section
6428
6580
 
6429
6581
  \`\`\`go
6430
6582
  {{if (index .Labels "resource")}}*resource*:{{toHtml (joinAlertLabels . "resource" ", ")}}{{end}}
@@ -7912,7 +8064,7 @@ The user used to access ServiceNow needs to have administrator roles.
7912
8064
 
7913
8065
  1. On the user list page, find the newly created \`flashduty\` user and go to the configuration page.
7914
8066
  2. In the edit page, click \`Set Password\` to set a password.
7915
- 3. Click \`Roles\` to add **admin and itil** roles.
8067
+ 3. Click \`Roles\` to add **personalize_dictionary and itil** roles (If custom field mapping configuration is not required, the personalize_dictionary permission does not need to be retained).
7916
8068
  4. Click \`Update\` to update the configuration.
7917
8069
 
7918
8070
  <img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-2.png" />
@@ -8280,4 +8432,4 @@ Currently, all alerts pushed to Flashduty through the Cloudflare integration are
8280
8432
 
8281
8433
  </div>
8282
8434
 
8283
- `};n.FlashDocsEn=h})(window);
8435
+ `};n.FlashDocsEn=u})(window);