自建飞书应用接入 Grip 并导入资料

先在贵司自己的飞书企业中创建并发布一个企业自建应用，再由 Grip 组织的 Owner 或 Admin 配置应用。配置完成后，每位员工分别授权自己的飞书账号，即可导入本人有权访问的数据。

开始前，请打开飞书开放平台，并确认当前登录的是需要接入 Grip 的企业。

1. 创建应用

1. 打开飞书开放平台，确认当前是贵司企业。
2. 创建一个企业自建应用。

2. 开通权限

打开应用的权限管理，选择批量导入，粘贴下方 JSON 后确认：

{
  "scopes": {
    "tenant": [
      "bitable:app:readonly",
      "board:whiteboard:node:read",
      "docs:document.content:read",
      "docx:document:readonly",
      "drive:drive.metadata:readonly",
      "drive:drive:readonly",
      "search:docs:read",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:retrieve",
      "wiki:wiki:readonly"
    ],
    "user": [
      "bitable:app:readonly",
      "board:whiteboard:node:read",
      "docs:document.content:read",
      "docx:document:readonly",
      "drive:drive.metadata:readonly",
      "drive:drive:readonly",
      "offline_access",
      "search:docs:read",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:retrieve",
      "wiki:wiki:readonly"
    ]
  }
}

3. 配置回调地址

进入安全设置 → 重定向 URL，填入当前 Grip 部署的完整回调地址，将示例占位符替换为实际服务地址：

<Grip 服务地址>/api/integrations/feishu/oauth/callback

4. 发布应用

1. 进入版本管理与发布，创建版本，确保“可用范围”包含需要导入数据的员工，然后申请发布。
2. 等待企业管理员审核通过。

5. 在 Grip 配置企业应用

这一步仅由组织 Owner 或 Admin 操作。

1. 进入 Grip 的云盘 → 新建 → 外部资源 → 飞书。
2. 回到飞书开放平台，打开对应的企业自建应用。
3. 在凭证与基础信息中查看并复制 App ID 和 App Secret。
4. 回到 Grip，输入 App ID 和 App Secret，点击验证并保存。

App Secret 由 Grip 后端加密保存，不会在界面、API 或日志中回显，也不需要发送给对接人。

更新 App ID 或 App Secret 后，每位成员都需要重新授权自己的飞书账号。

6. 员工授权并导入

1. 用自己的 Grip 账号进入对应组织。
2. 进入云盘 → 新建 → 外部资源 → 飞书。
3. 如果企业应用尚未配置，等待 Owner 或 Admin 完成配置。
4. 点击授权我的飞书账号，在浏览器中完成个人授权。
5. 选择本人有权访问的多维表、文档或知识库并导入。

管理员新增飞书权限或更新企业应用凭证后，成员需要重新授权。若权限已经开通并发布，但资源列表仍为空，可先在 Grip 断开连接，再重新授权一次。

还是搞不定？

保留出错步骤和错误提示，便于后续排查。