一句话介绍
在飞书低代码平台中使用到了大量的飞书平台能力,比如通过飞书机器人发送消息、创建飞书日历、发起一个飞书群聊等,而这种能力使用是通过飞书集成实现的。
飞书集成的两种类型
每一个飞书低代码平台创建的应用,都和至少一个飞书开放平台应用进行了集成,再去调用相关能力。
飞书低代码平台和飞书的集成关系分为默认集成和自定义集成两类:一个应用对应的默认集成只有一个,但是自定义集成可以添加多个。
250px|700px|reset
默认集成
如果打开飞书开放平台,进入到开发者后台,就能看到一个相同名字的应用,如下图红框中的应用:
250px|700px|reset
- 此处需注意:请勿在飞书开放平台中修改任何默认集成应用配置,否则可能导致应用发布失败或者能力调用出错。
目前在飞书低代码平台的集成列表中,没有展示出默认集成配置,当然其中的所有配置均已自动设置,无需额外操作。
比如:当应用需要给用户发送消息时,都是通过默认集成的机器人来发送飞书消息的。
自定义集成
当开发者有一些特殊的场景需求,比如需要在同一个群聊中,使用不同机器人发送不同类型的消息时,可以通过自定义集成添加新的集成关系来实现。
使用自定义集成需要经过以下 4 步配置:
(一)在飞书开放平台创建企业自建应用
点击左侧导航菜单的【凭证与基础信息】,复制右侧的 App ID 和 App Secret,在第二步会用到。
250px|700px|reset
250px|700px|reset
250px|700px|reset
250px|700px|reset
(二)在飞书低代码平台创建自定义集成
进入飞书低代码平台,应用开发后台的集成菜单,点击「添加飞书集成」,按照要求填写集成基础信息,具体说明如下:
第 1 步 添加飞书集成
250px|700px|reset
第 2 步 填写自定义集成基本信息,点击「提交」,就进入到了自定义集成的详细配置页。
250px|700px|reset
第 3 步 自定义集成配置详情
250px|700px|reset
(三)完成自定义集成配置
自定义集成权限配置页主要分为 5 个部分:
- 基本信息
- 权限配置
- 机器人
- 移动端网页应用
- 桌面端网页应用
「基本信息」初始已配置;「权限配置」部分必须配置完成;「机器人」「移动端网页应用」「桌面端网页应用」至少完成一项配置方可正常使用。
各部分的配置说明如下:
基本信息
权限配置
在飞书开放平台中如何配置?
在「权限管理」中搜索对应权限,再点击「开通权限」:
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
当把飞书低代码平台发布后,在此配置项处获取到移动端主页 URL:
250px|700px|reset
再到飞书开放平台应用后台,「网页应用」菜单粘贴「移动端主页 URL」:
250px|700px|reset
注意:以上权限和能力部分,仅为确保可用的基础配置。如需使用飞书平台的其他能力,比如创建日程、发起群聊等,请自行开通相应权限。
(四)在飞书开放平台发布企业自建应用
通过以上配置仅是开通了应用所需权限,并没有正式生效。如需实际使用,还需要将飞书开放平台中的企业自建应用发布。
具体步骤如下。
第一步:进入「版本管理与发布」,点击「创建版本」。
250px|700px|reset
第二步:完成版本信息填写,点击最后的「保存」按钮就会提交应用发布申请。
250px|700px|reset
第三步:当企业应用管理员审批通过后,应用就发布成功,可以在飞书低代码平台中使用所需的各项飞书平台能力了。
250px|700px|reset
至此,自定义集成配置就完成,比如可以在流程中使用自定义集成配置了,如下图所示:
250px|700px|reset
