> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Notion

接待员可以搜索 Notion 工作区、阅读页面，并查看数据库（如价目表、产品表或开放职位列表）来回答来电者。读取操作通过使用 Notion 内部连接的 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks) 完成，适用于所有 Notion 套餐，且只能查看你与其共享的页面。通过只能添加内容的第二个连接，webhook 工具也能向数据库添加条目。你也可以改用 [Zapier](/docs/zh/reception-ai/integrations/zapier)，但建议使用 webhook 工具：无需 Zapier 账户，不会占用 Zapier 任务额度，且每个请求都会直接发送至 Notion。不过，webhook 工具无法填写标题属性；如果条目需要正式标题，请使用 Zapier。

> **Note**
>
> 如果 Notion 内容很少变动，可能不需要集成。可从 Notion 导出页面，
> 然后改为[上传到知识库](#use-the-knowledge-base-instead)。

> **Warning**
>
> 接待员可以读取你与连接共享的所有内容，并向来电者复述。
> 仅共享来电者可以获知的页面，并添加一条
> [规则](/docs/zh/reception-ai/receptionist/rules-and-procedures)，确保接待员绝不向来电者读取
> 客户详细信息等私人记录。

## 设置

### 创建内部连接

你需要是工作区所有者。前往 [app.notion.com/developers/connections](https://app.notion.com/developers/connections)，选择 **Internal connections**，然后选择 **Create a new connection**。将其命名为 `Reception.ai`，并选择工作区。在 **Configuration** 标签页中，仅允许读取内容，然后复制 **API token**。

### 与连接共享页面

打开连接的 **Content access** 标签页，选择 **Edit access**，然后选择接待员应读取的页面和数据库。你也可以在 Notion 中打开页面，选择 **•••** → **Connections** → **+ Add connection**，然后选择 `Reception.ai`。子页面也会一并共享。

### 查找数据源 ID

要让接待员读取数据库，请在 Notion 中打开数据库设置，选择 **Manage data sources**，打开数据源旁的 **•••** 菜单，然后选择 **Copy data source ID**。

### 创建 webhook 工具

创建[以下工具](#tools)。对于每个工具，前往 **Integrations**，选择 **Add integration**，然后选择 **Webhook Tool**。

### 测试

通过询问某个共享页面能够回答的问题来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。

## 工具

每个工具都会发送以下请求标头：

| 标头               | 类型 | 值                 |
| ---------------- | -- | ----------------- |
| `Authorization`  | 密钥 | `Bearer ` 后接连接的令牌 |
| `Notion-Version` | 值  | `2026-03-11`      |

在每个工具中，将 **Assign to agents** 设为 **Receptionist**，然后选择 **Enable**。

### 搜索页面

| 字段       | 值                                                                                    |
| -------- | ------------------------------------------------------------------------------------ |
| **名称**   | `search_notion`                                                                      |
| **描述**   | "按标题搜索我们的 Notion 页面。当来电者询问文档中可能有答案的问题时使用此工具，然后通过 `read_notion_page` 阅读最匹配的页面。"       |
| **方法**   | POST                                                                                 |
| **URL**  | `https://api.notion.com/v1/search`                                                   |
| **正文参数** | `query`（字符串，必填）：“要搜索的简短标题，例如 `pricing` 或 `opening hours`。”  `page_size`（数字，固定值）：`10` |

### 阅读页面

| 字段       | 值                                                    |
| -------- | ---------------------------------------------------- |
| **名称**   | `read_notion_page`                                   |
| **描述**   | “读取通过 `search_notion` 找到的 Notion 页面的完整文本。”           |
| **方法**   | GET                                                  |
| **URL**  | `https://api.notion.com/v1/pages/{page_id}/markdown` |
| **路径参数** | `page_id`（字符串，必填）：`search_notion` 返回页面的 `id`。        |
| **查询参数** | `markdown_version`（字符串，固定值）：`v2`                     |

### 阅读数据库

| 字段       | 值                                                             |
| -------- | ------------------------------------------------------------- |
| **名称**   | `read_notion_table`                                           |
| **描述**   | “列出我们价目表的行。来电者询问价格或我们提供的服务时使用此工具。”请改为描述自己的表。                  |
| **方法**   | POST                                                          |
| **URL**  | `https://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query` |
| **正文参数** | `page_size`（数字，固定值）：`100`                                     |

将 `DATA_SOURCE_ID` 替换为复制的 ID。每个数据库创建一个工具，并分别设置名称和描述。

## 使用 webhook 工具添加数据库条目（推荐）

如需将通话内容保存到 Notion 数据库（例如潜在客户或回电请求），请创建一个用于添加条目的工具。

### 为新条目创建连接

按创建第一个连接的相同方式，创建第二个内部连接，例如 `Reception.ai entries`。在 **Configuration** 标签页中，仅允许插入内容，并复制其 **API token**。在 **Content access** 中，仅共享它需要添加条目的数据库。该连接无法读取任何内容，因此条目会保持私密。

### 准备数据库

如[设置](#set-up)所述，复制数据库的数据源 ID。工具填写的每个属性都是请求中的一个键，而键不能包含空格，因此请为这些属性使用单词名称，例如 `Phone`、`Email` 和 `Status`。

### 创建 webhook 工具

前往 **Integrations**，选择 **Add integration**，然后选择 **Webhook Tool**。

| 字段         | 值                                                                                 |
| ---------- | --------------------------------------------------------------------------------- |
| **名称**     | `add_notion_entry`                                                                |
| **描述**     | “当来电者需要报价或请求回电时，将新的潜在客户保存到我们的潜在客户数据库。”请改为描述自己的数据库。                                |
| **方法**     | POST                                                                              |
| **URL**    | `https://api.notion.com/v1/pages`                                                 |
| **请求标头**   | `Authorization`（密钥）：`Bearer ` 后接新连接的令牌  `Notion-Version`（值）：`2026-03-11`          |
| **正文参数**   | `parent`（对象，必填）  `markdown`（字符串，必填）  `markdown_version`（字符串）  `properties`（对象，必填） |
| **分配给智能体** | **Receptionist**                                                                  |

按以下方式设置正文参数：

* `parent`：一个字段，`data_source_id`（字符串，固定值）：数据源 ID。
* `markdown`（来自对话）：“以 Markdown 格式填写条目。先以 `# ` 开头，加上来电者姓名和需求，例如 `# Jane Doe: quote for a new boiler`。然后添加一个空行和请求详情。”
* `markdown_version`（固定值）：`v2`
* `properties`：每个要填写的属性选择一次 **Add field**。每个属性都是一个与属性名称完全相同的对象，包含一个用于填写值的字段：
  * `Phone`（对象）：`phone_number`（字符串，来自对话）：“来电者的电话号码。”
  * `Email`（对象）：`email`（字符串，来自对话）：“来电者的邮箱地址，向对方拼读确认。如果对方未提供，请省略。”
  * `Status`（对象，必填）：`select`（对象，必填），包含一个字段 `name`（字符串，固定值）：`New`

Notion 文档说明，未填写标题属性时，第一个 `#` 标题会成为页面标题；其文档仅展示了在页面内创建页面的情况，因此请确认这对你的数据库是否有效。无论如何，标题和详细信息都会保存为条目内容，电话、邮箱和状态属性也会填入。不要将标题属性放入 `properties`：Notion 将标题和文本值嵌套了 6 层，比 webhook 工具允许的层数多 1 层。电话号码、邮箱、URL、数字、复选框、选择和日期属性均可使用。Status 类型属性应使用 `status`，而不是 `select`。

选择 **Enable**，然后通过请求回电来[测试接待员](/docs/zh/reception-ai/receptionist/testing)。条目会显示在数据库中。

## 使用 Zapier 添加数据库条目

如要改为通过 Zapier 添加条目，请连接 [Zapier](/docs/zh/reception-ai/integrations/zapier)。在 [mcp.zapier.com](https://mcp.zapier.com) 的 Zapier MCP 服务器中，添加 Notion **Create Data Source Item** 操作，将数据库设为固定值，并让 AI 填写字段。在 Reception.ai 中，打开 Zapier 集成的 **Tools** 标签页，选择 **Refresh tools**，然后将该操作分配给 **Client**（接待员）。

## 改用知识库

对于不常变动的内容，[知识库](/docs/zh/reception-ai/knowledge-base/overview) 比实时查询更简单、更快。在 Notion 中，打开页面的 **•••** 菜单，选择 **More** → **Export**，然后选择 **PDF**、**HTML** 或 **Markdown & CSV**。HTML 和 Markdown 导出会下载为 zip 文件，因此请先解压。然后[上传文件](/docs/zh/reception-ai/knowledge-base/file-uploads)。数据库会导出为 CSV，但知识库不接受该格式，因此请将数据库导出为 PDF。内容变更后，请再次导出并上传。

## 限制

* Notion 搜索匹配的是页面和数据库标题，而非页面内文本。请使用清晰的页面标题，例如“取消政策”。
* `read_notion_table` 返回前 100 行及其属性，不会返回每一行页面内的内容。请让接待员读取的表保持较小规模。
* Notion 托管的 MCP 服务器需要在浏览器中登录；只有商业版和企业版套餐允许工作区所有者创建 MCP 令牌。上述 webhook 工具适用于所有套餐。
* `add_notion_entry` 无法填写标题或文本属性。请改为将姓名和备注放入标题和内容中。
* 如果通过 Zapier 添加条目，接待员运行的每项 Zapier 操作都会占用 Zapier 套餐的任务额度。Zapier 目前将每次成功调用计为 2 个任务。

## 故障排除

| 问题                                           | 检查项                                                                      |
| -------------------------------------------- | ------------------------------------------------------------------------ |
| Notion 返回 401                                | `Authorization` 标头必须为 `Bearer `，后接连接的令牌。                                 |
| 版本相关的 400 错误                                 | 将 `Notion-Version` 设为 `2026-03-11`。                                      |
| 404 或 `object_not_found`                     | 与连接共享页面或数据库，并使用数据源 ID，而不是数据库 ID。                                         |
| `read_notion_page` 返回 403                    | 该连接需要读取内容的权限。                                                            |
| `add_notion_entry` 返回 403                    | 条目连接需要插入内容的权限以及数据库访问权限。                                                  |
| `add_notion_entry` 返回 400 `validation_error` | `properties` 中每个键必须与属性名称完全一致，其字段必须与属性类型匹配。                               |
| 新条目显示为 **Untitled**                          | Notion 未将 `#` 标题作为数据库标题。标题仍位于每个条目页面顶部，你可以通过电话或状态查找条目。如需标题，请使用 Zapier 选项。 |
| 搜索没有结果                                       | 搜索仅匹配标题，且仅匹配与连接共享页面的标题。                                                  |
| 接待员读取大型表时速度较慢                                | 大型表会返回大量数据。请拆分表，或将内容移至知识库。                                               |