认识与配置飞书集成|飞书低代码平台

认识与配置飞书集成|飞书低代码平台

飞书低代码平台手册精选NaN-NaN-NaN
产品功能
一句话介绍
在飞书低代码平台中使用到了大量的飞书平台能力,比如通过飞书机器人发送消息、创建飞书日历、发起一个飞书群聊等,而这种能力使用是通过飞书集成实现的。
飞书集成的两种类型
每一个飞书低代码平台创建的应用,都和至少一个飞书开放平台应用进行了集成,再去调用相关能力。
飞书低代码平台和飞书的集成关系分为默认集成和自定义集成两类:一个应用对应的默认集成只有一个,但是自定义集成可以添加多个。
250px|700px|reset
whiteboard_exported_image-11.png
默认集成
每当通过飞书低代码平台创建一个新应用,都会自动在相应飞书企业的飞书开放平台中创建一个【企业自建应用】,这两个应用之间的集成关系,就是默认集成。
如果打开飞书开放平台,进入到开发者后台,就能看到一个相同名字的应用,如下图红框中的应用:
250px|700px|reset
  • 此处需注意:请勿在飞书开放平台中修改任何默认集成应用配置,否则可能导致应用发布失败或者能力调用出错。
目前在飞书低代码平台的集成列表中,没有展示出默认集成配置,当然其中的所有配置均已自动设置,无需额外操作。
比如:当应用需要给用户发送消息时,都是通过默认集成的机器人来发送飞书消息的。
默认集成应用所需的权限,当应用发布时默认申请添加,会伴随审批通过后生效。详细内容可参考文档:应用开发全流程概览
自定义集成
当开发者有一些特殊的场景需求,比如需要在同一个群聊中,使用不同机器人发送不同类型的消息时,可以通过自定义集成添加新的集成关系来实现。
使用自定义集成需要经过以下 4 步配置:
(一)在飞书开放平台创建企业自建应用
进入飞书开放平台的开发者后台,点击【创建企业自建应用】,按照要求配置「名称」「应用描述」「应用图标」,点击【创建】,就创建了一个新应用。
点击左侧导航菜单的【凭证与基础信息】,复制右侧的 App ID 和 App Secret,在第二步会用到。
250px|700px|reset
250px|700px|reset
250px|700px|reset
250px|700px|reset
(二)在飞书低代码平台创建自定义集成
进入飞书低代码平台,应用开发后台的集成菜单,点击「添加飞书集成」,按照要求填写集成基础信息,具体说明如下:
项目
说明
名称
建议和第 1 步中创建的企业自建应用名称保持相同,以便后期维护
API 名称
可以不做修改,也可以根据需要重新命名
飞书应用 App ID
第 1 步中最后复制的 App ID
飞书应用 App Secret
第 1 步中最后复制的 App Secret
用户匹配方式
选择邮箱 / 手机号码,系统会将飞书低代码平台和飞书中拥有相同邮箱 / 手机号码的用户视为同一个用户
第 1 步 添加飞书集成
250px|700px|reset
image.png
第 2 步 填写自定义集成基本信息,点击「提交」,就进入到了自定义集成的详细配置页。
250px|700px|reset
image.png
第 3 步 自定义集成配置详情
250px|700px|reset
image.png
(三)完成自定义集成配置
自定义集成权限配置页主要分为 5 个部分:
  • 基本信息
  • 权限配置
  • 机器人
  • 移动端网页应用
  • 桌面端网页应用
「基本信息」初始已配置;「权限配置」部分必须配置完成;「机器人」「移动端网页应用」「桌面端网页应用」至少完成一项配置方可正常使用。
各部分的配置说明如下:
基本信息
部分
说明
对应部分截图
基本信息
就是在创建自定义集成时配置的信息,一般无需修改
250px|700px|reset
权限配置
部分
说明
对应部分截图
基本信息
就是在创建自定义集成时配置的信息,一般无需修改
250px|700px|reset
在飞书开放平台中如何配置?
在「权限管理」中搜索对应权限,再点击「开通权限」:
250px|700px|reset
250px|700px|reset
250px|700px|reset
机器人
部分
说明
对应部分截图
机器人
非必须配置项
如需通过机器人向用户发送飞书消息,需要启用机器人能力
250px|700px|reset
在飞书开放平台中如何配置?
在「添加应用能力」中点击机器人中的「添加」:
250px|700px|reset
移动端网页应用
部分
说明
对应部分截图
移动端网页应用
非必须配置项
如需在飞书移动端工作台使用此自定义集成的应用,需要配置
250px|700px|reset
在飞书开放平台中如何配置?
在「添加应用能力」中点击网页应用中的「添加」:
250px|700px|reset
当把飞书低代码平台发布后,在此配置项处获取到移动端主页 URL:
250px|700px|reset
再到飞书开放平台应用后台,「网页应用」菜单粘贴「移动端主页 URL」:
250px|700px|reset
桌面端网页应用
部分
说明
对应部分截图
桌面端网页应用
非必须配置项
如需在飞书桌面端工作台使用此自定义集成的应用,需要配置
250px|700px|reset
在飞书开放平台中如何配置?
在「添加应用能力」中点击网页应用中的「添加」:
250px|700px|reset
当把飞书低代码平台发布后,在此配置项处获取到移动端主页 URL:
250px|700px|reset
再到飞书开放平台应用后台,「网页应用」菜单粘贴「移动端主页 URL」:
250px|700px|reset
💁
注意:以上权限和能力部分,仅为确保可用的基础配置。如需使用飞书平台的其他能力,比如创建日程、发起群聊等,请自行开通相应权限。
(四)在飞书开放平台发布企业自建应用
通过以上配置仅是开通了应用所需权限,并没有正式生效。如需实际使用,还需要将飞书开放平台中的企业自建应用发布。
具体步骤如下。
第一步:进入「版本管理与发布」,点击「创建版本」。
250px|700px|reset
第二步:完成版本信息填写,点击最后的「保存」按钮就会提交应用发布申请。
250px|700px|reset
第三步:当企业应用管理员审批通过后,应用就发布成功,可以在飞书低代码平台中使用所需的各项飞书平台能力了。
250px|700px|reset
至此,自定义集成配置就完成,比如可以在流程中使用自定义集成配置了,如下图所示:
250px|700px|reset
image.png
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

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