← 返回转文字工作台

飞书表格配置教程

首次使用「飞书表格」批量转写，需要先在飞书开放平台创建一个你自己的应用（约 5–10 分钟，一次配置终身使用）。转文字工作台通过这个应用读取你的表格并把结果回填回去——凭证只属于你自己，Secret 加密存储、绝不回显。

1

创建企业自建应用

打开 飞书开放平台，用你的飞书账号登录：

创建应用入口
① 选「企业自建应用」标签 → 点「创建企业自建应用」（不是商店应用）
创建应用弹窗
② 名称、描述照图随意填，图标任选一个 → 点「创建」
2

开通权限

进入刚创建的应用：

权限管理页
① 点左侧「权限管理」→ 点「批量导入/导出权限」，会弹出一个输入窗口

② 点下面代码框右上角的「复制」按钮，把这段权限代码复制下来：

{
  "scopes": {
    "tenant": [
      "bitable:app",
      "wiki:wiki:readonly"
    ],
    "user": []
  }
}
粘贴权限代码后的弹窗
③ 把刚复制的代码粘贴进弹窗的输入框（先清空框里原有内容）。粘贴好后和下图一模一样 → 点「下一步，确认新增权限」
确认导入权限
④ 看到列出的正是「多维表格」和「知识库」两个权限 → 点「申请开通」
3

发布应用版本

版本管理与发布→创建版本

版本详情
带 * 的两项照图填（版本号 1.0.0、更新说明随意写几个字），其余全部默认——直接划到页面底部点「保存」，弹窗里点「确认发布」即可。

个人版/管理员通常免审核立即生效（图中绿条）；企业成员则需管理员通过一次。

权限修改后不生效？——每次改动权限都需要重新创建版本并发布一次，这是飞书的机制。
4

复制凭证

左侧「凭证与基础信息」

凭证与基础信息
复制 App ID 和 App Secret（Secret 点眼睛图标显示后复制）。
5

回到转文字工作台填入

飞书表格→配置飞书 App→粘贴 App ID 和 App Secret→保存

保存时会实时验证凭证有效性；Secret 加密存储，保存后不再明文展示。

6

最关键的一步：开启表格的链接分享

应用配置好了，但它还访问不了你的表格——对每一张要转写的多维表格照下面五张图做一次：

分享面板
① 打开表格，点右上角蓝色「分享」按钮 → 在「链接分享」下面，点「未开启」两个字（会弹出选项）
选择分享范围
② 在弹出的「分享范围」里，选「互联网获得链接的人」
确认提示
③ 出现提示弹窗，点「确认」（这是飞书的例行提醒，链接不外发就没人能访问，见下方绿色说明）
改为可编辑
④ 点右侧的「可阅读」，在弹出的菜单里改选「可编辑」——转写结果要写回表格，保持只读会导致回填失败
完成状态
⑤ 完成后长这样：「互联网获得链接的人可编辑」。顺手点左下角「复制链接」——回到转文字工作台，粘贴的就是这条链接
开启链接分享不等于公开：表格不会被任何人搜索到，只有拿到这条链接的人才能访问——只要你不把链接外发，表格仍然是私密的。转文字工作台只用它读取链接列和回填转写结果。
「读取数据表列表失败」「表格不存在」报错基本都是漏了这一步——你能打开表格，不代表应用能。
?

常见报错对照

报错原因与解法
凭证验证失败App ID 或 Secret 复制不完整/带了空格，回第 4 步重新复制。
读取数据表列表失败（NOTEXIST）表格的链接分享没开启——做第 6 步。
无权限 / Forbidden权限没开通或没发布版本——检查第 2、3 步；改过权限必须重新发布。
知识库表格读不到缺 wiki:wiki:readonly 权限，回第 2 步补上并重新发布版本。
回填失败但转写成功第 6 步分享权限选了「可阅读」，改成「可编辑」。

配置完成后，回到工作台粘贴表格链接、点「连接表格」即可开始。所有表格共用这一份配置，无需重复设置。