文档/飞书应用配置

飞书应用配置

从创建企业自建应用开始,完成飞书权限开通、版本发布,并获取飞书转存专家所需的 App ID 和 App Secret。

使用飞书转存专家前,需要在飞书开放平台创建一个企业自建应用,并为应用开通文档转存所需的权限。完成后,将应用的 App IDApp Secret 填入飞书转存专家即可。

整个配置过程只需完成四步:

  1. 创建企业自建应用
  2. 批量开通应用权限
  3. 创建并发布应用版本
  4. 复制 App ID 和 App Secret

配置应用需要拥有所在飞书企业的应用创建权限。如果创建或发布应用时需要管理员审核,请联系企业管理员完成审批。

第一步:创建企业自建应用

打开飞书开放平台,登录需要使用飞书转存专家的飞书账号,然后进入开发者后台

点击创建企业自建应用,按照截图填写应用信息:

  1. 应用名称:建议填写“飞书转存专家”,也可以使用便于自己识别的名称。
  2. 应用描述:填写“飞书转存专家”或其他简短说明。
  3. 应用图标:可使用平台提供的默认图标,也可以上传自定义图标。确认信息后点击创建
在飞书开放平台创建企业自建应用
填写应用名称和描述,选择图标后点击创建。

应用创建完成后,飞书开放平台会自动进入该应用的管理后台。

第二步:开通应用权限

飞书转存专家需要访问飞书多维表格、电子表格和知识库。为避免逐项搜索,可以通过批量导入一次开通所需权限。

1. 打开批量导入权限

在应用后台左侧菜单中点击权限管理,然后点击页面上方的批量导入/导出权限

进入权限管理并打开批量导入导出权限
先进入权限管理,再点击批量导入/导出权限。

2. 导入权限 JSON

在弹窗的导入页签中,删除编辑器里的原有内容,然后粘贴以下 JSON:

{
  "scopes": {
    "tenant": [
      "bitable:app",
      "wiki:wiki",
      "sheets:spreadsheet"
    ]
  }
}

这三项权限分别用于:

  • bitable:app:查看、评论、编辑和管理多维表格
  • wiki:wiki:查看、编辑和管理知识库
  • sheets:spreadsheet:查看、评论、编辑和管理电子表格

粘贴完成后,点击下一步,确认新增权限

批量导入飞书转存专家所需权限
粘贴权限 JSON 后,点击下一步确认新增权限。

3. 申请开通权限

确认页面应显示三项本次新增的应用身份权限。核对无误后,点击申请开通

确认并申请开通三项应用身份权限
确认多维表格、电子表格和知识库三项权限后申请开通。

返回权限管理页面后,确认以下三项权限的状态均为已开通

  • 查看、评论、编辑和管理电子表格
  • 查看、评论、编辑和管理多维表格
  • 查看、编辑和管理知识库
确认飞书应用所需权限均已开通
三项权限显示“已开通”后,再继续发布应用。

第三步:创建并发布版本

刚刚开通的权限只有在应用发布后才会生效。

在左侧菜单中点击版本管理与发布。首次配置时,点击页面顶部提示中的创建版本;进入版本配置页后,填写版本号和更新说明,确认可用范围,然后保存并提交发布。

如果页面显示需要企业管理员审核,请等待管理员审核通过。应用状态变为已启用,且页面提示当前修改均已发布,才表示配置已经生效。

保存飞书应用版本配置并发布
完成版本信息和可用范围设置后保存,并按页面提示提交发布。

后续如果增加或修改应用权限,也需要重新创建并发布一个版本,否则新的权限不会生效。

第四步:复制应用凭证

应用发布成功后,在左侧菜单中点击凭证与基础信息。在应用凭证区域可以看到:

  1. App ID:点击右侧复制图标进行复制。
  2. App Secret:点击眼睛图标显示内容,再点击复制图标进行复制。
复制飞书应用的 App ID 和 App Secret
分别复制 App ID 和 App Secret,并填写到飞书转存专家的飞书配置中。

将复制的 App IDApp Secret 填入飞书转存专家对应的配置项并保存,即可完成飞书应用配置。

App Secret 相当于应用密码,请勿发布到网页、群聊、代码仓库或其他公开位置。如果凭证已经泄露,请立即在飞书开放平台重置 App Secret,并更新飞书转存专家中的配置。

完成检查

开始使用前,请确认以下项目均已完成:

  • 已创建企业自建应用
  • 多维表格、电子表格和知识库三项权限均显示“已开通”
  • 应用版本已经发布,应用状态为“已启用”
  • 已将正确的 App ID 和 App Secret 填入飞书转存专家

如果配置后仍然无法访问文档,请优先检查应用版本是否已经发布,以及当前飞书账号是否拥有目标文档、表格或知识库的访问权限。