跳到导航

Notion

根据 Notion 页面和数据库回答来电者的问题,并向数据库添加新条目。

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

如果 Notion 内容很少变动,可能不需要集成。可从 Notion 导出页面, 然后改为上传到知识库。

接待员可以读取你与连接共享的所有内容,并向来电者复述。 仅共享来电者可以获知的页面,并添加一条 规则,确保接待员绝不向来电者读取 客户详细信息等私人记录。

设置

1

创建内部连接

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

2

与连接共享页面

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

3

查找数据源 ID

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

4

创建 webhook 工具

创建以下工具。对于每个工具,前往 Integrations,选择 Add integration,然后选择 Webhook Tool。

5

测试

通过询问某个共享页面能够回答的问题来测试接待员。

工具

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

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

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

搜索页面

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

阅读页面

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

阅读数据库

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

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

使用 webhook 工具添加数据库条目(推荐)

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

1

为新条目创建连接

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

2

准备数据库

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

3

创建 webhook 工具

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

字段值
名称add_notion_entry
描述“当来电者需要报价或请求回电时,将新的潜在客户保存到我们的潜在客户数据库。”请改为描述自己的数据库。
方法POST
URLhttps://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,然后通过请求回电来测试接待员。条目会显示在数据库中。

使用 Zapier 添加数据库条目

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

改用知识库

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

限制

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

故障排除

问题检查项
Notion 返回 401Authorization 标头必须为 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_errorproperties 中每个键必须与属性名称完全一致,其字段必须与属性类型匹配。
新条目显示为 UntitledNotion 未将 # 标题作为数据库标题。标题仍位于每个条目页面顶部,你可以通过电话或状态查找条目。如需标题,请使用 Zapier 选项。
搜索没有结果搜索仅匹配标题,且仅匹配与连接共享页面的标题。
接待员读取大型表时速度较慢大型表会返回大量数据。请拆分表,或将内容移至知识库。