适用于聊天机器人和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 `2.x` to `3.x`
Version `3.x` of the Notion integration brings a lot of features to the table. Here is a summary of the changes coming to Notion:
- Upgraded to Notion API version **2025-09-03**
- Page interactions: Get Page, Get Page Content, Append Blocks to Page, Update Page Properties
- Search by Title
- Comment created Event
- Consolidate comment actions into one action - `Add Comment`
Another change that the update brings is new manual configuration. It now asks for:
- **Internal Integration Secret (required)**: Same as API Token but changed the name to match what is found in Notion's integration's page.
- **Webhook Verification Secret**: This is used to verify webhook events. Can be found in the bot logs when configuring the webhooks.
## 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.
**Note:** Ensure that you have chosen the correct workspace which can be found on the top right during OAuth.
### 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
You need a token to get your newly created Notion Integration _(not the same as Botpress Studio's Notion Integration)_ connected with Botpress Studio:
- `Internal Integration Secret` - You'll find this by going to your integration under `https://www.notion.so/my-integrations`. Once you click on your integration, under the "Configuration" tab, find the "Internal Integration Secret" field. Click "Show" then "Copy". Paste the copied token under `Internal Integration Secret` 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.
#### Step 4 - Setup Webhooks (optional)
After saving Step 3 configuration, copy the Botpress integration webhook URL. In your Notion integration's Webhooks tab, paste it in `Webhook URL` and click `verify`. Copy the secret from your Bot logs and paste it back in the verification field. Then add this secret to the `Webhook Verification Secret` field in your Botpress Notion integration configuration to validate webhook events.
