連接 Notion
適用對象
管理公司 Notion workspace 的人。
存取範圍
ANIMA 只能存取主動勾選分享的頁面與資料庫，無法存取其他頁面。
| 操作 | 支援 |
|---|---|
| 搜尋與讀取頁面、資料庫 | 是 |
| 建立頁面與資料庫 | 是 |
| 編輯頁面內容與屬性欄位 | 是 |
| 新增留言、建立檢視 | 是 |
| 將頁面移至垃圾桶 | 是 需 Update content 權限 |
| 永久刪除 | 否 Notion API 不支援 |
Notion 的刪除是移至垃圾桶，可在 Notion 中還原。Notion API 不支援永久刪除，因此內容不會因 ANIMA 的操作而無法回復。若不希望 ANIMA 有刪除能力，不要開啟 integration 的 Update content 權限。
設定方式
Admin Panel 的 Notion 卡片提供兩種連接方式，依實際顯示的畫面操作。
方式一：直接授權
在 Notion 卡片按「連接」，會跳轉到 Notion 的授權頁面。在授權頁面中選取要分享給 ANIMA 的頁面與資料庫，完成授權。
ANIMA 只能存取在該頁面勾選的內容。
方式二：Internal Integration Token
- 前往
https://www.notion.so/profile/integrations，建立一個 Internal integration，選擇目標 workspace。 - 在該 integration 的 Capabilities 中確認已開啟：
- Read content
- Insert content（建立頁面所需）
- Update content（編輯頁面與屬性所需）
- 複製 Internal Integration Secret（以
ntn_開頭）。 - 開啟每一個要讓 ANIMA 存取的 page 或 database → 右上 ••• → 連結（Connections） → 加入該 integration。
- 回到 Admin Panel，把 token 貼進欄位，按「連結」。
只開 Read content 時，ANIMA 可以查詢但無法建立或編輯。需要寫入請一併開啟 Insert 與 Update content。
第 3 步要對每一個要索引的頁面或資料庫做一次。未加入 connection 的頁面，ANIMA 無法存取。
目前的限制
- 無法永久刪除。 Notion API 只支援移至垃圾桶，內容可在 Notion 中還原。
- 無法存取未分享的頁面。
- 無法自動涵蓋新頁面。 新建立的頁面若不在已分享的父頁面底下，需要另外加入 connection。
常見問題
顯示「Notion REST Token 無效」。
確認貼上的是 Internal Integration Secret（ntn_ 開頭），而且該 integration 已經加入要存取的頁面。只建 integration 不加頁面，token 是無效的。
ANIMA 說無法在 Notion 建立頁面。 該 integration 的 Capabilities 未開啟 Insert content。回 Notion 的 integration 設定頁開啟。
顯示「Notion 授權失效，請重新連接」。 授權過期或被撤銷。在 Notion 卡片按「重新連接」。
顯示「已授權 Notion，但無法將設定同步到 Agent 系統」。 請與我們聯絡。
可以讓 ANIMA 更新 Notion 上的頁面嗎？ 可以。ANIMA 可以建立頁面、編輯內容與屬性欄位。前提是該 integration 已開啟 Insert 與 Update content 權限，且該頁面已加入 connection。
ANIMA 會刪除 Notion 內容嗎？ 只有在 integration 已開啟 Update content 權限，且使用者明確要求時才會執行，且僅移至垃圾桶，可在 Notion 中還原。不希望 ANIMA 有此能力時，不要開啟該權限。