> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 企微机器人 @ 提醒处理人

> 配置企微群聊机器人在推送告警通知时 @ 提醒对应的处理人员，确保关键告警不被遗漏

## 为什么需要 @ 提醒

企微群聊中消息量大，处理人员容易忽略告警通知。通过开启 **@ 提醒**，机器人推送故障通知时会自动 @ 对应的处理人员，确保相关负责人第一时间收到提醒。

Flashduty 支持两种方式实现企微机器人的 @ 提醒，二者的区别如下：

| 对比项        | 默认方式（手机号匹配）                 | 映射表方式（user\_id 匹配）            |
| :--------- | :-------------------------- | :---------------------------- |
| **匹配原理**   | 通过 Flashduty 成员绑定的手机号查找企微成员 | 通过映射表中的邮箱与企微 user\_id 对应关系查找  |
| **@ 提醒位置** | 通知消息底部单独展示                  | 通知消息内容中内联展示                   |
| **维护成本**   | 无需额外维护，只要手机号一致即可            | 需要维护邮箱与企微 user\_id 的映射表       |
| **适用场景**   | 手机号在 Flashduty 和企微中保持一致     | 手机号不一致，或希望 @ 提醒与通知内容在同一条消息中展示 |

## 方式一：默认方式（手机号匹配）

这是最简单的方式，无需额外配置。系统通过成员在 Flashduty 中绑定的手机号，自动匹配企微中对应的成员。

### 前提条件

* 成员在 Flashduty 中绑定的手机号与企微账号的手机号 **完全一致**

### 配置步骤

<Steps>
  <Step title="确认手机号一致">
    确保 Flashduty 成员的手机号与企微账号的手机号相同。您可以在 **平台管理 → 成员管理** 中查看和修改成员手机号。
  </Step>

  <Step title="开启 @ 提醒">
    进入目标协作空间的 **分派策略**，找到企微机器人通知渠道，展开 **高级配置**，开启 **@ 提醒** 开关。
  </Step>
</Steps>

<Tip>
  此方式下，如果成员的手机号在两个平台中不一致，@ 提醒将不会生效。请优先确认手机号的一致性。
</Tip>

## 方式二：映射表方式（user\_id 匹配）

如果成员手机号在两个平台中不一致，或者您希望 @ 提醒与通知内容在同一条消息中内联展示，可以使用映射表方式。

此方式需要您维护一张 Flashduty 成员邮箱与企微 user\_id 的对应关系表。

### 前提条件

* 已获取企微成员的 user\_id（可通过企业微信管理后台或 API 获取）

### 配置步骤

<Steps>
  <Step title="获取企微 user_id">
    登录 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/frame#contacts)，进入 **通讯录**，点击目标成员查看详情，找到 **账号** 字段，即为该成员的 user\_id。

    您也可以通过企业微信 API 批量获取。
  </Step>

  <Step title="创建映射表">
    1. 进入 Flashduty **平台管理 → 映射表管理**。
    2. 点击 **创建映射表**，类型选择 **企微**。
    3. 录入 Flashduty 成员邮箱与对应的企微 user\_id：

    | email                                   | wecom\_userid |
    | :-------------------------------------- | :------------ |
    | [bob@corp.com](mailto:bob@corp.com)     | bob\_wecom    |
    | [alice@corp.com](mailto:alice@corp.com) | alice\_wecom  |
  </Step>

  <Step title="配置分派策略并关联映射表">
    进入目标协作空间的 **分派策略**，找到企微机器人通知渠道：

    1. 展开 **高级配置**，开启 **@ 提醒** 开关。
    2. 在 **用户信息映射表** 下拉框中，选择上一步创建的映射表。
  </Step>
</Steps>

<Warning>
  映射表需要您自行维护。当团队成员发生变动时，请及时更新映射表中的对应关系，否则新成员将无法被 @ 到。
</Warning>

## 验证效果

完成配置后，触发一条测试告警来验证 @ 提醒是否生效：

1. 确认目标协作空间已配置企微机器人作为群聊通知渠道。
2. 触发测试告警，观察企微群聊中的通知消息。
3. 确认处理人员被正确 @ 到。

如果 @ 提醒未生效，请参考以下排查清单：

<AccordionGroup>
  <Accordion title="默认方式：@ 提醒未生效">
    * 确认已开启 **@ 提醒** 开关
    * 确认成员在 Flashduty 中绑定的手机号与企微账号手机号 **完全一致**（包括国际区号）
    * 确认该成员在企微机器人所在的群聊中
  </Accordion>

  <Accordion title="映射表方式：@ 提醒未生效">
    * 确认已开启 **@ 提醒** 开关，且已选择正确的 **用户信息映射表**
    * 确认映射表中 Flashduty 成员邮箱和企微 user\_id 的对应关系正确
    * 确认企微 user\_id 填写无误（可在企微管理后台通讯录中核实）
    * 确认该成员在企微机器人所在的群聊中
  </Accordion>
</AccordionGroup>

## 延伸阅读

<CardGroup cols={2}>
  <Card title="通知渠道配置" icon="bell" href="/zh/on-call/configuration/notifications">
    了解所有机器人类型的配置方法和高级选项
  </Card>

  <Card title="分派策略" icon="route" href="/zh/on-call/channel/escalation-rule">
    了解分派策略的通知方式和群聊配置
  </Card>
</CardGroup>