飞书平台--轻量化集成
相比V21、V22版本,V23新增通讯录部分/全量同步&反向预约功能,新增了对飞书–日历/日程权限、机器人功能的需求,辛苦用户依据文档重新检查配置是否有遗漏
1、飞书侧配置
(1)进入飞书开发平台:https://open.feishu.cn/app?lang=zh-CN,创建企业自建应用
(2)查看创建应用的凭证信息
(3)将创建的应用进行发布,配置页面必填的版本等信息,可用范围设置为全体员工
(4)发布成功后可查看应用的版本详情信息
2、在Smart侧进行配置
(1)进行AK配置(系统中配置飞书集成的信息)
填入应用的凭证信息并保存
(2)在 Smart平台-系统集成-业务集成 ,将通讯录和协同平台都选中飞书, 选中即可,先不点击手动同步
3、回到飞书侧进行应用权限配置
(1)权限设置
以下列出当前版本所需要配置的所有权限信息通讯录● 获取通讯录基本信息● 获取部门基础信息● 获取通讯录部门组织架构信息● 获取用户基本信息● 获取用户组织架构信息● 获取用户邮箱信息● 获取用户 user ID● 获取用户性别● 查询用户职级● 获取用户手机号● 获取企业信息
会议室相关权限● 管理会议室信息● 获取会议室信息● 获取视频会议室信息
日历/日程相关权限● 更新日历及日程信息● 读取日历信息● 获取日历、日程及忙闲信息(用户身份+应用身份,两个权限均需要)●创建日程● 更新日历
日历/日程相关权限是V23新增权限配置,满足smart侧反向预约飞书日程
(2)事件回调配置
添加事件前需要修改配置的订阅方式,订阅方式设置为长连接(如果没有先在Smart侧配置AK信息,则不支持进行订阅方式配置)保存后添加事件:以下列出当前版本所需要配置的所有事件事件配置:● 员工入职● 员工离职● 创建会议室● 删除会议室● 更新会议室● 创建层级● 删除层级● 更新层级● 会议室状态信息变更
(3)添加应用能力
V23新增权限配置,满足smart侧反向预约飞书日程添加应用能力,选择“机器人”
4、发布应用
事件配置完成后再次发布版本(每一次修改都需要进行发布才能生效)
填写相关版本说明之后,发布即可
5、通讯录全量/部分同步配置(V23支持)
(1)登录飞书企业管理后台–工作台–应用管理(2)找到按照上文创建的应用,点击配置–应用可见范围–配置,选择可见范围
6、回到Smart进行同步
飞书-日程预约
前置条件:已完成对接飞书平台
1、在飞书上预约会议
进入飞书APP-日历,预约一个日程,选择对应的会议室
2、预约的日程即可正常同步到Smart上
3、Smart反向预约
①门牌预约
会议室开启门牌预约且绑定第三方空间,在门牌上手动预约或者使用app扫码预约,预约成功后可在飞书侧查看到该日程,同时smart侧同步该日程信息;
门牌扫码预约配置参考如下:
a.Smart会议室管理–会议室配置–预约策略 中开启预约鉴权功能
b.根据提示在对应的管理后台中,下载会议室二维码,保存配置,在门牌上会显示二维码信息,扫码即可实现预约同步
②传感器预约
前提:会议室配置中开启传感器预约,配置持续时间;
表现:有人状态保持X分钟后,会进行会议室预约;预约完成后飞书侧有对应日程,同时smart侧同步该日程信息
预约鉴权和传感器自动预约为互斥,根据使用开启对应配置
③日程APP一键延长
第三方会议室绑定了智慧屏,到达日程结束前时间后日程APP会有延长提示,操作延长后会再重新预约一个新的日程
如果单次延迟的时间大于该会议与下一场会议的间隔时间,则会延长失败