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 中绑定的手机号与企微账号的手机号 完全一致
配置步骤
方式二：映射表方式（user_id 匹配）
如果成员手机号在两个平台中不一致，或者您希望 @ 提醒与通知内容在同一条消息中内联展示，可以使用映射表方式。 此方式需要您维护一张 Flashduty 成员邮箱与企微 user_id 的对应关系表。前提条件
- 已获取企微成员的 user_id（可通过企业微信管理后台或 API 获取）
配置步骤
获取企微 user_id
登录 企业微信管理后台，进入 通讯录，点击目标成员查看详情，找到 账号 字段，即为该成员的 user_id。您也可以通过企业微信 API 批量获取。
创建映射表
- 进入 Flashduty 平台管理 → 映射表管理。
- 点击 创建映射表，类型选择 企微。
- 录入 Flashduty 成员邮箱与对应的企微 user_id：
| wecom_userid | |
|---|---|
| bob@corp.com | bob_wecom |
| alice@corp.com | alice_wecom |
验证效果
完成配置后，触发一条测试告警来验证 @ 提醒是否生效：- 确认目标协作空间已配置企微机器人作为群聊通知渠道。
- 触发测试告警，观察企微群聊中的通知消息。
- 确认处理人员被正确 @ 到。
默认方式：@ 提醒未生效
默认方式：@ 提醒未生效
- 确认已开启 @ 提醒 开关
- 确认成员在 Flashduty 中绑定的手机号与企微账号手机号 完全一致（包括国际区号）
- 确认该成员在企微机器人所在的群聊中
映射表方式：@ 提醒未生效
映射表方式：@ 提醒未生效
- 确认已开启 @ 提醒 开关，且已选择正确的 用户信息映射表
- 确认映射表中 Flashduty 成员邮箱和企微 user_id 的对应关系正确
- 确认企微 user_id 填写无误（可在企微管理后台通讯录中核实）
- 确认该成员在企微机器人所在的群聊中
延伸阅读
通知渠道配置
了解所有机器人类型的配置方法和高级选项
分派策略
了解分派策略的通知方式和群聊配置