一、指令概述
该 RPA 指令用于通过飞书手机号查询对应用户的唯一标识（支持 open_id、user_id、union_id 三种类型），为后续飞书消息发送、权限校验等场景提供用户身份标识支持。
飞书官方开发文档参考： https://open.feishu.cn/document/server-docs/contact-v3/user/batch_get_id
二、调用参数配置示意
| 参数名称 | 示例 / 默认值 | 说明 |
| 指令 | 通过手机号获取用户 ID | 固定选择 “通过手机号获取用户 ID”，执行飞书用户 ID 查询操作。 |
| 飞书访问凭证 | 飞书访问凭证 | 配置飞书开放平台的访问凭证（需具备用户查询权限，可通过 “获取飞书访问凭证” 指令生成），支持变量（界面显示 “{x}” 标识）。 |
| 用户 ID 类型 | open_id / user_id / union_id | 选择要获取的用户标识类型，下拉可选：- open_id：飞书内用户的开放标识；- user_id：飞书用户 ID；- union_id：多租户场景下用户的唯一标识。 |
| 手机号 | *********** | 输入要查询的飞书用户手机号（需为飞书已注册的有效手机号），全部数字已打码，支持变量。 |
| 生成的变量 - 用户 ID | 用户ID（自定义变量名） | 存储查询到的用户唯一标识（如 open_id、user_id 等），需配置为自定义变量，后续流程可调用，支持变量。 |
| 生成的变量 - 运行结果 | 变量（自定义变量名） | 存储查询操作的执行结果（如成功状态、错误信息等），需配置为自定义变量，后续流程可调用，支持变量。 |
三、使用示例（查询用户 open_id 场景）
场景：通过手机号 *********** 查询对应用户的 open_id，用于后续发送飞书消息。
参数配置：
• 指令：通过手机号获取用户 ID
• 飞书访问凭证：feishuAuthToken（通过 “获取飞书访问凭证” 指令生成的变量）
• 用户 ID 类型：open_id
• 手机号：***********
• 用户 ID：targetUserOpenId（自定义变量，存储查询到的id）
• 运行结果：queryResult（自定义变量，存储查询结果）
执行流程：
调用该 RPA 指令后，RPA 会通过 feishuAuthToken 完成飞书 API 认证，根据全部打码的手机号 *********** 查询用户信息；查询完成后，将执行结果存入 queryResult，并把匹配到的用户 id存入 targetUserOpenId，便于后续 “发送消息” 等指令引用该用户标识。
四、返回结果说明
1. 飞书 API 标准返回示例（成功场景，关键信息已打码）：
指令执行后，“运行结果” 变量（如queryResult）会存储包含查询状态、用户信息的 JSON 结果，格式如下：
| { "success": true, "data": { "user_list": [ { "mobile": "***********", "status": { "is_activated": true, "is_exited": false, "is_frozen": false, "is_resigned": false, "is_unjoin": false }, "user_id": "ou_a758****************5a" } ] }, "request_id": "20251010093443F7D1951941060B44355E", "http_status": 200} |
2. 响应字段含义：
• success：布尔值，true 表示查询成功，false 表示查询失败（失败时会补充 error_msg 字段说明原因，如 “手机号不存在”“权限不足”）。
• data.user_list：数组，包含匹配手机号的用户信息（若多个用户匹配手机号，会返回多条，实际场景中飞书手机号通常唯一）：
◦ mobile：查询的手机号（全部数字已打码，如***********）；
◦ status：用户状态（是否激活、是否离职等）；
◦ user_id：用户id
• request_id：飞书 API 请求唯一标识（用于问题排查）；
• http_status：HTTP 响应状态码，200 表示请求成功（非 200 需结合飞书官方文档排查，如401表示凭证失效）。
五、注意事项
1. 访问凭证有效性：“飞书访问凭证” 需具备用户查询权限且未过期（建议通过 “获取飞书访问凭证” 指令动态生成有效凭证），否则会导致 http_status=401 或 success=false。
2. 手机号准确性：输入的手机号需为飞书已注册的有效手机号
3. 用户 ID 类型匹配：“用户 ID 类型” 需与后续业务场景所需的标识类型一致（如 “发送消息” 指令若要求open_id，则此处需选择open_id），避免因标识类型不匹配导致后续操作失败。
4. 打码信息说明：返回结果中手机号、user_id等敏感信息已打码，实际使用时会返回真实值（仅文档展示做隐私保护）。
六、延伸应用
可结合 RPA 的 “发送消息” 指令，实现精准用户触达：例如从业务系统获取客户手机号列表，通过本指令批量查询飞书user_id，再调用 “发送消息” 指令向这些用户推送个性化通知（如订单提醒、活动通知），替代人工手动查询和发送，提升运营效率。