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

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

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

---

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，添加 TabTin 提供的地址。请原样粘贴，不要修改：

https://api.tabtin.com/api/integrations/feishu/oauth/callback

---

4. 发布应用

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

---

5. 在 TabTin 配置企业应用

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

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

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

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

---

6. 员工授权并导入

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

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

---

还是搞不定？

请确认应用已经发布、员工在应用可用范围内，并重新授权一次。仍然无法导入时，把出错步骤和错误提示截图发到 contact@larchiveai.com，我们帮你排查。