一、场景说明
深度集成是指通过第三方自建应用方式进行对接,满足在飞书侧使用工作台应用跳转到Smart提供的H5页面进行预约,同时支持预约飞书视频会议;
深度集成为双向同步,同时支持同步飞书原生预约的会议室日程和Smart页面直接预约飞书会议室,即会议室来源包括第三方同步和Smart本地创建;
V25版本的深度集成对接飞书后支持以下功能点
支持同步飞书侧的会议室数据
支持同步飞书侧针对会议室日程的预约、编辑、删除等操作
支持smart侧H5预约页面直接预约飞书会议室
通过门牌预约、传感器即占即用、日程APP一键延长日程实现smart终端反向预约飞书会议室的日程
支持通过飞书客户端发送应用卡片消息。如日程预约、审批消息、签到记录下载、及时签到提醒、自动释放确认、释放通知等。
(轻量化集成对比深度集成不同点为:预约方式不同,轻量化集成通过第三方工作台跳转smart预约)
二、深度集成配置方式
1、飞书侧配置
飞书管理员登录,进入开发者后台创建飞书应用
进入应用查看应用凭证信息(用于Smart侧AK配置)
添加应用能力——网页应用(需要先添加该能力,才能在工作台中优先展示网页应用)
深度集成模式下,飞书侧使用工作台跳转H5页面预约Smart日程https://smart域名/manager/ssoLogin
添加应用能力——机器人
深度集成模式下,飞书侧使用H5页面预约Smart日程,发送日程信息通知
将创建的应用进行发布,配置页面必填的版本等信息。
根据使用场景,配置应用的可用成员
2、Smart侧配置应用
登录Smart侧平台,进入系统集成-第三方对接,完成飞书集成的对接配置,其中对接方式为第三方自建应用
3、飞书侧配置
(1)权限配置,进入开发配置-权限管理,开通权限
模块
权限名称
权限类型
通
讯
录
/
企
业
获取通讯录基本信息
contact:contact.base:readonly
应用身份
获取部门基础信息
contact:department.base:readonly
应用身份
获取通讯录部门组织架构信息
contact:department.organize:readonly
应用身份
获取用户基本信息
contact:user.base:readonly
应用身份
获取用户组织架构信息
contact:user.department:readonly
应用身份
获取用户邮箱信息
contact:user.email:readonly
应用身份
获取用户 user ID
contact:user.employee_id:readonly
应用身份
获取用户性别
contact:user.gender:readonly
应用身份
查询用户职级
contact:user.job_level:readonly
应用身份
获取用户手机号
contact:user.phone:readonly
应用身份
获取企业信息
tenant:tenant:readonly
应用身份
会
议
室
管理会议室信息
calendar:room
应用身份
获取会议室信息
calendar:room:readonly
应用身份
获取视频会议室信息
vc:room:readonly
应用身份
日
历
更新日历及日程信息
calendar:calendar
应用身份
读取日历信息
calendar:calendar:read
应用身份
获取日历、日程及忙闲信息
calendar:calendar:readonly
用户身份
获取日历、日程及忙闲信息
calendar:calendar:readonly
应用身份
更新日历
calendar:calendar:update
应用身份
创建日程
calendar:calendar.event:create
应用身份
删除日程
calendar:calendar.event:delete
应用身份
读取日程信息
calendar:calendar.event:read
应用身份
更新日程
calendar:calendar.event:update
应用身份
消息
以应用的身份发消息
im:message:send_as_bot
应用身份
PS:获取日历、日程及忙闲需要用户身份和应用身份都开启
(2)事件配置
进入开发配置-事件与回调,添加事件前需要修改订阅方式,订阅方式设置为长连接
(需要先在Smart侧配置AK且协同平台已切到飞书,才进行飞书侧订阅方式的保存)
类型
事件
员工
员工入职
员工离职
会议室
创建会议室
删除会议室
更新会议室
创建层级
删除层级
变更层级
会议室状态信息变更
(3)重定向URL
进入开发配置-安全设置-重定向URL,添加URL (https://smart域名/manager/ssoLogin)。
该地址主要用于应用卡片通知和鉴权跳转等功能。
(4)H5可信域名
开发者后台-安全设置-H5可信域名
PS:如果未配置,H5页面上无法配置参会者
(5)发布应用
(6)工作台添加应用(轻量化集成不需要此步骤)
一定要配置网页应用能力后再配置机器人能力,在工作台中搜索应用添加,即可通过工作台跳转
三、会议平台配置方式
1、飞书侧配置
参考深度集成配置方式中飞书相关配置信息
2、Smart侧配置
前置条件:Smart侧系统集成-第三方对接的协同平台为飞书,对接方式为第三方自建应用;视频会议平台也已对接飞书。
绑定飞书rooms
协同平台为飞书时,仅支持通过空间管理同步飞书的会议室,不支持通过会议室配置手动绑定飞书rooms。
V25支持将飞书同步的第三方会议室升级成自建会议室,达到与本地会议室一致的使用体验。并且升级后会自动绑定原第三方会议室对应的rooms,不支持修改。
通过飞书工作台跳转到Smart提供的H5页面进行预约,视频会议类型选择飞书。若需要同时预定飞书会议室,直接选择从飞书侧同步的会议室或如已升级过的会议室即可。
预约成功后可通过容错列表查看对应飞书会议号,对应飞书个人端也会同步生成会议。