接入流程
- 飞书后台创建应用
- 云助手企业平台填写参数
- 智能关联
- 测试验收
飞书后台创建应用
该步骤在飞书开放平台完成,登录飞书开放平台, 进入开发者后台!
在"企业自建用用"中点击“创建企业自建应用”按钮
填写应用信息
配置项 | 描述 |
---|---|
应用类型 | 企业自建应用 |
应用名称 | 移动审批丨移动报表丨移动计划丨管理简讯丨移动销售丨移动采招等,也可以自定义 |
应用描述 | 例如移动审批应用填写“随时随地,轻松审批”,也可以自定义 |
编辑应用,点击应用进行编辑
更换应用图标
总览 中更换应用图标
获取飞书应用信息(AppID和AppSecret),此两个参数要复制出来后面会用来填写到云助手的飞书集成方案中
开启飞书工作台应用入口
应用功能>>网页中“启用网页“打开,填写应用的首页地址,此地址在云助手企业后台,飞书集成方案里有每个应用的对应的首页地址
云助手企业后台的飞书集成方案中各应用首页地址
开启机器人,此功能用用于发送应用消息,必须开启!
安全设置,设置重定向URL和H5可信域名,用于免登等功能
重定向url填写:
https://www.fdccloud.com/api/feishu/get-code
https://www.fdccloud.com/api/feishu/third-sso
https://www.fdccloud.com/api/yzs-sdk/get-user-v2
H5可信域名填写 https://www.fdccloud.com
设置权限
通讯录权限,用于智能绑定中获取的飞书用户的范围,云助手飞书集成方案中通讯录应用AppId和通讯录应用AppSecret如果选择的是此应用, 请按照需要配置对应的权限,注意此配置不是应用的可见范围,最好给所有的通讯录权限,方便其他应用的用户绑定!
权限设置,使用飞书的api的权限设置,请开启以下权限
搜索的关键字(需要申请的全部权限清单如下)
1. 以应用身份读取通讯录(新版飞书已废弃此权限-可忽略)
2. 获取通讯录基本信息
3. 获取通讯录部门组织架构信息
4. 获取部门基本信息
5. 获取用户基本信息
6. 获取用户组织架构信息
7. 获取成员所在部门路径
8. 查看成员工号
9. 获取用户邮箱信息
10. 获取用户 user ID
11. 获取用户手机号
12. 获取与发送单聊、群组消息
13. 访问审批应用
应用发布
申请发布和审核通过
申请
根据消息提示,进入审批!
确定创建之后,创建成功!
云助手企业平台填写参数
该步骤在云助手企业平台完成。
登录云助手企业平台,在“设置中心-集成到第三方OA”中,选择“飞书集成”,配置集成参数。必填参数缺一不可,请慎重填写
飞书集成方案中各应用首页地址
将对应的应用首页地址配置到飞书应用中
集成参数填写说明
配置项 | 描述 |
---|---|
通讯录应用AppId | 在飞书开发者后台中对应的应用的AppID,用于智能关联的飞书用户拉取 |
通讯录应用AppSecret | 在飞书开发者后台中对应的应用的AppSecret,用于智能关联的飞书用户拉取 |
xx应用AppId | 移动审批、报表等对应的飞书应用的AppId |
xx应用AppSecret | 移动审批、报表等对应的飞书应用的AppSecret |
xx消息渠道 | 控制应用的非待办类消息通知是发送到当前应用还是飞书审批,默认是当前应用 |
xx是否推送消息 | 开启了才会向对应的应用发送消息,否则不会推送消息 |
飞书集成是否推送消息 | 集成的总开关,只有总开关开启,才会检测应用开关的开启状态 |
飞书智能关联
通讯录管理>>企业通讯录>>更多 中选择“飞书账号关联”
设置智能匹配规则
已关联列表查看
明源H5应用集成到飞书后的效果图
手机端工作台
手机端消息
飞书审批bot消息
飞书审批任务(待办)
飞书审批任务(已办)
备注
1.后台有定时作业(每隔2小时/次)拉取飞书用户并智能绑定!