> ## Documentation Index
> Fetch the complete documentation index at: https://test-8ad8522e-feat-ai-sre.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 企微告警集成

> 在 Flashduty 生成唯一的企微机器人地址，通过企微的方式将告警的发生与恢复同步到 Flashduty

<div className="hide">
  ## 操作步骤

  ***

  ### 创建企微告警集成

  您可通过以下2种方式，获取一个企微机器人告警集成地址，任选其一即可。

  #### 使用专属集成

  当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。

  <AccordionGroup>
    <Accordion title="展开">
      1. 进入 Flashduty 控制台，选择 **协作空间**，进入某个空间的详情页面
      2. 选择 **集成数据** tab，点击 **添加一个集成**，进入添加集成页面
      3. 选择 **企微告警** 集成，点击 **保存**，生成卡片。
      4. 点击生成的卡片，可以查看到 **企微告警集成地址**，复制备用，完成。
    </Accordion>
  </AccordionGroup>

  #### 使用共享集成

  当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。

  <AccordionGroup>
    <Accordion title="展开">
      1. 进入 Flashduty 控制台，选择 **集成中心=>告警事件**，进入集成选择页面。
      2. 选择 **企微告警** 集成：
         * **集成名称**：为当前集成定义一个名称。
         * **消息类型**：选择企微告警消息类型，目前仅支持文本（Text）、富文本（Post）。
         * **推送模式**：选择企微告警在何种情况下触发或恢复告警。
      3. 复制当前页面的 **企微告警集成地址** 备用。
      4. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 `路由` 进行更多路由规则的配置）。
      5. 完成。
    </Accordion>
  </AccordionGroup>
</div>

### 定制企微告警集成

#### 企微告警集成地址

系统会帮您生成一个唯一的企微告警集成地址，该地址兼容企微机器人消息的协议，在有的平台仅支持企微机器人通道时，您可以使用该地址来接收对应的消息。

#### 推送模式

默认系统总是为每一条消息创建新的告警，但您可以切换模式为：

**根据规则触发或关闭告警**：该模式下，每当接收到新消息，系统会根据您的规则进行消息匹配，匹配到的消息按照规则去触发新告警或关闭已有告警。

* 您至少需要填写一条**触发**规则；
* 您必须设置 Alert Key 的正则提取规则。系统使用该字段来查找历史告警，以便对其进行更新或关闭；**如果正则提取失败，系统将随机来生成 Alert Key**，以确保告警不会因为配置错误而丢失；
* 您可以选择，当所有的规则都不匹配时，是否丢弃消息。

<Note>
  正则提取规则必须是**合法的正则表达式（RE2 语法）**：提交时前端会校验其可编译性，非法正则（如不支持的语法）无法保存，并提示「请输入合法的正则表达式」。只有正则合法但未匹配到内容时，系统才会随机生成 Alert Key。
</Note>

配置示例：

* 接收所有消息，当消息内容中包含 **RESOVED** 字样时，关闭告警，否则触发新告警；
* Alert Key 从消息内容中提取，规则为 **/(.\*)/**。

#### 静默检测

告警集成详情页（编辑与预览）的基础设置卡片下方提供 **静默检测**（Heartbeat）配置卡片：在指定时间内未收到有效事件时，系统会生成一条 Warning 告警。

| 配置项            | 说明                                                                |
| :------------- | :---------------------------------------------------------------- |
| **启用静默检测**     | 开关，默认关闭。开启后，仅成功通过集成校验的上游事件会刷新检测时间                                 |
| **检测时间（分钟）**   | 指定时间内未收到有效事件，即生成一条 Warning 告警。取值须为整数，范围为 10 分钟 \~ 48 小时（默认 10 分钟） |
| **收到新事件后自动恢复** | 开关，默认开启。收到下一条有效事件时，自动恢复静默检测产生的告警                                  |

### 注意事项

* 企微告警集成地址仅支持接收 Text、Markdown 消息类型，其他消息无法接收。
* Flashduty On-call 会生成默认告警标题： “企微机器人告警”，如果您需要更改标题，可以通过[告警处理 Pipeline](/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义标题。

## 严重程度映射关系

***

当前企微告警集成推送到 Flashduty 的严重程度均为Warning，但您可以通过[告警处理 Pipeline](/zh/on-call/integration/alert-integration/alert-pipelines) 来自定义严重程度。