> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashduty.com/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、Markdown。
         * **推送模式**：选择钉钉告警在何种情况下触发或恢复告警。
      3. 复制当前页面的 **钉钉告警集成地址** 备用。
      4. 配置默认路由，并选择对应的协作空间（集成创建后可以前往 `路由` 进行更多路由规则的配置）。
      5. 完成。
    </Accordion>
  </AccordionGroup>
</div>

### 定制钉钉告警集成

#### 钉钉告警集成地址

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

#### 推送模式

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

1. **根据消息标题触发或更新告警**：该模式下，每当接收到新消息，系统会根据消息标题查找未关闭告警。如果找到告警则进行更新，否则系统会触发一条新的告警。
2. **根据规则触发或关闭告警**：该模式下，每当接收到新消息，系统会根据您的规则进行消息匹配，匹配到的消息按照规则去触发新告警或关闭已有告警。

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

   配置示例：

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

### 注意事项

* 钉钉告警集成地址仅支持接收 Text、Markdown 消息类型，其他消息无法接收。
* 当钉钉消息类型是Text 时，Flashduty On-call 会生成默认告警标题 “钉钉告警”。

## 严重程度映射关系

***

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