管理组织服务与凭证配置
Notion
创建 Notion integration 并向它开放页面。
适用于组织 Owner / Admin;成员的个人连接器同样适用
在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 Notion,使用 推荐配置。
获取与填写凭证
- 在 Notion 的 My integrations 创建对应 workspace 的 integration。
- 按用途选择读取、更新或插入内容能力,复制 integration 的内部访问 Token。
- 在需要访问的页面中添加该 integration 作为 Connection,分享页面给它;仅创建 Token 不会自动开放所有页面。
- 将 Token 填入 API Key / Token。
官方说明:Notion 身份认证。
服务地址
推荐配置固定使用 https://api.notion.com,路径为 /v1;其他地址改用 自定义。请求需要在 Notion-Version 请求头中指定所用的 API 版本。
验证
保存后请 ZAI 读取一次这个 integration 的 bot 用户(GET /v1/users/me),确认凭证可用。请求失败时,检查 Token 是否仍然有效、integration 是否具备所需的读取、更新或插入能力、页面是否已分享给该 integration,以及请求是否带了 Notion-Version。其余排查见验证与排错。