const loginSupport = () => YundaDesk.login({
  getToken: () => fetch('/support/identity', { credentials: 'same-origin' })
    .then(response => {
      if (!response.ok) throw new Error('Identity request failed');
      return response.json();
    })
    .then(({ token }) => token),
});
if (window.YundaDesk?.login) loginSupport();
else window.addEventListener('yundadesk:ready', loginSupport, { once: true });

<script src="https://cdn.yundadesk.com/widget.js" data-yd-key="yd_widget_main" async></script>

你可以把 Notion 页面连接到 YundaDesk。内容同步并处理成功后，AI 才能在回答中使用；回答客户时不会临时访问 Notion。

开始连接#

1. 打开「应用 → 自助服务 → Notion」，点击「前往」；也可以打开 工作空间，再选择 知识库。
2. 在知识库点击「新建文档」。
3. 选择「Notion」入口，再点击「连接 Notion」。
4. 系统会打开新标签页；在 Notion 授权页确认只读访问范围。
5. 授权回跳后，在新标签页选择一个页面作为同步根。
6. 确认并开始首次同步。
7. 等状态变为「正常」，再从知识库顶部选择 测试知识，用关键问题验证回答。

应用商店中的 Notion 卡片默认可见，不需要安装；它只负责打开现有知识库入口。如果连接按钮不可点击，表示当前工作区尚未开放 Notion 连接；可联系 YundaDesk 支持确认可用性，开放后即可授权，不需要重新创建知识库。飞书知识连接当前尚未开放。

如果列表中没有目标范围：

• 先把页面分享给本次连接，再重新加载同步范围。

查看同步状态#

在「新建文档 → Notion」中，连接管理行会显示已同步文档数、上次成功时间、下次计划同步时间和最近错误。同步中会自动刷新；也可以点击「立即同步」。同步开始后，知识库列表会跟随进度自动更新，已同步的文档会陆续出现；同步结束时会立即再刷新一次，不需要手动点击刷新。

同步文档会在知识库原有文档表格中显示为一个可展开的来源文件夹，名称取自你选择的 Notion 页面。展开文件夹即可查看和打开其中的文档；连接、同步和断开等管理控件仍只在 Notion 入口中，不会占用主页面空间。

• 「正常」：最近一轮完整同步成功。
• 「部分失败」：部分文档或第三方请求失败。旧的可用知识会保留，不会因为本轮不完整而误删。
• 「授权失效」：凭据已失效或需要重新授权。

同步成功后，新增或变化的内容仍需完成知识处理，AI 才能使用。可以在文档处理状态和 测试知识 中继续确认。

内容更新与限制#

YundaDesk 会按计划重新同步，也支持手动同步。更新 Notion 内容后，请查看同步结果并测试回答；如果未能完成，根据页面错误提示处理或联系支持。

第三方限流或暂时不可用时，系统会保留上一次成功同步的可用文档。错误恢复后再重试即可。

断开连接#

断开会删除连接凭据并停止后续同步。已经导入的本地文档不会自动删除；如果不再希望 AI 使用它们，请在知识库中单独删除对应文档。