「飞书通讯录」连接器|飞书低代码平台 - 飞书官网
产品功能

「飞书通讯录」连接器|飞书低代码平台

飞书

2024-12-23

前置了解​
配置步骤​
常见问题​
通讯录可理解为企业的组织架构,包括企业部门信息、企业人员信息等,通过「飞书通讯录」连接器,可以让流程与飞书通讯录联动,对通讯录信息进行操作。​
比如:员工入职,创建一个用户组。​
这类需要和飞书通讯录打通的流程,就可以通过「飞书通讯录」节点,实现数据互通。​
前置了解​
用户组​
飞书组织架构里的一个基础实体,用户组可关联用户/部门,同时可被各类业务权限管控引用,从而实现“高效便捷”的人群管控。​
举例:通过 OpenAPI 将“外包人员”维护到”外包用户组“中,在应用可用范围或其他业务管控规则中引用”外包用户组“,可节省在各业务权限里手动配置外包人员的成本。​
配置步骤​
(一)添加节点​
进入流程编辑器,新增节点选择「飞书」中的「飞书通讯录」。​
​
250px|700px|reset
image.png
​
​
(二)操作和凭证​
执行操作​
选择该节点具体要执行什么操作:​
​
250px|700px|reset
新操作.gif
​
​
通过「飞书通讯录」连接器,可对通讯录进行如下操作:​
​
分类​
具体操作​
调用该 API 所需的权限(开启其中任意一项权限即可调用)​
用户​
获取单个用户信息​
​
创建用户​
​
修改用户部分信息​
​
通过手机号或邮箱获取用户 ID​
​
删除用户​
​
获取部门直属用户列表​
​
恢复已删除用户​
​
更新用户ID​
用户组​
​
创建用户组​
​
删除用户组​
​
查询指定用户组​
​
更新用户组​
​
查询用户组列表​
人员类型​
删除人员类型​
​
查询人员类型​
​
更新人员类型​
​
新增人员类型​
角色成员​
批量添加角色成员​
​
删除角色下的成员​
​
批量设置角色成员管理范围​
​
查询角色下的所有成员信息​
​
职级​
获取租户职级列表​
​
更新职级​
​
获取单个职级信息​
​
创建职级​
​
删除职级​
角色​
修改角色名称​
​
创建角色​
​
删除角色​
​
连接配置​
使用具体哪个飞书集成的机器人来执行操作,支持选择: ​
  1. 默认飞书集成:系统自动生成的飞书应用机器人来执行操作。 ​
  1. 自定义飞书集成:使用自己创建的飞书应用机器人来执行操作,创建自定义飞书应用参见 认识与配置飞书集成。​
(三)基础配置​
点击“下一步”,即进入基础配置,不同操作对应的配置项也不同。详见飞书开放平台的对应接口文档。​
部分字段配置说明:​
​
​
(四)高级配置​
可以根据需要,设置操作执行失败时的重试策略:​
​
配置项​
说明​
重试间隔​
每次重试之间的间隔时间,默认 5000 ms​
重试次数​
失败后的自动重试次数,默认 0 次​
超时时间​
每次重试的 HTTP 请求超时时间,默认 5000ms​
​
(五)输出变量​
选择了操作后,「输出变量」会根据所选的操作事件显示接收到的事件内容,在后续节点中,我们可以引用这里的具体字段。​
节点配置完成后,在流程中也会自动生成一个变量,变量中将承载触发器所选事件接收到的数据内容:​
​
250px|700px|reset
image.png
​
​
常见问题​
如何申请飞书应用的权限?​
  • 默认的飞书应用会将涉及到的相关权限,会在发布「飞书低代码平台」应用时自动申请。 ​
​
250px|700px|reset
​
​
  • 自定义飞书应用,需要到飞书开放平台自行申请,详见如何开通权限​
其他飞书通讯录常见问题​
点击查看:通讯录-常见问题​
预约飞书企业效能顾问 深度诊断企业痛点,定制专属 AI 办公方案

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题

字节跳动旗下 AI 工作平台

联系我们立即试用