批量获取飞书用户 ID

平台通过飞书应用机器人发送告警、巡检通知时，需要知道每位接收人在飞书中的用户标识。本文说明如何在 用户管理 中批量自动获取飞书用户 ID。

适用场景

• 一次性为多名运维人员配置飞书告警接收能力。
• 新上线飞书通知前，批量回填历史用户的飞书 ID。
• 用户更换手机号或邮箱后，重新获取飞书 ID。

前置条件

• 平台字典中已配置飞书应用的 App ID 与 App Secret（见 飞书接收 AI 巡检告警）。
• 飞书开放平台应用已开通通讯录相关权限并发布版本。
• 接收人已在飞书应用 可用范围 与 通讯录数据权限 内。

操作步骤

1. 进入 权限管理 → 用户管理。

2. 确认待处理用户已填写 手机号 和/或 邮箱（须与飞书个人账号绑定信息一致）。

3. 勾选需要处理的用户（可多选，单次最多 100 人）。

4. 点击列表上方 批量获取飞书ID（需具备用户编辑权限）。

5. 等待处理完成：

   • 全部成功：提示成功条数，列表刷新；编辑用户可看到「飞书用户ID」已自动填入。
   • 部分失败：弹出 飞书用户ID获取失败明细，包含用户名、姓名、手机号、邮箱及失败原因。

6. 若有失败记录，点击 复制失败明细（Tab 分隔，可粘贴到 Excel），核对后补全联系方式，再次勾选批量获取。

匹配规则说明

• 平台根据用户表中的手机号或邮箱，向飞书查询对应的用户 ID。
• 大陆 11 位手机号会自动补全国际区号前缀。
• 获取到的 ID 类型与平台飞书配置一致（一般为 open_id；若企业统一使用 user_id，需与管理员确认平台配置）。

手动填写（可选）

若个别用户无法自动匹配：

1. 用户管理 → 编辑 该用户。
2. 在 飞书用户ID 字段手动粘贴 ID。
3. 保存。

企业管理员可在 飞书管理后台 → 组织架构 → 成员与部门 中查看成员的用户 ID。

配置前检查清单

• [ ] 飞书应用凭证已在字典中配置
• [ ] 飞书应用机器人与权限已开通并发布
• [ ] 接收人在应用可用范围与通讯录权限内
• [ ] 用户表手机号/邮箱与飞书绑定一致

常见失败原因

延伸阅读

• 飞书接收 AI 巡检告警
• 平台管理