flashduty-knowledge-base 1.3.4 → 1.3.5

package/dist/esm/zh.js

@@ -219,7 +219,7 @@ curl -X POST '{api_host}/event/push/alert/standard?integration_key={integration_
   更多内容请参考 [告警降噪](https://docs.flashcat.cloud/zh/flashduty/what-is-noise-reduction)。
 </details>
 
-`,t=`---
+`,e=`---
 title: "邮件Email集成"
 description: "在 Flashduty 生成唯一的邮件地址，通过邮件的方式将告警的发生与恢复同步到 Flashduty"
 date: "2025-05-19T10:00:00+08:00"
@@ -320,7 +320,7 @@ attachment_stripped = true
 
 当前邮件集成推送到 Flashduty 的告警等级均为Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义严重程度。
 
-`,e=`---
+`,t=`---
 title: "夜莺/FlahCat集成"
 description: "通过 webhook 的方式将夜莺（Nightingale / n9e）或 Flashcat 告警事件推送到 Flashduty。当告警触发时，向 Flashduty 发送触发事件，当告警恢复时，向 Flashduty 发送恢复事件"
 date: "2025-05-19T10:00:00+08:00"
@@ -4059,7 +4059,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/appdynamics-integration-guide"
 |INFO|Info|提醒|
 
 </div>
-`,M=`---
+`,N=`---
 title: "SolarWinds 告警事件"
 description: "通过 webhook 的方式同步 SolarWinds 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-08-20T10:00:00+08:00"
@@ -4164,7 +4164,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/solarwinds-integration-guide"
 |Info|Info|提醒|
 
 </div>
-`,N=`---
+`,R=`---
 title: "火山引擎云监控告警事件"
 description: "通过 webhook 的方式同步火山引擎云监控告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-08-20T10:00:00+08:00"
@@ -4255,7 +4255,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-metric-integration-gui
 |通知|Info|提醒|
 
 </div>
-`,R=`---
+`,M=`---
 title: "火山引擎云监控事件中心告警事件"
 description: "通过 webhook 的方式同步火山引擎云监控事件中心告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -5704,6 +5704,86 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-detect-integration-gui
 </div>
 
 `,X=`---
+title: "企微告警集成"
+description: "在 Flashduty 生成唯一的企微机器人地址，通过企微的方式将告警的发生与恢复同步到 Flashduty"
+date: "2025-05-19T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/zh/flashduty/wecom-alert-integration-guide"
+---
+
+在 Flashduty 生成唯一的企微机器人告警地址，通过企微机器人告警地址将告警的发生与恢复同步到 Flashduty。
+
+<div class="hide">
+
+## 操作步骤
+---
+
+### 创建企微告警集成
+
+您可通过以下2种方式，获取一个企微机器人告警集成地址，任选其一即可。
+
+#### 使用专属集成
+
+当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。
+
+<details>
+  <summary>展开</summary>
+  
+  1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
+  2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
+  3. 选择 **企微告警** 集成，点击 **保存**，生成卡片。
+  4. 点击生成的卡片，可以查看到 **企微告警集成地址**，复制备用，完成。
+    
+</details>
+
+#### 使用共享集成
+
+当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。
+
+<details>
+  <summary>展开</summary>
+  
+  1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
+  2. 选择 **企微告警** 集成：
+        - **集成名称**：为当前集成定义一个名称。
+        - **消息类型**：选择企微告警消息类型，目前仅支持 Text、Markdown。
+        - **推送模式**：选择企微告警在何种情况下触发或恢复告警。
+  3. 复制当前页面的 **企微告警集成地址** 备用。
+  4. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 \`路由\` 进行更多路由规则的配置）。
+  5. 完成。
+    
+</details>
+</div>
+
+### 定制企微告警集成
+
+#### 企微告警集成地址
+
+系统会帮您生成一个唯一的企微告警集成地址，该地址兼容企微机器人消息的协议，在有的平台仅支持企微机器人通道时，您可以使用该地址来接收对应的消息。
+
+#### 推送模式
+
+默认系统总是为每一条消息创建新的告警，但您可以切换模式为：
+
+**根据规则触发或关闭告警**：该模式下，每当接收到新消息，系统会根据您的规则进行消息匹配，匹配到的消息按照规则去触发新告警或关闭已有告警。
+
+   - 您至少需要填写一条**触发**规则；
+   - 您必须设置 Alert Key 的正则提取规则。系统使用该字段来查找历史告警，以便对其进行更新或关闭；**如果正则提取失败，系统将随机来生成 Alert Key**，以确保告警不会因为配置错误而丢失；
+   - 您可以选择，当所有的规则都不匹配时，是否丢弃消息。
+
+   配置示例：
+
+   - 接收所有消息，当消息内容中包含 **RESOVED** 字样时，关闭告警，否则触发新告警；
+   - Alert Key 从消息内容中提取，规则为 **/(.\\*)/**。
+
+
+### 注意事项
+- 企微告警集成地址仅支持接收 Text、Markdown 消息类型，其他消息无法接收。
+- Flashduty 会生成默认告警标题： “企微机器人告警”，如果您需要更改标题，可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义标题。
+
+## 严重程度映射关系
+---
+
+当前企微告警集成推送到 Flashduty 的严重程度均为Warning，但您可以通过[告警处理 Pipeline](https://docs.flashcat.cloud/zh/flashduty/alert-pipelines) 来自定义严重程度。`,Y=`---
 title: "自定义变更事件集成指引"
 description: "通过标准协议推送自有系统变更事件到 Flashduty，大部分故障由变更导致，变更和告警事件联动有助于快速定位故障原因。"
 date: "2025-05-19T10:00:00+08:00"
@@ -5760,7 +5840,7 @@ Flashduty 已经适配部分常用工单、部署系统的 webhook 协议，对
     
 </details>
 
-`,Y=`---
+`,nn=`---
 title: "Jira 事件集成指引"
 description: "通过 webhook 的方式同步 Jira Issue 事件到 Flashduty，实现变更事件收集。"
 date: "2025-05-19T10:00:00+08:00"
@@ -5834,7 +5914,7 @@ Flashduty 默认提取 webhook payload 中 status.name 信息，并按照下边
 如您希望变更此映射关系，请联系 Flashduty。
 
 </div>
-`,nn=`---
+`,en=`---
 title: "飞书集成"
 description: "通过集成飞书自建应用，您可以在飞书端内接收和响应告警。"
 date: "2025-05-19T10:00:00+08:00"
@@ -5895,13 +5975,20 @@ url: "https://docs.flashcat.cloud/zh/flashduty/lark-integration-guide"
 
 ![2025-09-18-10-47-46](https://docs-cdn.flashcat.cloud/images/png/d91efc598bda17e1bfcb367aec47c779.png)
 
-3. 前往 事件回调 → **回调配置** 页面，配置 \`订阅方式\`（内容为集成详情中的 **消息卡片请求网址**）。然后，订阅以下两项回调事件：
+3. 前往 事件回调 → **事件配置** 页面，配置 \`订阅方式\`（内容为集成详情中的 **消息卡片请求网址**）。然后，添加以下两项事件：
 
-- \`im.message.receive_v1\`
 - \`im.chat.disbanded_v1\`
+- \`im.message.receive_v1\`
 
 ![2025-09-18-11-06-05](https://docs-cdn.flashcat.cloud/images/png/71910d8af8d60b5f30baf009081646df.png)
 
+4. 前往 事件回调 → **回调配置** 页面，配置 \`订阅方式\`（内容为集成详情中的 **消息卡片请求网址**）。然后，订阅以下两项回调：
+
+- \`card.action.trigger\`
+- \`card.action.trigger_v1\`
+
+![2025-09-19-18-43-03](https://docs-cdn.flashcat.cloud/images/png/f58b20e52fc53f428bc493e18f0a567f.png)
+
 ### 2. 添加重定向 URL 到飞书应用
 
 进入 **安全设置** 页面，配置 \`重定向URL\`，内容为集成详情中的 **重定向 URL**。
@@ -5916,7 +6003,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/lark-integration-guide"
 
 - \`im:chat\`：获取与更新群组信息
 - \`im:message\`：获取与发送单聊、群组消息
-- \`contact:user.id:readonly\`：通过手机号或邮箱获取用户 ID（用于配置作战室）<span id="war-room-scope"></span>
+- \`contact:user.id:readonly\`：通过手机号或邮箱获取用户 ID <span id="war-room-scope"></span>
 
 ![2025-09-18-10-55-14](https://docs-cdn.flashcat.cloud/images/png/d919be62107f6b9d0c662f440d620e61.png)
 
@@ -6197,7 +6284,6 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-integration-guide"
       ![2025-09-18-15-34-37](https://docs-cdn.flashcat.cloud/images/png/7f1e931df0ae740a37ce6615ac3b18ba.png)
       ![2025-09-18-15-35-44](https://docs-cdn.flashcat.cloud/images/png/367dfd391bf4d57c22088d20a4844e33.png)
 
-
    - 回到分派策略配置页面，刷新后重新选择群聊列表。
    - 如果仍然无法获取群聊列表，请尝试在群内卸载酷应用后，重试以上步骤。如果问题依旧，请联系客户或专属技术支持。
 
@@ -6214,7 +6300,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-integration-guide"
    |    专属版    |    550 万次     |   60    |  每月 1 日   |
 
    > 超出 API 调用量限制后，钉钉应用将无法正常推送消息。建议合理使用通知渠道。详见 [钉钉官方文档](https://open.dingtalk.com/document/orgapp/descriptions-about-adjusting-limit-and-frequency-of-api-calls?spm=ding_open_doc.document.0.0.6f6b21d9WtkxJI)。
-`,en=`---
+`,an=`---
 title: "企业微信 WeCom 集成"
 description: "通过集成企业微信第三方应用，实现在企业微信端接收和响应告警的能力"
 date: "2025-05-19T10:00:00+08:00"
@@ -6309,6 +6395,10 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
 
     ![2025-09-18-11-56-43](https://docs-cdn.flashcat.cloud/images/png/c990c27f7ad90af172e159fc4acfead7.png)
 
+10. 配置可信 IP 地址：47.94.95.118; 123.56.8.183; 47.94.193.81; 1.13.19.96
+
+    ![2025-09-19-11-03-07](https://docs-cdn.flashcat.cloud/images/png/40ee9fe1bea9d2ad1da3180517c45dc7.png)
+
 ## 三、配置作战室
 
 ---
@@ -6350,7 +6440,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
    - 请联系 Flashduty 客服或您的专属技术支持，为您购买并开通许可。
 8. **为什么作战室功能未按预期工作？**
    - 请参考 Flashduty [作战室介绍文档](https://docs.flashcat.cloud/zh/flashduty/war-room) 的 **常见问题** 部分。
-`,an=`---
+`,sn=`---
 title: "Slack 集成"
 description: "通过集成 Slack 第三方应用，您可以在 Slack 内接收和响应告警。"
 date: "2025-05-19T10:00:00+08:00"
@@ -6405,7 +6495,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/slack-integration-guide"
 9. **为什么作战室功能未按预期工作？**
    - 对于之前授权的 Slack IM 集成，需要您在 Flashduty 集成配置页中对 Slack 手动进行重新授权，以使应用获得作战室功能所需的额外权限。
    - 请参考 Flashduty [作战室介绍文档](https://docs.flashcat.cloud/zh/flashduty/war-room) 的 **常见问题** 部分。
-`,sn=`---
+`,dn=`---
 title: "Microsoft Teams 集成"
 description: "通过集成 Microsoft Teams 第三方应用，您可以在 Microsoft Teams 内接收和响应告警。"
 date: "2025-05-19T10:00:00+08:00"
@@ -6441,7 +6531,7 @@ Microsoft Teams 集成现处于 Beta 阶段，在关联前您需要先完成以
 #### 查看是否添加成功
 等待几分钟，组织成员即可在 +Apps → **Built for your org** 找到此应用。
 
-![2025-09-18-13-49-58](https://docs-cdn.flashcat.cloud/images/png/199728ab0b1f9f24db80da0b3ecc8cd2.png)
+![2025-09-18-17-05-37](https://docs-cdn.flashcat.cloud/images/png/f7827638d1877005ca674cbbd2aaa4a3.png)
 
 ### 3. 更新应用
 ::: caution
@@ -6462,21 +6552,22 @@ Microsoft Teams 集成现处于 Beta 阶段，在关联前您需要先完成以
 ---
 ### 1. 添加 Flashduty 应用
 1. 在应用市场中找到 Flashduty 应用。
-> 如无应用，请联系您的 Microsoft Teams 组织管理员。
+   > 如无应用，请联系您的 Microsoft Teams 组织管理员。
+
+   ![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
 
-![2025-09-18-13-53-57](https://docs-cdn.flashcat.cloud/images/png/8942fdf4327c96abcf31f4a9b7bf12d2.png)
 
 2. 将应用添加到目标 Team。
 ::: caution
 此步骤必须选择目标 Team 的 General Channel，否则将无法发送故障到 Team 中。
 :::
 
-![2025-09-18-13-54-41](https://docs-cdn.flashcat.cloud/images/png/8618dfd0f89507a6424e40d898d66fbd.png)
+   ![2025-09-18-17-11-29](https://docs-cdn.flashcat.cloud/images/png/01fa86b63d01d2735aa6c4a53efb3c69.png)
 
 ### 2. 发送关联指令
 在 Team 中 @Flashduty 并发送指令 \`linkTeam {ID}\`，然后点击 **立即关联**。
 
-![2025-09-18-13-55-05](https://docs-cdn.flashcat.cloud/images/png/3192b5481b0595fcb58e5cc43abad125.png)
+   ![2025-09-18-13-55-05](https://docs-cdn.flashcat.cloud/images/png/3192b5481b0595fcb58e5cc43abad125.png)
 
 ## 三、关联群聊 (Chat)
 ---
@@ -6484,11 +6575,11 @@ Microsoft Teams 集成现处于 Beta 阶段，在关联前您需要先完成以
 1. 在应用市场中找到 Flashduty 应用。
 > 如无应用，请联系您的 Microsoft Teams 组织管理员。
 
-![2025-09-18-13-53-57](https://docs-cdn.flashcat.cloud/images/png/8942fdf4327c96abcf31f4a9b7bf12d2.png)
+![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
 
 2. 将应用添加到目标 Chat。
 
-![2025-09-18-13-55-58](https://docs-cdn.flashcat.cloud/images/png/39b505935ef0c751f12b20f6d3e15d10.png)
+![2025-09-18-17-14-23](https://docs-cdn.flashcat.cloud/images/png/6e56d7de341737fe495e5ff18eb1af34.png)
 
 ### 2. 发送关联指令
 在 Chat 中 @Flashduty 并发送指令 \`linkChat {ID} {ChatName}\`，然后点击 **立即关联**。
@@ -6501,7 +6592,7 @@ Microsoft Teams 集成现处于 Beta 阶段，在关联前您需要先完成以
 1. 在应用市场中找到 Flashduty 应用。
 > 如无应用，请联系您的 Microsoft Teams 组织管理员。
 
-![2025-09-18-13-53-57](https://docs-cdn.flashcat.cloud/images/png/8942fdf4327c96abcf31f4a9b7bf12d2.png)
+![2025-09-18-17-06-34](https://docs-cdn.flashcat.cloud/images/png/0905e663241ce448a1381ef8c08aa777.png)
 
 2. 点击 **打开应用**。
 
@@ -6522,7 +6613,7 @@ Microsoft Teams 集成现处于 Beta 阶段，在关联前您需要先完成以
 3. **如何取消已关联的团队和用户？**
    - 暂不支持此功能。
 
-`,dn=`配置告警 Webhook，当告警发生特定操作（如触发、关闭）时，系统通过 HTTP 回调您配置的地址。回调内容将包含告警最新关键信息，您可以与自研工具进行集成。
+`,ln=`配置告警 Webhook，当告警发生特定操作（如触发、关闭）时，系统通过 HTTP 回调您配置的地址。回调内容将包含告警最新关键信息，您可以与自研工具进行集成。
 
 <span id="EventTypes"></span>
 
@@ -6690,7 +6781,7 @@ curl -X POST 'https://example.com/alert/webhook?a=a' \\
 4. **推送来源可信 IP 白名单？**
    - {ip_whitelist}
    - 未来可能会更新，请定期查验
-`,ln=`配置故障 Webhook，当故障发生特定操作（如触发、关闭）时，系统通过 HTTP 回调您配置的地址。回调内容将包含故障最新关键信息，您可以与自研工具进行集成。
+`,on=`配置故障 Webhook，当故障发生特定操作（如触发、关闭）时，系统通过 HTTP 回调您配置的地址。回调内容将包含故障最新关键信息，您可以与自研工具进行集成。
 
 <span id="EventTypes"></span>
 
@@ -6898,7 +6989,7 @@ curl -X POST 'https://example.com/incident/webhook?a=a' \\
 
 4. **推送来源可信 IP 白名单？**
    - {ip_whitelist}
-   - 未来可能会更新，请定期查验`,on=`配置故障 自定义操作，允许您在故障排查期间，快速调用外部接口，实现故障自愈、信息丰富等任何自定义操作。
+   - 未来可能会更新，请定期查验`,rn=`配置故障 自定义操作，允许您在故障排查期间，快速调用外部接口，实现故障自愈、信息丰富等任何自定义操作。
 
 ## 一、创建操作
 
@@ -7157,7 +7248,7 @@ curl -X POST 'https://example.com/incident/action?a=a' \\
 
 2. **推送来源可信 IP 白名单？**
    - {ip_whitelist}
-   - 未来可能会更新，请定期查验`,rn=`---
+   - 未来可能会更新，请定期查验`,cn=`---
 title: "Jira 同步"
 description: "通过 Jira 同步 Webhook，实现故障与 Jira Issue 的关联。"
 date: "2025-05-19T10:00:00+08:00"
@@ -7242,7 +7333,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jira-sync"
 
 - Flashduty 会按照默认的字段映射以及您配置的自定义字段映射进行同步信息，如果您的 Jira 事务类型中有必选的字段且没有配置映射关系，则会遇到创建 Jira Issue 失败的情况。
 - Jira 的 Issue 详情是基于项目 KEY + 编号的格式进行访问的，如果您修改了项目 KEY，可能无法通过 Flashduty 中保存的 Issue 地址进行访问，请谨慎修改项目 KEY。
-`,cn=`---
+`,un=`---
 title: "ServiceNow 同步"
 description: "通过 ServiceNow 同步 Webhook，实现故障与 ServiceNow Incident 的关联。"
 date: "2025-05-19T10:00:00+08:00"
@@ -7254,6 +7345,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/service-now-sync"
 ## 在 ServiceNow
 
 ### 创建用户
+需创建一个用户以连接 ServiceNow 实例，用于 Incident 的同步与更新。如果已有可用用户，请直接跳过本步骤。
 
 1. 登录 ServiceNow 实例控制台，通过选择 \`ALL\` ，输入 \`USERS\` 选择\`Organization\`-\`Users\` 。
 2. 点击 \`New\` 新建用户。
@@ -7261,18 +7353,24 @@ url: "https://docs.flashcat.cloud/zh/flashduty/service-now-sync"
 4. \`Password needs reset\` 和 \`Web service access only\` 以及 \`Internal Integration User\` 保持取消勾选状态。
 5. 提交保存。
 
-<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-1.png" />
+![2025-09-24-16-19-47](https://docs-cdn.flashcat.cloud/images/png/3db86d07758819d61f4e7d2fc714347b.png)
 
 ### 配置用户
 
-用于访问 ServiceNow 的用户需要是管理员角色。
+  > **用户角色说明**
+  > **itil：** 该角色在 Flashduty 中的主要使用范围仅限于在同步 ServiceNow Incident 时，进行获取、创建、更新 ServiceNow Incident，不涉及其他任何操作。
+  >
+  > **personalize_dictionary：** 该角色在 Flashduty 中的主要使用范围仅限于 ServiceNow Incident Table 的字段获取，不涉及其他任何操作。
+  > 
+  > 关于以上两个角色更多权限范围，可以参考 ServiceNow [官方文档](https://www.servicenow.com/docs/bundle/washingtondc-platform-administration/page/administer/roles/reference/r_BaseSystemRoles.html#d130465e3182)
 
 1. 在用户列表页面，找到新创建的 \`flashduty\` 用户并进到配置页面。
 2. 在编辑页面中，点击 \`Set Password\` 设置一个密码。
 3. 点击 \`Roles\` 添加 **personalize_dictionary 和 itil** 角色（如果不需要配置自定义字段映射关系，可以不授予 personalize_dictionary 权限）。
 4. 点击 \`Update\` 更新配置。
 
-<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-2.png" />
+![2025-09-24-16-29-05](https://docs-cdn.flashcat.cloud/images/png/a4416dff926e89b505224e03a4f774c6.png)
+![2025-09-24-16-29-58](https://docs-cdn.flashcat.cloud/images/png/19371c16f4c516c095752f2a8e0d45bf.png)
 
 ## 在 Flashduty
 
@@ -7280,18 +7378,31 @@ url: "https://docs.flashcat.cloud/zh/flashduty/service-now-sync"
 
 将以上配置的用户名/密码以及实例名称输入到左侧集成信息中并点击下一步进行配置。
 
-- **集成名称：** 为当前集成定义一个名称。
-- **管理团队：** 当选择管理团队后，只有该团队成员以及租户管理员可以编辑此集成。
-- **协作空间**：选择该集成生效的协作空间，。
-- **同步方向：**
-  - To_ServiceNow：将 Flashduty 的故障同步至 ServiceNow。
-  - From_ServiceNow：将 ServiceNow 的 Incident 同步至 Flashduty。
-  - Two-way：Flashduty 和 ServiceNow 互相同步。
-- **触发模式**：
-  - 自动触发：需要配置相应的条件，Flashduty 会自动将符合条件的故障同步到 ServiceNow 中。
-  - 手动触发：需要在故障详情页的更多操作中手动触发 ServiceNow 同步（该集成配置的名称为触发器名称）。
-- **严重程度映射**：ServiceNow 的 Priority 是由 Impact 和 Urgency 的值共同决定的，所以可以参考 ServiceNow 的 \`Priority Lookup Rules\` 进行配置。另外需要注意的是，只有当 ServiceNow Incident 的 Urgency 发生变化时，才会触发 Flashduty 故障严重程度的更新。
-- **自定义字段映射**：可以选择将故障的某些标签或所有标签以及自定义字段内容同步至 ServiceNow 的字段中（仅支持文本类型的字段）。
+1. **集成名称：** 为当前集成定义一个名称。
+2. **管理团队：** 当选择管理团队后，只有该团队成员以及租户管理员可以编辑此集成。
+3. **协作空间**：选择该集成生效的协作空间，。
+4. **同步方向：**
+
+    - To_ServiceNow：将 Flashduty 的故障同步至 ServiceNow。
+    - From_ServiceNow：将 ServiceNow 的 Incident 同步至 Flashduty。
+    - Two-way：Flashduty 和 ServiceNow 互相同步。
+
+5. **触发模式**：
+    - 自动触发：需要配置相应的条件，Flashduty 会自动将符合条件的故障同步到 ServiceNow 中。
+    - 手动触发：需要在故障详情页的更多操作中手动触发 ServiceNow 同步（该集成配置的名称为触发器名称）。
+
+6. **严重程度映射**：
+
+    - ServiceNow 的 Priority 是由 Impact 和 Urgency 的值共同决定的，所以可以参考 ServiceNow 的 \`Priority Lookup Rules\` 进行配置。
+    - 当 ServiceNow Incident 的 Urgency 发生变化时，才会触发 Flashduty 故障严重程度的更新。
+    - 由于 Flashduty 在遵循最小权限的情况下，无法获取 ServiceNow 的 Impact 和 Urgency 列表，所以只提供了默认值，如果您需要自定义映射关系时，可以联系技术支持。
+
+7. **自定义字段映射**：可以将故障中的标签或自定义字段，映射到 ServiceNow 工单中的对应文本字段，实现信息自动填充。该功能支持将常见上下文信息（如服务名、实例地址、指标名称等）同步至 ServiceNow，便于后续排查与跟踪。
+
+    - 仅支持目标为单行文本或多行文本类型的字段。
+    - 支持从故障标签（如 service、instance）或自定义属性中提取值。
+    - 若源字段为空，目标字段也将保持为空，不会覆盖原有内容。
+    - 映射配置在集成设置中统一管理，无需每次手动填写。
 
 ## 在 ServiceNow
 
@@ -7332,7 +7443,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/service-now-sync"
 2. 点击 \`New\` 新建 Script Include。
 3. \`Name\` 输入：**IncidentWebhookHelper** ， \`Accessible from\` 选择 **All application scopes**。
 4. \`Client callable\` 和 \`Active\` 保持勾选状态。
-5. \`Script\` 输入以下内容，其中 **request.setEndpoint** 中需要补充集成的推送地址：
+5. \`Script\` 输入以下内容，其中 **request.setEndpoint** 中需要补充集成的<span class='integration_url'>推送地址</span>：
 
 <div class="hide">
 
@@ -7426,7 +7537,7 @@ IncidentWebhookHelper.prototype = {
 3. \`Name\` 输入：**Send To Flashduty** ， \`Table\` 选择 **Incident**。
 4. \`Advanced\` 和 \`Active\` 保持勾选状态。
 5. 在 \`When to run\` 区域中，\`When\` 选择 **async**，\`Insert\` 和 \`Upsert\` 保持勾选状态，其他按需配置。
-6. 在 \`Advanced\` 区域中，\`Script\` 填写以下内容，其中 **endpoint** 中需要补充集成的推送地址：
+6. 在 \`Advanced\` 区域中，\`Script\` 填写以下内容，其中 **endpoint** 中需要补充集成的<span class='integration_url'>推送地址</span>
 
 <div class="hide">
 
@@ -7497,23 +7608,23 @@ IncidentWebhookHelper.prototype = {
 
 | ServiceNow          | Flashduty     | 备注 |
 | ------------------- | ------------- | ---- |
-| Short_description   | Title         |      |
-| Description         | Description   |      |
-| Additional comments | Comments      |      |
-| State               | Progress      |      |
-| Urgency             | Severity      |      |
-| Others              | Custom Fields |      |
+| Short_description   | Title         |   标题   |
+| Description         | Description   |   描述信息   |
+| Additional comments | Comments      |   评论   |
+| State               | Progress      |   状态   |
+| Urgency             | Severity      |   严重程度   |
+| Others              | Custom Fields |   自定义字段   |
 
 ### 状态映射
 
 | ServiceNow  | Flashduty  | 备注            |
 | ----------- | ---------- | --------------- |
-| New         | Trigger    |                 |
-| In Progress | Processing |                 |
+| New         | Trigger    |   触发              |
+| In Progress | Processing |   待处理            |
 | On Hold     | Snoozed    | 默认暂缓 2 小时 |
-| Resolved    | CLosed     |                 |
-| Closed      | CLosed     |                 |
-| Canceled    | CLosed     |                 |
+| Resolved    | CLosed     |       关闭          |
+| Closed      | CLosed     |       关闭         |
+| Canceled    | CLosed     |       关闭          |
 
 ### 优先级映射
 
@@ -7521,10 +7632,210 @@ IncidentWebhookHelper.prototype = {
 
 | ServiceNow | Flashduty | 备注 |
 | ---------- | --------- | ---- |
-| Low        | Info      |      |
-| Medium     | Warning   |      |
-| High       | Critical  |      |
-`,un=`---
+| Low        | Info      |   提示   |
+| Medium     | Warning   |   警告  |
+| High       | Critical  |   灾难   |
+
+## 常见问题
+
+<details>
+  <summary>新建 ServiceNow 用户时，UserID 是否可以自定义？</summary>
+  可以自定义，文档指引中使用 flashduty 作为 UserID，是为了更好的标识该用户用于 Incident 同步
+</details>
+
+<details>
+  <summary>配置集成时提示 401 错误 </summary>
+  提示 401 一般是密码错误导致的，请检查密码是否正确，或者重新设置新的密码(在配置密码时，请勿勾选 Password needs reset 选项)
+</details>`,hn=`---
+title: "ServiceDesk Plus 同步"
+description: "通过 ServiceDesk Plus 同步 Webhook，实现故障与 ServiceDesk Plus request 的关联。"
+date: "2025-05-19T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
+---
+
+通过 ServiceDesk Plus 同步 Webhook，将 Flashduty 的故障与 ServiceDesk Plus request 进行关联同步，实现 Flashduty 与 ServiceDesk Plus 的联动。
+
+本集成基于 ServiceDesk Plus 官方提供的 v3 API 协议，兼容其接口规范。若您使用私有化部署版本，请确认其 API 是否支持 v3 版本。此外，ServiceDesk Plus 的云版本与私有化版本在授权配置方式上存在差异，具体配置请参考相关文档说明。
+
+  - [云版本](#云版本)
+  - [私有化](#私有化)
+
+在配置此集成时，如果您选择的同步方向是 From_ServiceDesk_Plus，您可以直接跳过授权相关配置，直接参考[配置同步](#配置同步)即可。
+
+## 云版本 <span id="云版本"></span>
+
+### 在 ServiceDesk Plus
+#### 步骤1 创建授权应用
+请根据您的 ServiceDesk Plus 服务区域选择对应的 Developer Console 地址：[Data Centres](https://www.manageengine.com/products/service-desk/sdpod-v3-api/getting-started/data-centers.html)
+
+1. 登录 Developer Console，选择 \`Self Client\` 类型的 Client 并创建。
+2. 点击 \`Generate Code\`，在 \`Scope\` 中填写：**SDPOnDemand.requests.ALL,SDPOnDemand.setup.READ,SDPOnDemand.custommodule.READ**。权限范围参考[官方文档](https://www.manageengine.com/products/service-desk/sdpod-v3-api/getting-started/oauth-2.0.html#scopes)。
+
+3. \`Time Duration\` 选择最大的 **10 minutes**，\`Scope Description\` 填写内容可自定义，比如： Flashduty 同步使用，并创建。
+4. 将生成的 **Code** 和 **Client ID** 以及 **Client Secret** 复制备用。
+
+![2025-09-24-14-59-28](https://docs-cdn.flashcat.cloud/images/png/793fa15bd6e919e81fd3baaaab591275.png)
+![2025-09-24-15-00-56](https://docs-cdn.flashcat.cloud/images/png/3b1b9d7a9c4bcc93ddf4cd73e47713f5.png)
+
+###### 注意：Code 的有效期只有 10 分钟且只能使用一次，所以在获取到 Code 后，请在有效期内尽快完成[集成授权](#集成授权)
+
+### 在 Flashduty
+#### 步骤2 集成授权 <span id="集成授权"></span>
+请根据您的 ServiceDesk Plus 服务区域选择对应的 API Endpoint 和 Accounts Server URL：[Data Centres](https://www.manageengine.com/products/service-desk/sdpod-v3-api/getting-started/data-centers.html)
+
+1. \`平台类型\` 选择**云版本**，填写\`API Endpoint\` 和 \`Accounts Server URL\`。
+2. 将**创建授权应用**步骤中生成的 \`Code\` 和 \`Client ID\` 以及 \`Client Secret\` 填写到对应的编辑框并点击下一步完成[集成配置](#集成配置)（如果报错请重新获取 Code，或联系技术支持排查问题）。
+
+## 私有化版本 <span id="私有化"></span>
+### 在 ServiceDesk Plus
+#### 步骤1 生成 API 密钥
+1. 登录 ServiceDesk Plus 控制台，在个人中心点击 \`生成 API 密钥\`。
+2. \`令牌过期时间\` 选择 **永不过期**，将生成的 **Token** 复制备用，并完成[集成授权](#私有化版本集成授权)。
+
+###### 注意：生成 API 密钥的用户需要具备相关权限，比如创建/更新请求、获取模版/优先级/自定义字段列表等权限，如果权限不足，会导致无法完成集成配置，建议使用管理员角色生成。
+
+### 在 Flashduty
+#### 步骤2 集成授权 <span id="私有化版本集成授权"></span>
+1. \`平台类型\` 选择**私有化版本**，填写\`API Endpoint\`。
+2. 将生成的 **Token** 填写到对应的编辑框并点击下一步完成[集成配置](#集成配置)。
+
+
+## 通用配置
+
+### 在 Flashduty
+#### 步骤1 集成配置 <span id="集成配置"></span>
+
+1. **集成名称：** 为当前集成定义一个名称。
+2. **管理团队：** 当选择管理团队后，只有该团队成员以及租户管理员可以编辑此集成。
+3. **同步方向：**
+
+    - To_ServiceDesk_Plus：将 Flashduty 的故障同步至 ServiceDesk Plus。
+    - From_ServiceDesk_Plus：将 ServiceDesk Plus 的 Request 同步至 Flashduty。
+    - Two-way：Flashduty 和 ServiceDesk Plus 互相同步。
+    
+4. **触发模式**：
+    - 自动触发：需要配置相应的条件，Flashduty 会自动将符合条件的故障同步到 ServiceDesk Plus 中。
+    - 手动触发：需要在故障详情页的更多操作中手动触发 ServiceDesk Plus 同步（该集成配置的名称为触发器名称）。
+
+5. **协作空间**：选择该集成生效的协作空间。
+6. **请求模版**：选择创建 request 时使用的模版。
+7. **严重程度映射**：Flashduty 的严重程度与 ServiceDesk Plus 优先级的映射关系，默认映射关系，请参考[优先级映射](#优先级映射)。
+8. **自定义字段映射**：可以将故障中的标签或自定义字段，映射到 ServiceDesk Plus 工单中的对应文本字段，实现信息自动填充。该功能支持将常见上下文信息（如服务名、实例地址、指标名称等）同步至 ServiceNow，便于后续排查与跟踪。
+    - 仅支持目标为单行文本或多行文本类型的字段。
+    - 支持从故障标签（如 service、instance）或自定义属性中提取值。
+    - 若源字段为空，目标字段也将保持为空，不会覆盖原有内容。
+    - 映射配置在集成设置中统一管理，无需每次手动填写。
+
+9. **指派对象映射**：当 Flashduty 的故障同步至  ServiceDesk Plus 并需要自动指派到 Technician 或 Group 时，可以获取 Flashduty 故障标签的值作为指派对象（如果对应的指派对象不存在，会导致同步失败，请谨慎选择）。
+
+10. 点击\`保存\`完成配置。
+
+### 在 ServiceDesk Plus
+#### 步骤2 创建 Requester
+当 Flashduty 的故障同步到 ServiceDesk Plus 时，系统自动设置的 Requester
+
+1. 登录 ServiceDesk Plus 控制台，找到 \`Setup\` 配置页面。
+2. 选择 \`Users & Permissions\` 之后，进入到 \`Users\` 创建页面，选择 \`New Requester\`。
+3. \`Name (Display Name)\` 和 \`First Name\` 填写 **flashduty**，\`Email\` 填写 **flashduty-sync@flashcat.cloud** 。
+4. 其他可按需设置，点击 \`Save\` 保存配置。
+
+![2025-09-24-15-03-31](https://docs-cdn.flashcat.cloud/images/png/9ee174f85ac918476888efd759511d31.png)
+
+#### 步骤3 配置同步 <span id="配置同步"></span>
+要实现 ServiceDesk Plus 的 Request 向 Flashduty 的同步，请参考此配置项。**注意:** 不同版本的路径可能略有不同，但配置方法相同。
+##### 创建 Webhook
+1. 登录 ServiceDesk Plus 控制台，找到 \`Setup\` 配置页面。
+2. 选择 \`Automation\` 之后，进入到 \`Custom Actions\` 页面，并选择 \`Webhooks\`。
+3. 点击 \`New Webhook\`，在编辑页面中 \`Webhook Name\` 填写 **to_Flashduty**。
+4. \`URL\` 填写集成的<span class='integration_url'>推送地址</span>。
+5. \`Applies to\` 选择 **Requsts**，\`Method\` 选择 **POST**，\`Headers\` 中填写 **Content-Type application/json**。
+6. \`Message Body\` 的 Type 选择 **JSON**，并填写以下内容：
+
+  \`\`\` 
+  # 云版本
+  {
+    "subject":"\${subject}",
+    "request_id":"\${id}",
+    "description":"\${udf_fields.txt_destination}",
+    "priority":"\${priority.name}",
+    "status":"\${status.name}",
+    "txt_test_field":"\${udf_fields.txt_test_field}"
+  
+  }
+  \`\`\`
+
+   \`\`\` 
+  # 私有化版本
+  {
+    "suject":"\${{request.subject}}",
+    "request_id":"\${{request.id}}",
+    "description":"\${{request.description}}",
+    "status":"\${{request.status.name}}",
+    "priority":"\${{request.priority.name}}",
+    "udf_sline_301":"\${{request.udf_fields.udf_sline_301}}"
+  }
+
+  \`\`\`
+7. 点击 \`Save\` 完成配置。
+
+![2025-09-23-13-32-32](https://docs-cdn.flashcat.cloud/images/png/94ca1d094ed38ebcaf299364eddfd0ac.png)
+
+##### 创建触发器
+1. 登录 ServiceDesk Plus 控制台，找到 \`Setup\` 配置页面。
+2. 选择 \`Automation\` 之后，进入到 \`Triggers\` 页面，并选择 \`Request\`。
+3. 点击 \`New Trigger\`，在编辑页面中 \`Name\` 填写 **to_Flashduty**。
+4. \`Trigger applies to\` 选择 **Request**，\`Execute when a request is\` 勾选 **Create 和 Edited**。
+5. \`Execute during\` 选择 **Any time**，并勾选 **Enable Trigger**。
+6. \`Conditions\` 选择 \`Without condition\` 或按实际需求配置。
+7. 在 \`Actions\` 中选择 **Webhook** 并勾选 **to_Flashduty** 通道。
+8. 点击 \`Save\` 完成配置。
+
+![2025-09-23-13-42-20](https://docs-cdn.flashcat.cloud/images/png/9573d79763af656e0e08c5bdc3649a14.png)
+
+
+## 同步信息映射关系
+
+### 表单字段
+
+| ServiceDesk Plus    | Flashduty     | 备注 |
+| ------------------- | ------------- | ---- |
+| Subjeck   | Title         |      | 标题
+| Description         | Description   |  描述信息    |
+| Status              | Progress      |  状态    |
+| Priority            | Severity      |   严重程度   |
+| Others              | Custom Fields |   自定义字段   |
+
+### 状态映射
+
+| ServiceDesk Plus | Flashduty  | 备注            |
+| ----------- | ---------- | --------------- |
+| Open         | Trigger    |       触发          |
+| In Progress | Processing |        待处理         |
+| Assigned | Processing |          待处理       |
+| Pending Verification | Processing |     待处理      |
+| Staging | Processing |     待处理      |
+| On Hold     | Snoozed    | 默认暂缓 2 小时 |
+| Resolved    | CLosed     |       关闭          |
+| Closed      | CLosed     |        关闭         |
+| Canceled    | CLosed     |        关闭         |
+| Rejected    | CLosed     |        关闭         |
+
+### 优先级映射 <span id="优先级映射"></span>
+
+| ServiceDesk Plus | Flashduty | 备注 |
+| ---------- | --------- | ---- |
+| Low        | Info      |   提示   |
+| Medium     | Warning   |   警告   |
+| High       | Critical  |   灾难  |
+
+
+## 常见问题
+
+<details>
+  <summary> Scope 是否可以更改</summary>
+  不可以，目前所使用的 Scope 已经是最小单元了，Flashduty 在与 ServiceDesc Plus 进行同步 request 时，需要做获取/创建/更新操作，以及在配置集成时，需要获取优先级/自定义字段列表，所以需要相应的权限支持。
+</details>
+`,pn=`---
 title: "配置通知模版"
 description: "通过自定义配置模版，可以实现个性化通知内容的需求"
 date: "2024-05-10T10:00:00+08:00"
@@ -8696,7 +9007,7 @@ msg_type 必填，值为 post
 <img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
 
 </div>
-`,hn=`---
+`,mn=`---
 title: "Link 集成"
 description: "通过 Link 集成，可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数，实现快速访问"
 date: "2025-05-19T10:00:00+08:00"
@@ -8753,4 +9064,4 @@ https://cmdb.com/vm?sn=VM123456
 1. 当引用的内容不存在时，Link 集成会正常生成对应的链接，但无法获取到值
 2. 同一个协作空间至多绑定三个 Link 集成
 3. 注意引用语法，如未按照要求进行书写引用变量，会导致无法正常获取对应值
-`,pn={CustomAlert:n,Email:t,N9e:e,Prometheus:a,Grafana:s,Zabbix:i,UptimeKuma:d,AliyunARMS:l,AliyunCmEvent:o,AliyunCm:r,AliyunSLS:c,AWSCW:u,AzureMonitor:h,BaiDuBCM:p,HuaWeiCES:m,InfluxDB:g,OpenFalcon:y,PagerDuty:f,TencentBK:b,TencentCLS:v,TencentCm:_,TencentEb:w,OceanBase:k,Graylog:F,Skywalking:x,Sentry:S,Jiankongbao:T,AWSEventBridge:I,Dynatrace:A,HuaweiyunLTS:C,GoogleCM:L,Splunk:P,AppDynamics:D,SolarWinds:M,VolcEngineMetric:N,VolcEngineEvent:R,VolcEngineTLS:$,OpManager:E,Meraki:W,Zilliz:j,StateCloud:U,Guance:z,CustomChange:X,Jira:Y,Lark:nn,Dingtalk:tn,Wecom:en,Slack:an,MicrosoftTeams:sn,AlertWebhook:dn,IncidentWebhook:ln,CustomAction:on,Templates:un,HuaweiyunAPM:q,JiraSync:rn,ZStack:O,Keep:H,ElastAlert2:B,DingtalkAlert:V,FeishuAlert:G,VolcEngineDetect:J,Link:hn,ServiceNowSync:cn,Monit:K,Rum:Z,Cloudflare:Q};module.exports=pn;
+`,gn={CustomAlert:n,Email:e,N9e:t,Prometheus:a,Grafana:s,Zabbix:i,UptimeKuma:d,AliyunARMS:l,AliyunCmEvent:o,AliyunCm:r,AliyunSLS:c,AWSCW:u,AzureMonitor:h,BaiDuBCM:p,HuaWeiCES:m,InfluxDB:g,OpenFalcon:y,PagerDuty:f,TencentBK:b,TencentCLS:v,TencentCm:_,TencentEb:w,OceanBase:k,Graylog:F,Skywalking:x,Sentry:S,Jiankongbao:T,AWSEventBridge:I,Dynatrace:A,HuaweiyunLTS:C,GoogleCM:L,Splunk:P,AppDynamics:D,SolarWinds:N,VolcEngineMetric:R,VolcEngineEvent:M,VolcEngineTLS:$,OpManager:E,Meraki:W,Zilliz:j,StateCloud:U,Guance:z,CustomChange:Y,Jira:nn,Lark:en,Dingtalk:tn,Wecom:an,Slack:sn,MicrosoftTeams:dn,AlertWebhook:ln,IncidentWebhook:on,CustomAction:rn,Templates:pn,HuaweiyunAPM:q,JiraSync:cn,ZStack:O,Keep:H,ElastAlert2:B,DingtalkAlert:V,FeishuAlert:G,VolcEngineDetect:J,Link:mn,ServiceNowSync:un,Monit:K,Rum:Z,Cloudflare:Q,WecomAlert:X,ServiceDeskPlusSync:hn};module.exports=gn;