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