Notion Integration forBotpress Studio 可讓您執行下列工作: ## 從版本`0.x`或`1.x`遷移到`2.x`。 版本 `2.0` 的Notion 整合新增了 OAuth 支援,現在是預設的設定選項。 如果您之前在Notion 開發者入口網站建立了Notion 整合,並希望繼續使用此整合,請選擇手動設定選項,並依照下列指示操作。 否則,請選擇自動設定選項,並點選授權鍵,然後根據螢幕上的指示,將您的Botpress 聊天機與Notion 連線。 ## 配置 ### 使用 OAuth 自動設定 (建議) 這是最簡單的整合設定方式。若要使用 OAuth 設定Notion 整合,請點選授權按鈕,並依照螢幕上的指示將您的Botpress 聊天機與Notion 連線。建議使用此方法,因為此方法可簡化設定流程,並確保聊天機與Notion 之間的安全通訊。 使用此設定模式時,將使用Botpress Notion 應用程式連線至您的Notion 帳戶。聊天機器人所做的動作會歸屬於此應用程式,而非您的個人Notion 帳戶。 ### 使用自訂Notion 整合進行手動設定 #### 步驟 1 - 建立整合 建立Notion 整合 [建立整合 -Notion 開發人員]notion #### 步驟 2 - 給予Notion 資產存取權限 讓您的整合可以存取所有您想與Botpress 搭配使用的頁面與資料庫Botpress #### 步驟 3 - 配置您的 Bot 讓您的整合可以存取所有您想與Botpress 搭配使用的頁面與資料庫。[Share a database with your integration -Notion Developers]notion 您需要一個token來讓您新建立的Notion Integration _(與Botpress Studio的Notion Integration不同)_與Botpress Studio連線: - `Auth Token` - 您可以在notion 下找到您的整合。一旦您點擊您的整合,進入 "Secrets 「部分,找到 」Internal Integration Secret "欄位。按一下「顯示」,然後按一下「複製」。將複製的標記貼在您的機器人「整合」標籤下Notion 整合的「Auth Token」欄位。 如此一來,您只需要啟用整合,就可以開始使用Notion您的機器人功能。 ## 使用方法 以下動作需要您知道Notion 實體的 Ids。所有notion 實體 (頁面、資料庫等) 都有一個 ID,當您在瀏覽器上瀏覽Notion 帳戶時,可以在 URL 中找到該 ID,或是點選 (...) 功能表中的 "Copy Link" 項目來取得連結。更多資訊請參閱 [Get a Database Id -Notion Developers]notion ### 新增評論至討論區 這個動作允許您在現有的討論中加入評論。使用此動作來回覆評論。 ### Add Comment to a Page 您可以使用此動作新增頁面層級的評論。 ### 獲取資料庫 這個動作允許您取得資料庫的詳細資料。這個動作最適合與 `Add Page to a Database` 動作一起使用。除了來自Notion API 的回應 ([Retreive a Database -Notion Developers]notion),這個動作也會回傳一個最佳化的 `structure` 屬性 (技術上是一個 type decleration),可以用來當作 AI 任務的輸入,指示它產生一個 payload,以根據使用者的輸入,在Notion 資料庫中新增或更新一個頁面。 ### 新增頁面至資料庫 這個動作最好與 `Get a Database` 一起使用,它會傳回資料庫的結構,您可以用它來指示 [AI task]botpress 產生一個 payload。更多資訊請參閱 [Working with Databases -Notion Developers]notion。 ### 刪除區塊 您可以刪除下列實體: - 資料庫中的頁面 - 頁面 - 區塊