update wecom and teams images

Author: pijiang3

README.md

@@ -25,6 +25,12 @@
 
     - 不要大篇幅使用图片，避免显得没有内容，或UI频繁调整导致文档更新跟不上。
     - 对于高度大于宽度的图片，居中展示，不要铺满整个屏幕。
+    - 使用https://socialscreenshots.com/editor添加背景。
+        - 分辨率：Full HD 16/9
+        - 背景：Raycast 5
+        - 边距：10 圆角：30
+    - 使用aliyun oss upload image插件上传图片
+    - 使用vitepress preview插件实时预览
 
 - **更新和维护**：当产品有新的更新或改变时，产品文档应适时更新以保持准确性。
 
@@ -55,3 +61,13 @@ date: "2023-12-18T10:00:00+08:00"
 ## Flashduty 内部文档
 
 [使用手册](https://alidocs.dingtalk.com/i/nodes/14lgGw3P8vBzjpwpuoARLPA385daZ90D)
+
+- 润色文档
+
+在 cursor 中，选择优秀的模型之后，使用下面的prompt对中文文档进行润色：
+
+```
+请你严格依照 @polish_instructions.md 的要求，对文档 @your_doc_name 进行润色。
+```
+
+完成润色后，可在 VSCode / Cursor 中打开文档，然后在文档 tab 页中右击，点击 `格式化文档`。

flashduty/en/1. On-call/8. Integrations/8.3 IM integration/8.3.1 Feishu(Lark) Integration Guide.md

@@ -1,79 +1,135 @@
 ---
 title: "WeCom Integration"
-description: "Integrate WeCom third-party application to receive and respond to alerts within WeCom"
+description: "By integrating a WeCom application, you can receive and respond to alerts within WeCom."
 date: "2025-05-19T10:00:00+08:00"
-url: "https://docs.flashcat.cloud/en/flashduty/wecom-integration-guide"
+url: "https://docs.flashcat.cloud/en/flashduty/wecom-integration-guide?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5"
 ---
 
-Integrate WeCom third-party application to receive and respond to alerts within WeCom.
+By integrating a WeCom application, you can receive and respond to alerts within WeCom.
+
+This document supports both [integrating third-party applications](#third-party) and [integrating custom enterprise applications](#self).
+
+<div class="hide">
+
+## Watch videos
 
-<!-- >
-## Video Guide
 ---
+
 <Video src="https://download.flashcat.cloud/flashduty/video/wechat.mp4"></Video>
--->
 
-## I. Install the Application
+</div>
+
+> You only need to configure one of the two methods: **Integrate third-party application** or **Integrate custom application**.
+
+<span id="third-party"></span>
+
+## 1. Integrate third-party application
+
 ---
 
-1. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps) - `App Management` - `Third-party`, and select Add Third-party App
+> 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).
+>
+> 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.
+
+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**.
+
+   ![2025-09-18-12-59-55](https://docs-cdn.flashcat.cloud/images/png/783157a331b4b1246c1941dc53874d27.png)
 
-<img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-1.png" alt="drawing" width="500"/>
+2. Enter `Flashduty` in the search bar, and click the **Add** button after finding the application.
 
-2. Search for `flashduty` in the search bar, locate the app, and click the `Add` button
+   ![2025-09-18-13-00-54](https://docs-cdn.flashcat.cloud/images/png/2b36bb53b8a6de1738a626ad00c5fd6e.png)
 
-<img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-2.png" alt="drawing" width="500"/>
+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.
 
-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
+   ![2025-09-18-13-14-47](https://docs-cdn.flashcat.cloud/images/png/4e1bd7ecaedc799ca0a2889f59cf8c00.png)
 
-<img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-3.png" alt="drawing" width="500"/>
+4. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps), go to **My Enterprise** page, and obtain the `Enterprise ID`.
 
-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
+   ![2025-09-18-13-05-43](https://docs-cdn.flashcat.cloud/images/png/11887f4892a2ed05ee13efdca936845f.png)
 
-<img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-4.png" alt="drawing" width="500"/>
+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.
 
-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.**
+<span id="self"></span>
+
+## 2. Integrate custom enterprise application
 
-## II. FAQ
 ---
 
-1. **Clicking the integration save button returns `authorize app first` error?**
+1. Visit [WeCom Admin Console](https://work.weixin.qq.com/wework_admin/frame#apps), go to Application Management → **Applications** page, and click **Create Application**.
 
-   - Check if you've completed the app installation steps, such as whether you can see the `FlashDuty` app in your workspace
-   - Verify if you've correctly configured the `Corp ID`
+   ![2025-09-18-13-06-26](https://docs-cdn.flashcat.cloud/images/png/166b4c18de5677d1fd686a5953dda6a7.png)
 
-2. **How to complete account linking? Or message sending shows `App Not Linked`?**
+2. Configure **Application Logo**, **Application Name**, and **Application Visibility Range**.
 
-   - Log into WeCom client (desktop or mobile), go to `Workspace`, find and enter the `FlashDuty` app
-   - First-time access requires login, choose member account - password or SSO, successful login completes account linking between `Flashduty` and `WeCom`
-   - Subsequent access will be passwordless
+   ![2025-09-18-13-07-17](https://docs-cdn.flashcat.cloud/images/png/c0373856679ae5a37d13dd36562f0c61.png)
 
-3. **How to send incident notifications?**
+3. Return to the Flashduty integration configuration page and select whether WeCom is a `non-private deployment version` based on your actual situation.
+
+   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.
 
-   - Must complete account linking as per Question 1 before sending notifications
-   - Go to channel details page - escalation rule, select WeCom integration in personal channels to complete notification setup
-   - Supports customizing WeCom notification content through template management page. Note: **Custom area supports maximum 8 lines**, excess content will be truncated by WeCom
+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.
 
-<img src="https://download.flashcat.cloud/flashduty/doc/en/wecom/wecom-5.png" alt="drawing" width="500"/>
+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.
 
-4. **How to handle alerts in WeCom?**
+6. On the application details page, obtain the `Secret` and fill it in the Flashduty integration configuration page.
 
-   - Click the card message to directly access alert details
-   - Click `Start Processing` to set alert status to `In Progress`
-   - Click `Close Directly` to set alert status to `Closed`
-   - Click `Snooze 2h` to snooze the alert for 2 hours, click `...` in top-right corner for more snooze options
+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.
 
-5. **Why is there a `Refresh Status` button on card messages?**
+   > The trusted domain needs to point to Flashduty's backend address `{api_host}` (can be achieved through CNAME or proxy forwarding).
+   >
+   > For trusted domain requirements, see the official WeCom documentation [《Internal Development Domain Configuration Guide》](https://open.work.weixin.qq.com/wwopen/common/readDocument/40754).
 
-   - WeCom limits card updates to once per 72 hours after interaction. Each button operation counts as an interaction
-   - Flashduty requests card content updates when alert status changes
-   - When alert status changes frequently, updates might fail due to update limit, use refresh button for one additional update opportunity
+   ![2025-09-18-13-08-43](https://docs-cdn.flashcat.cloud/images/png/8509e75449c933c3f750c93ce621e641.png)
 
-6. **How to open card messages in `System Default Browser` on Mac desktop?**
+   Return to the Flashduty integration configuration page, fill in this domain, and complete the verification.
 
-   - Mac desktop client defaults to internal browser for links
-   - 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
+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.
 
-7. **Incident notification fails with `WeCom License Not Activated`?**
+   ![2025-09-18-13-10-03](https://docs-cdn.flashcat.cloud/images/png/ced9137a2fe74afa34d118ce279579e2.png)
 
-   - Contact Flashduty customer service or dedicated support for license purchase and activation
+   Return to the Flashduty integration configuration page, fill in the saved `Token` and `EncodingAESKey`, and click **Save** to complete the integration.
+
+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**.
+
+   ![2025-09-18-13-10-56](https://docs-cdn.flashcat.cloud/images/png/9a1bee272010ceaa38d2f39025215379.png)
+
+## 3. Configure war room
+
+---
+
+> The war room feature is only supported when **custom enterprise application** mode is enabled.
+
+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.
+
+## 4. FAQ
+
+---
+
+1. **After clicking the integration save button, the system reports `authorize app first`?**
+   - Please check if you have completed the application installation steps. For example, can you see the Flashduty application in the WeCom workplace?
+   - Please check if you have correctly configured the `Corp ID`.
+2. **How to complete account linking or message sending prompts `app not linked`?**
+   - Log in to the WeCom client (both desktop and mobile are acceptable), go to **Workplace**, find and open the Flashduty application.
+   - 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.
+   - Subsequent entries to the application will automatically log in without a password.
+3. **How to send incident notifications?**
+   - Before sending notifications, you must complete account linking as described in the previous question.
+   - Enter the specified channel, navigate to `Escalation Rules` → **Personal Channels**, and select `WeCom` as the notification method.
+   - 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.
+  ![2025-09-18-12-02-26](https://docs-cdn.flashcat.cloud/images/png/9cb6a325b4b16875fec3e0c5054be25b.png)
+4. **How to handle alerts within WeCom?**
+   - Click on the card message to directly enter the alert details page.
+   - Click **Start Processing** to directly set the alert to `Processing` status.
+   - Click **Close Directly** to directly set the alert to `Closed` status.
+   - 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.
+5. **Why does the card message provide a `Status Refresh` button?**
+   - 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.
+   - When the alert status changes, Flashduty will request to update the card content.
+   - 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.
+6. **On Mac desktop, how to set clicking card messages to open with the `system default browser`?**
+   - Mac desktop uses WeCom's built-in browser to open links by default.
+   - 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.
+7. **Incident notification failed with prompt `WeCom license not activated`?**
+   - Please contact Flashduty customer service or your dedicated technical support to purchase and activate the license for you.
+8. **Why is the war room feature not working as expected?**
+   - Please refer to the **FAQ** section of the Flashduty [War Room Introduction](https://docs.flashcat.cloud/en/flashduty/war-room?nav=01JCQ7A4N4WRWNXW8EWEHXCMF5).