適用於聊天機器人和 AI 助理的 Notion 整合
關於此整合
Notion 是我們最受歡迎的 AI 聊天機器人整合之一。
將聊天機器人連接到 Notion，讓開發者能直接從對話中建立、更新及搜尋頁面或資料庫，讓 Notion 同時成為動態知識庫與聊天機器人流程的資料儲存系統。
透過這項整合，聊天機器人可以從 Notion 擷取資訊來回答使用者問題、儲存聊天過程中收集的客戶資料，並自動記錄會議筆記、任務或回饋。這讓團隊能輕鬆將對話式 AI 與團隊文件、專案管理或客戶紀錄串接在一起。
對於已經將 Notion 作為核心工作空間的企業來說，Notion 整合特別實用。無需再從聊天內容複製貼上細節，聊天機器人會即時更新 Notion。
這代表團隊隨時都能在 Notion 工作空間中掌握最新的客戶洞察、支援單或任務進度。
透過連接 Notion 與聊天機器人，開發者可以減少手動輸入資料，確保資訊正確，並將 Notion 作為聊天機器人自動化的輸入與輸出來源。
主要功能
- 從聊天機器人對話中建立與更新 Notion 頁面
- 將客戶資料儲存到 Notion 資料庫
- 搜尋 Notion 內容以強化聊天機器人回應
- 自動記錄任務、筆記與回饋
- 將聊天機器人輸入與專案管理看板同步
- 在 Notion 內整理支援資訊
- 從聊天機器人流程觸發 Notion 更新
- 即時保持團隊工作空間最新狀態
我要如何將聊天機器人連接到 Notion？
要將聊天機器人連接到 Notion，請在聊天機器人平台的整合設定中驗證你的 Notion 帳號。這樣聊天機器人就能讀取和寫入 Notion 頁面及資料庫。
我要如何從聊天機器人的對話中建立或更新 Notion 頁面？
你可以透過整合設定，讓聊天機器人將對話資料傳送到 Notion。當發生特定觸發事件（例如使用者提交回饋）時，聊天機器人會建立新頁面或更新現有頁面內容。
我要如何將 Notion 作為聊天機器人回應的知識庫？
你可以將聊天機器人連接到儲存常見問答、政策或文件的 Notion 資料庫。聊天機器人可以查詢該資料庫，並在對話中回傳相關頁面內容作為回應。
我要如何透過聊天機器人搜尋 Notion 內容？
你可以透過整合，將聊天機器人連接到 Notion 資料庫來啟用搜尋功能。當使用者提問時，聊天機器人會在 Notion 中查找關鍵字或實體，並提供符合的資訊。
我要如何將聊天中的不同類型資料儲存到 Notion？
你可以儲存像姓名、電子郵件、回饋、筆記等文字輸入，也能儲存像勾選框、標籤或狀態欄位等結構化資料。整合會將聊天機器人變數對應到 Notion 資料庫欄位。
我要如何自動將聊天機器人的輸入內容同步更新到 Notion 工作區？
你可以建立流程，讓聊天機器人事件觸發 Notion 更新。例如，當客戶在聊天中提交請求時，聊天機器人會自動在 Notion 建立或更新對應項目，讓工作空間隨時保持最新，無需手動操作。
The Notion Integration for Botpress Studio allows you to do the following things:
## Migrating from version `0.x` or `1.x` to `2.x`
Version `2.0` of the Notion integration adds OAuth support, which is now the default configuration option.
If you previously created a Notion integration in the Notion developer portal and wish to keep using this integration, please select the manual configuration option and follow the instructions below.
Otherwise, select the automatic configuration option and click the authorization button, then follow the on-screen instructions to connect your Botpress chatbot to Notion.
## Configuration
### Automatic configuration with OAuth (recommended)
This is the simplest way to set up the integration. To set up the Notion integration using OAuth, click the authorization button and follow the on-screen instructions to connect your Botpress chatbot to Notion. This method is recommended as it simplifies the configuration process and ensures secure communication between your chatbot and Notion.
When using this configuration mode, a Botpress-managed Notion application will be used to connect to your Notion account. Actions taken by the bot will be attributed to this application, not your personal Notion account.
### Manual configuration with a custom Notion integration
#### Step 1 - Create Integration
Create a Notion integration [Create an integration - Notion Developers](https://developers.notion.com/docs/create-a-notion-integration)
#### Step 2 - Give access to Notion Assets
Give your integration access to all the pages and databases that you want to use with Botpress
#### Step 3 - Configure your Bot
Give your integration access to all the pages and databases that you want to use with Botpress. [Share a database with your integration - Notion Developers](https://developers.notion.com/docs/create-a-notion-integration#step-2-share-a-database-with-your-integration)
You need a token to get your newly created Notion Integration _(not the same as Botpress Studio's Notion Integration)_ connected with Botpress Studio:
- `Auth Token` - You'll find this by going to your integration under `https://www.notion.so/my-integrations`. Once you click on your integration, go to the "Secrets" section and find the "Internal Integration Secret" field. Click "Show" then "Copy". Paste the copied token under `Auth Token` field for Notion integration under the "Integrations" tab for your bot.
With that you just need to enable your integration and you can start expanding your Bot's capabilities with Notion.
## Usage
The following actions require you to know the Ids of the Notion entities your bot will work with. All notion entities (pages, databases, etc) have and id that can be found in the URL when you visit those in your Notion account in a Browser,or by getting the link by clicking on the "Copy Link" item in the (...) menu. See [Get a Database Id - Notion Developers](https://developers.notion.com/docs/create-a-notion-integration#step-3-save-the-database-id) for more information
### Add Comment to a Discussion
This action allows you to add a comment to an existing discussion. Use this for replying to a comment.
### Add Comment to a Page
You can add page level comments with this action.
### Get a Database
This allows you to get the details of a Database. This is ideally used with the `Add Page to a Database` action. In addition to the response from the Notion API ([Retreive a Database - Notion Developers](https://developers.notion.com/reference/retrieve-a-database)), this action also returns a optimized `structure` property (technically a type decleration) that can be used as an input for an AI task to instruct it to generate a payload for adding or updating a page in a Notion Database based on a user input.
### Add Page to a Database
This action should ideally be used in tandem with `Get a Database` that returns the structure of the Database that you can use to instruct an [AI task](https://botpress.com/docs/cloud/generative-ai/ai-task-card/) to generate a payload. See [Working with Databases - Notion Developers](https://developers.notion.com/docs/working-with-databases) for more info.
### Delete a block
You can delete the following entities:
- a page in a database
- a page
- a block
