文档反馈
问问助手智能数据洞察（以下称为 DataWind ）支持与飞书进行功能联动，通过相关能力，用户可以在飞书的工作台直接访问 DataWind 的移动端应用、连接飞书数据源，或者接收 DataWind 推送日/周/月报至飞书个人或群组等，实现飞书联动、协同办公的效果。本文将为您介绍飞书联动集成基础配置操作。
飞书联动集成基础配置一方面需要用户在飞书端进行自建应用、权限配置等操作；另一方面，需要用户在 DataWind 端进行办公平台集成等操作。配置完成后，可以实现飞书联动、协同办公的效果。
注意
本文以飞书 SaaS 标品为例，介绍飞书端的配置操作流程。需要注意的是，飞书开放平台的配置界面会因用户部署环境及版本的不同而存在差异，具体可参考企业自建应用开发流程。
名词解释
相关名词 | 说明 | 使用场景 |
|---|---|---|
用于增加新应用的后台，所有开发者都可以操作 | 在和 DataWind 联动场景中，用于增加应用的后台 | |
飞书组织管理后台，只有飞书组织管理员可以操作 | 审批应用上线，开放相关权限给到该应用 | |
应用管理员 | 对应到智能数据洞察的用户角色是系统管理员 | 为智能数据洞察平台完成对接集成飞书的工作 |
企业组织管理员 | 对应到飞书的用户角色是飞书组织管理员 | 在飞书管理平台中负责开放权限、审批应用上线 |
操作流程概览
整体操作步骤是：
- 飞书端：创建应用 -> 配置权限 - > 发布应用
- 创建飞书应用：由 DataWind 的系统管理员，通常也是飞书开放平台的应用创建者与管理员，在飞书开放平台中创建一个 DataWind 的应用；
- 配置权限管理：由 DataWind 的系统管理员在飞书开放平台开启应用相关的权限；
- 发布飞书应用：由 DataWind 的系统管理员在飞书开放平台创建并申请发布应用新版本，并且经过飞书的组织管理员审核通过，完成整体的应用配置与上线。
- DataWind端：办公平台集成。
具体配置方式后文将会分模块展开介绍，如您有更多关于飞书应用相关的疑问，也可以前往飞书开发平台的帮助中心查看文档介绍。
- 如果您使用的是 Lark ，那么可能会遇到 Lark 开放平台与飞书开放平台在功能上部分差异，如果您希望与Lark进行联动集成配置，请您在官网右下角联系售后进行处理。
创建飞书应用
- 打开企业飞书开放平台，点击右上角头像，选择确认推送应用的企业。
- 点击「创建应用」，进入飞书开放平台的开发者后台。
- 点击「创建企业自建应用」，按提示填写必要的「应用名称」、「应用描述」、「应用图标」。
配置权限管理
调用飞书开放接口之前，需要为应用开通 DataWind 所需的权限。在飞书开放平台的开发者后台中，点击「权限管理」，开始对该应用配置权限。
根据 DataWind 中和飞书联动的使用场景，本文将权限分为以下五个模块。用户可根据自己想要在 DataWind 中实现的联动效果选择权限模块，并按照步骤为应用开通 DataWind 所需的飞书权限。其中，「基础权限」为 DataWind 和飞书联动的基础，为必选项：
DataWind 中和飞书联动的使用场景 | 权限模块 | 是否必选 |
|---|---|---|
| 必选 | |
可选 | ||
| 可选 | |
| 可选 | |
| 可选 |
权限类型介绍：
权限类型 | 介绍 |
|---|---|
应用身份权限 |
|
用户身份权限 |
|
基础权限
权限类型 | 配置说明 |
|---|---|
应用身份权限 |
|
用户身份权限 |
|
注意
数据权限中的通讯录可见范围默认跟随应用可用范围。如果通讯录范围不够大，会导致无法绑定通讯录范围外的用户ID，建议您参考下图，在「版本管理与发布」中将可用范围设置为「所有员工」。
表格/多维表格相关权限
权限类型 | 配置说明 |
|---|---|
用户身份权限 |
|
飞书部门相关权限
权限类型 | 配置说明 |
|---|---|
应用身份权限 |
|
权限审批与飞书打通
权限类型 | 配置说明 |
|---|---|
应用身份权限 |
|
飞书消息发送相关权限
搜索开通下述权限。
权限类型
配置说明
应用身份权限
- 获取与发送单聊、群组消息
- 查看群信息
联系飞书组织管理员，登录到飞书管理后台进行如下操作：
注意
这一步的前提是应用已经发布，若应用未发布，请参考发布飞书应用完成发布操作后再完成此步骤。
- 进入飞书管理后台，点击「工作台」-「应用管理」，找到已发布的应用。
- 选择可用成员，配置可用成员为全部成员。
- 进入飞书管理后台，点击「工作台」-「应用管理」，找到已发布的应用。
在飞书组织管理员完成配置之后，DataWind 系统管理员返回至飞书开放平台，点击「安全设置」。
在「重定向 URL」输入框中添加如下 URL 信息，输入后点击「添加」保存。产品版本
所需添加的 URL 信息
SaaS
https://console.volcengine.com/bi/datawind/#
https://console.volcengine.com/bi/datawind#/dataManage
https://console.volcengine.com/bi/datawind/auth#/dataManage
https://console.volcengine.com/bi/datawind#/dataPrep
https://console.volcengine.com/bi/datawind/auth#/dataPrep
https://console.volcengine.com/bi/datawind/#/prep/dataLink/authCallback/lark_sheet https://console.volcengine.com/bi/datawind/#/prep/dataLink/authCallback/lark_bitable私有化
如下，把 $HOST 替换为产品的部署域名，不包含任何路径：
$HOST/bi
$HOST/bi#
$HOST/bi#/dataManage
$HOST/bi/auth#/dataManage
$HOST/bi#/dataPrep
$HOST/bi/auth#/dataPrep
$HOST/bi/#/prep/dataLink/authCallback/lark_sheet
$HOST/bi/#/prep/dataLink/authCallback/lark_bitable
发布飞书应用
- 创建新版本。在飞书开放平台的开发者后台中，点击「版本管理与发布」，点击「创建版本」，填写「应用版本号」、「更新说明」等内容，点击「保存」，完成版本创建。
- 发布新版本。创建新版本完成后，点击「确认发布」。
注意
- 仅可用范围内的用户能够成功搜索、打开并正常使用网页应用。
- 应用管理员申请发布之后，企业组织管理员会收到开放平台应用审核的消息通知，需要审核之后才可继续后续配置动作。
- 完成新版本创建发布步骤后，点击「凭证与基础信息」，复制 APP ID 和 APP Secret。
以系统管理员身份登录 DataWind，点击「系统管理」点击「办公平台集成」-「飞书」，填入飞书端配置中获取的 APP ID 和 APP Secret，选择「开启」，点击「提交」完成飞书联动集成基础配置。
常见场景
使用场景 | 场景介绍 | 具体配置操作 |
|---|---|---|
账号绑定 | 支持将智能数据洞察（以下称为DataWind）中的用户和飞书账号绑定的功能，包含单个用户绑定与批量绑定等方式。 | |
推送飞书消息 | 当管理员完成了基本的飞书集成（接入飞书应用）的基本配置（含权限配置）后，可以在 DataWind 中设置订阅、预警相关规则，从而实现将图表、仪表盘与数据异动的情况推送到飞书、飞书群的效果。 | |
接入飞书数据源 | DataWind 支持上传飞书表格、飞书多维表格来创建数据集，在数据更新方式上，支持离线数据定时更新。 | |
接入移动端 | 飞书联动应用中，非常重要的一个部分便是在飞书移动端上接入/部署DataWind 的移动端应用，实现在飞书工作台中即可进入、打开DataWind的效果。 |
更多场景
飞书群授权
如果用户需要将仪表盘/数据集授权给一个飞书群，则需完成上述飞书端配置和 DataWind 端配置，然后在仪表盘/数据集针对自己有权限的资源进行授权，如下所示完成操作即可完成该账号的飞书群授权。
注意
需要完成飞书端配置中的基础权限配置和飞书消息发送相关权限配置。
注意
该授权权限的生效范围与配置用户绑定，即由特定用户配置的飞书群授权，仅对该配置用户本人有效。若其他用户有相关需求，需使用其自身账号重新完成配置操作。