集成飞书

集成能力 #

No.能力类型描述是否支持
1ONES 消息通知到飞书ONES 中产生的消息将通知到飞书,并且支持点击查看详情页面。支持
2同步成员与组织架构到 ONES以飞书企业成员与组织架构作为数据源(User Provider),同步到 ONES 实现快速启用与统一帐号管理。暂未支持
3通过飞书登录到 ONES通过飞书的帐号验证服务,登录到已绑定的 ONES 中,实现安全快捷单点登录。暂未支持

ONES 支持与飞书集成,实现 :

  1. ONES 系统用户与飞书用户绑定;
  2. ONES 系统消息通知到飞书效果;
  3. 飞书通知打开 ONES 对应详情页面。

使用说明 #

公有云版系统 #

① 在系统【团队配置中心】(多团队下【组织管理】)> 【第三方帐号】> 点击【飞书】。

② 在【绑定飞书】页面,按照引导在飞书管理后台获取、安装「ONES 助手」应用,并完成配置后即可。

飞书「ONES 助手」启用与配置说明
/manual/product-ones/ones-account/integration-feishu/ones-connector/

私有部署/高可用部署版系统 #

① 私有部署或高可用部署版本系统用户,需要通过创建飞书自建应用的方式实现 ONES 与飞书的集成。

飞书自建应用创建指南: https://open.feishu.cn/document/uQjL04CN/ukzM04SOzQjL5MDN?lang=zh-CN

② 在系统【团队配置中心】(多团队下【组织管理】)> 【第三方帐号】> 点击【飞书】。

③ 在新打开的配置页面,将你创建的飞书自建应用信息:App ID、App Secret;以及订阅时间配置信息:Encrypt Key、Verification Token,填写到对应输入框中。

并且确认已经在你的飞书自建应用中开启「机器人」能力。

确认完成以上设置后,即可点击「下一步」。系统将检查设置内容,如出现报错请检查你填写信息是否有误或未打开「机器人」能力。

④-1 网页配置。在你的飞书自建应用中「启用网页」,并且把 ONES 系统提供的「桌面端/移动端主页」URL 复制并粘贴到飞书应用“桌面端主页”,“移动端主页”中

④-2 安全设置。通过复制粘贴将ONES 系统提供的3个重定向URL添加到飞书自建应用“安全设置-重定向 URL”中。

④-3 请求网址设置。通过复制粘贴将ONES 系统提供的请求网址 URL 添加到飞书自建应用“请求网址”中。

确认将「接收消息」、「用户和机器人的会话首次被创建」2个事件添加到订阅事件中。

④-4 权限配置。根据界面中的引导将列出的权限添加到飞书自建应用权限配置中。

完成以上配置后,点击「提交配置」按钮。

⑤ 发布自建应用。在ONES 系统完成配置后,你需要发布飞书自建应用。
发布自建应用指南: https://open.feishu.cn/document/uQjL04CN/ugTO5UjL4kTO14CO5kTN

⑥ 绑定用户。为实现 ONES 消息通知到飞书对应用户,需要团队成员各自完成 ONES 帐号与飞书帐号绑定。发布自建应用后,通知你的同事在飞书应用中搜索自建应用。

点击进入应用后,系统将自动发送帐号绑定通知,点击通知中「绑定帐号」按钮。

系统将自动打开浏览器展示扫码绑定页面。

扫码登录后即可确认帐号绑定。

⑦ 开启飞书通知方式。

单个手动开启:手动在系统中各需要通知到飞书的设置中勾选「飞书」渠道(下面以项目-工作项类-工作项通知 为例)。

批量开启开启:在「飞书」配置成功页面,点击「批量添加飞书通知」按钮。

在确认弹窗中点击「确定」,即可批量在全系统「工作项通知」、「工作项提醒」、「后置动作发送通知」设置中勾选「飞书」通知渠道。

⑧ 通知效果。当系统中有新消息时,将通过飞书同步通知到对应用户。

并且,在飞书通知中点击「详情」,可免登打开对应详情页面。