跳到主要内容

飞书连接器事件

介绍

飞书是字节跳动旗下先进协作与管理平台。

鉴权信息

用户可以使用飞书提供的三种访问凭证调用接口,不同的API可能会支持上述一种或多种的访问凭证(access token)作为API调用时的鉴权手段。具体可见飞书的API说明文档文档图片

轻流中飞书连接器相关事需要用到自建应用的access_token,具体获取方式如下:

自建应用身份凭证获取方法

第一步: 获取 App ID 和 App Secret

登录开发者后台,创建企业自建应用。进入企业自建应用详情页,获取 App ID 和 App Secret。 文档图片

第二步: 进入轻商城-连接中心中,选择连接器“飞书”,点击“配置”,并填写App ID 和 App Secret。

文档图片

文档图片

通过以上步骤,您可以完成飞书鉴权,省去每次使用连接器重新获取与填写access_token的步骤。

注意事项
  1. 飞书中每个应用都有独立的id与secret。由于目前连接中心各事件无法为每个事件都配置独立的鉴权,所以使用的事件属于飞书中不同应用,那么使用事件时需要配置不同的app_id 与app_secret。
  2. 不同的事件要求的权限不同,在使用连接器前,请确认相关事件要求的应用/用户权限并根据要求开启相应权限。开启权限方法如下(或者您可以查看相关文档)。

事件信息

事件描述
获取用户基本信息飞书自建应用:获取用户基本信息。
获取 tenant_access_token(企业自建应用)企业自建应用通过此接口获取 tenant_access_token,调用接口获取企业资源时,需要使用 tenant_access_token 作为授权凭证。
获取用户列表以【企业自建应用】身份或【用户】身份获取用户列表。具体用户列表结果由应用/个人的通讯录权限决定
获取部门信息列表以应用/用户身份获取部门信息列表。部分返回字段受到数据权限控制。
查询人员类型以应用身份访问通讯录,获取员工的人员类型

配置演示

获取用户列表

效果展示:

文档图片

前置条件:

首先需要确定您在连接中心-飞书连接器中配置了鉴权信息(配置方法见上文鉴权信息)

并且确定您的飞书应用具有相应权限(权限申请方式见上文注意事项),相应权限要求如下:

文档图片

配置步骤:

  1. 创建一个应用,应用中选Q-Linker字段,「配置模式」选连接中心里对应模版,并点击右上角保存(这里一定要注意保存,关系到下一步表格的配置)

文档图片

  1. 添加表格字段,按照连接中心-飞书连接器-对应事件中的参数要求编辑表格

(事件中要求的字段见下图)

文档图片

(应用中表格的配置字段见下图)

文档图片

  1. 关联表格,点击你的表格,右侧配置框中:默认内容-关联已有数据-XXX(Q-linker名称)-用户列表;关联子字段(如下图,将您的表格字段与连接器事件中字段关联起来)

文档图片

结果展示

文档图片