飞书消息-获取用户ID信息

一、功能描述

获取飞书用户的ID信息，包括用户open_id、用户user_id、用户union_id，可用于后续的【飞书消息-个人信息发送】、【飞书消息-群信息发送】@指定人功能 等操作

open_id 也为 “用户应用ID”，同一组织不同应用open_id不同；

user_id 也为 “用户组织ID”，同一账号不同组织user_ID不同；

union_id 也为 “用户全局ID”，同一组织下，不同应用的union_id是相同的；

具体用户ID概述和使用方法使用可参照 飞书官方API - 用户身份概述

二、属性说明

组件输入

• 飞书消息对象：字典；可使用【飞书消息-获取群应用对象】组件进行获取
• 获取方式：下拉框；选择获取用户ID信息的方式，可选值有"通过绑定的邮箱号获取"、“通过绑定的手机号获取”
• 获取ID类型：下拉框；选择需要获取的ID类型
• 包含已离职人员：下拉框；当选择是时，如【待获取用户列表】中包含已离职人员的ID也会一起获取
• 待获取用户列表：列表；需要获取的用户；"通过绑定的手机号获取"示例：["13812345678",13812345679")；"通过绑定的邮箱号获取"示例：["zhangsan@z.com","lisi@a.com"]

组件输出

• 输出结果：在此处输出返回的获取的ID信息

高级属性

• 错误继续执行：组件运行异常时，流程是否继续运行
• 执行前延时(秒)：运行组件前的延时时间
• 执行后延时(秒)：运行组件后的延时时间

三、使用实例

实例描述：飞书消息-获取用户ID信息，获取 ["13927636078","13922202473"] 的 用户user_id；打印输出执行结果至控制台中。

前置环境：

a、应用需要开通相关权限，具体操作可参考本文档的【常见问题】

b、流程需使用【飞书消息-获取群应用对象】组件获取一个群应用对象。（此组件具体使用详情见该组件使用文档）

流程编辑：

运行结果：

四、常见问题

1、应用权限开通

a、进入飞书应用管理页面，具体步骤可参照【飞书消息-获取群应用对象】的使用文档中常见问题

b、开通【通过手机号或邮箱获取用户 ID】、【获取用户 User ID】权限

2、部分用户ID获取为空

问题描述：存在部分成员获取下来的ID为空，该问题属于应用使用范围设置问题

解决方案：

a、进入飞书应用管理页面，具体步骤可参照【飞书消息-获取群应用对象】的使用文档中常见问题

b、点击【版本管理与发布】-【创建版本】

c、修改"可用范围"，可选择"全体成员"/"指定部分成员"

注：在使用范围内的成员，才能获取到该成员的相关ID

d、发布版本，等待管理员通过即可

3、群应用对象过期

组件运行提示：群应用对象过期，请重新获取

解决方案：群应用对象已失效，请重新运行【飞书消息-获取群应用对象】组件即可