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>

WooCommerce 是同一个 YundaDesk 插件中的可选模式。WordPress Widget 不依赖它；只有管理员单独批准 WooCommerce Read（读取）权限后，店铺数据访问才会开始。

开始前#

• 已将 WordPress 站点连接到 YundaDesk。
• 已安装并启用 WooCommerce 8.2 或更高版本。
• 当前账号可以同时管理 WordPress 设置与 WooCommerce。

授权 WooCommerce#

1. 打开设置 → YundaDesk。
2. 找到 WooCommerce 增强。
3. 选择连接 WooCommerce（只读）。
4. 在 WooCommerce 授权页确认申请的权限为 Read。
5. 批准连接，然后返回设置 → YundaDesk。

YundaDesk 不申请 Write 或 Read/Write 权限。你不需要创建或粘贴 Consumer Key、Consumer Secret；请通过上述授权页完成连接。

等待首次同步#

授权完成后，设置 → YundaDesk 会确认 WooCommerce 只读访问已经连接。回到 YundaDesk，打开应用 → WordPress → 管理站点，核对对应地址的 WooCommerce 只读数据状态。也可以从 WooCommerce 应用卡的查看店铺状态进入同一管理界面。若仍显示同步中，请稍后刷新。

站点聊天和店铺数据授权相互独立。需要只读授权时，点击打开 WordPress 设置，在该站点单独批准授权；不要因为另一个站点已连接就认为当前店铺也已授权。

WordPress 设置页确认的是授权状态，不代表所有店铺数据已经可见。请在 YundaDesk 中核对对应店铺的商品和订单，再验证实际查单结果。

重新授权已有店铺#

站点断开后重新连接、恢复历史连接或更换网站地址后，WooCommerce 可能需要重新授权。WordPress 显示已连接不代表店铺读取权限也已恢复。

1. 核对当前 WordPress 网站地址和 YundaDesk 中所选站点。
2. 在设置 → YundaDesk重新选择 WooCommerce 只读连接。
3. 在当前店铺的授权页批准 Read，然后返回设置页。
4. 回到 YundaDesk，刷新对应站点的状态并验证一笔该店铺的订单。

请分别处理每个站点，不要使用另一家店铺的授权代替当前店铺连接。

验证订单查询#

访客在网站聊天中询问订单，AI 客服成功查到后，会在文字气泡下方独立展示简洁的订单卡片：订单号、商品与数量、金额，以及店铺提供的状态。刷新或重新打开同一段聊天后仍可查看。卡片记录的是查询时的信息；需要最新进度时，请再次询问。没有提供的付款或发货状态不会被推断，自定义订单状态也不代表已付款或已发货。

1. 选择一笔用于验收的 WooCommerce 订单，核对订单号、下单邮箱、金额和当前状态。
2. 在 YundaDesk 中打开该客户的会话，确认客户邮箱与订单下单邮箱一致。
3. 在工作台右栏的店铺订单中核对所属店铺及订单信息。多商品订单点击展开 N 件商品，在侧栏展开全部商品名称、数量及已有 SKU；点击收起商品明细可恢复简要展示。
4. 另外使用一个没有订单的测试邮箱，确认没有显示其他客户的订单。

如果仍然无法读取订单，请先核对店铺和邮箱，再检查是否提示重新授权。历史订单曾经显示过，不能代替本次连接的读取验证；不要将暂时无法读取理解为客户一定没有订单。

查看当前购物车#

1. 让访客在已连接的店铺前台建立一个正在接待的 YundaDesk 会话。
2. 在店铺中添加商品、修改数量或移除商品。
3. 客服打开该访客会话，打开右栏店铺订单，在订单上方查看当前购物车。访客无需提供邮箱；没有订单区域时，购物车仍可单独显示。客服账号需要具备查看会话和应用数据的权限。
4. 核对商品名称、数量、已有 SKU、总件数、小计和币种。小计不代表包含运费、税费的最终应付金额。
5. 保持侧栏打开可看到后续更新，也可点击刷新购物车。通过更新于显示的时间判断内容的新旧。

购物车展示最近收到的店铺数据。刷新购物车只重新读取这些数据，不会替访客操作或重新加载店铺购物车。连续修改后若内容暂时滞后，可稍后在店铺再次操作或重新加载店铺页面，再核对更新时间；反复刷新客服页面不能保证补回尚未收到的变化。

购物车只属于当前有效访客会话，YundaDesk 不会据此将访客标记为“弃购”。其他电商平台的购物车入口可能不同。

WooCommerce 被停用时#

WordPress Widget 会继续工作，店铺同步与 WooCommerce 事件投递会暂停。重新启用 WooCommerce 后，请回到设置 → YundaDesk刷新授权状态，再在 YundaDesk 中核对站点增强和实时数据能力。

完整数据边界请阅读WordPress 与 WooCommerce 数据和权限。