飞书应用配置
对接飞书
如果企业采用飞书办公,团队成员可以无需额外注册平台账号,管理员无需额外创建组织架构,直接使用飞书的组织架构,简化操作步骤。
平台的飞书应用绑定采用了飞书【企业自建应用】的模式对接,使用该模式对接,可以获取更多的能力。
对接步骤
如需对接飞书办公,首先需要在后台【站点配置】->【注册登录】选项中,开启飞书扫码登录
开关,否则无法启用扫码功能。
除此之外,还需要在【站点配置】->【第三方配置】->【飞书应用配置】中正确填写绑定参数。
参数的填写请按照下面的图解操作进行:
1、进入创建应用页面
进入飞书开放平台首页,点击创建应用
按钮。
2、创建应用输入应用信息
点击创建企业自建应用
,然后在弹出的页面上填写应用名称、描述并上传图标,点击创建应用按钮。
3、编辑应用
创建应用后,会自动跳转到应用详情页面,可以进行应用编辑。
4、凭证与基础信息
进入凭证与基础信息
页面,在此页面,将App ID
、App Secret
这两个参数保存下来.
5、事件订阅
进入事件订阅
页面,将Encrypt Key
和Verification Token
这两个参数保存下来。
6、后台参数填写
进入后台管理页面站点配置
->第三方配置
->飞书应用配置
页面,将刚才所记录的内容,填写到对应的输入框内。
团队名称可自行定义,也可以使用创建应用时的名称,此处没有强制要求,但所设置的团队名称会在相关页面进行展示。
后台参数填写到此结束,后续需要对飞书应用进行详细配置和设置,设置完毕后需回到此页面进行确认和认证。
7、启用机器人
在添加能力
分类下,添加机器人
8、设置权限
在权限管理
页面,填下下列权限。[重要]
- 用户: 获取用户邮箱信息、获取用户手机号、获取用户 user ID、获取用户基本信息
- 消息: 以应用的身份发消息、给多个用户批量发消息、给一个或多个部门的成员批量发消息、获取与发送单聊、群组消息、获取用户发给机器人的单聊消息、获取用户在群组中@机器人的消息
- 通讯录: 获取用户组织架构信息、获取通讯录部门组织架构信息、获取部门基础信息、以应用身份读取通讯录
- 应用管理: 校验用户是否为应用管理员
9、发布一次应用
设置权限后需进行一次应用发布
和后台安装飞书初始化
,不然事件订阅
>>请求地址
配置时会验证不通过
1、创建版本
在版本管理与发布
页面创建版本
2、可用性设置
创建版本之后,并设置其可用性为:全部成员
3、申请发布
将上述步骤操作完毕后,就可以进行申请发布。
4、审核应用
登录飞书管理后台并通过审核
5、安装飞书初始化
返回私有云后台,点击安装飞书初始化
。
10、复制请求网址URL
填写完毕后,还需要将本页面下方的 [事件订阅]>>[请求网址URL] 的网址复制
11、设置请求网址URL
进入事件订阅页面,在请求网址
->请求网址URL
处粘贴上一步复制的内容:
设置完成后,需点击保存按钮使其生效。
12、设置事件订阅
在事件订阅
页面添加事件,并在弹出的窗口内选择通讯录
分页,勾选所有选项。
13、记录配置访问地址
将页面下方其他内容逐项记录,准备填写到后续的步骤中
14、网页配置
1、在添加应用能力
分类下添加网页应用
2、在网页应用
分类下正确粘贴之前复制的内容
15、安全设置
在安全设置
分类中,粘贴刚才复制的内容
16、管理后台主页
在凭证与基础信息
中正确填写管理后台主页
17、创建版本
在版本管理与发布
页面创建版本
填写版本信息,把默认应用功能改为网页应用
18、申请发布
将上述步骤操作完毕后,就可以进行申请发布。
19、审核应用
登录飞书管理后台
并通过审核,如发布时提示无需审核可跳过这步。
20、确认初始化结果
确认无误后,再次点击安装飞书初始化
,即可完成飞书的绑定,如提示错误,请按步骤检查。