# 飞书自建应用

# 应用介绍

飞书,字节跳动旗下企业协作平台,将即时沟通、智能日历、音视频会议、OKR、飞书文档和工作台深度整合,通过开放兼容平台,让成员在一处即可实现高效的沟通和流畅的协作,全方位提升企业效率。

相关链接:

# 成为开发者

  1. 参考官方企业自建应用的开发流程 (opens new window)文档,首先成为飞书开发者后,创建一个自建应用,然后发布应用(其它一些步骤可先不进行配置,比如配置应用等)。

创建自建应用

# 配置触发器

  1. 流程触发条件选择【飞书自建应用】中对应的事件,配置好鉴权参数(同获取鉴权参数),保存并发布流程。

  2. 访问开发者后台 (opens new window),查看创建好的应用,复制第一步【预览 > 监听地址】中生成的地址到【开发配置 > 事件订阅】中进行请求地址的配置

请求地址配置

WARNING

只支持明文消息传输,暂不支持消息的加解密,所以不要开启Encrypt Key的配置。

# 获取鉴权参数

  1. 访问开发者后台 (opens new window),查看创建好的应用,在【凭证与基础信息】中查看鉴权信息。

鉴权参数

  1. 其中App ID和App Secret分别对应鉴权参数中的appKey和appSecret。

# 获取业务参数

请查阅官方API开放文档 (opens new window)

# 注意事项

  • 由于飞书在权限设计上非常严谨,所以经常会发现触发事件不触发或者操作返回没权限。
  1. 触发事件不触发:

开发者后台 (opens new window)中,确定在事件订阅中已添加相关触发事件且已开通所需权限。

触发事件

  1. 操作接口没权限:

在飞书开放平台每个操作的接口文档中,都明确标注了操作所需的权限,请根据官方要求进行相关权限的开通。

WARNING

一般申请开通了新权限后,需要发布应用的一个新版本,在新版本审核通过后新权限才会生效。