自建飛書應用串接 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，我們幫你檢查。