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>

先确认问题发生在安装授权、主题显示、消息收发还是订单查询，再按对应步骤处理。店铺数据已连接时，通常应先检查主题设置，而不是立即卸载应用。

找不到在线商店或应用嵌入#

• 在线商店在 SHOPLINE 店铺后台左侧。请从 YundaDesk 的店铺引导打开后台地址，不要在 YundaDesk 菜单或店铺前台查找。
• 应用嵌入在当前主题的设计编辑器左侧；英文后台名称是 App embeds。
• 如果看不到主题编辑入口，请确认账号有编辑主题权限。

完整图文路径见启用前台聊天。

应用嵌入中没有 YundaDesk Chat#

1. 确认当前店铺已安装公开 YundaDesk 应用，并完成工作区连接。
2. 核对 SHOPLINE 后台与 YundaDesk 接入状态中的店铺地址。
3. 关闭并重新打开当前主题编辑器，查看应用嵌入列表。
4. 仍然没有时，记录主题名称和版本，联系支持确认主题兼容性。不要同时粘贴另一份聊天脚本。

开启后仍未检测到嵌入#

1. 确认开启的是 YundaDesk Chat，不是聊天小部件／消息中心。
2. 确认编辑的是当前已发布主题，并已点击右上角保存。
3. 使用 YundaDesk 的打开店铺并检测重新打开前台，不只停留在主题预览中。
4. 店铺有访问密码时先完成访问验证；浏览器阻止新页面时点击继续打开店铺。
5. 检查浏览器内容拦截设置是否阻止聊天加载，按自己的浏览器策略允许后重试。
6. 返回 YundaDesk 刷新状态，并确认当前工作区和店铺没有切换。

上次验证通过属于历史结果。更换主题后必须重新检查开关、保存并检测。

聊天出现了，但消息未收到#

先确认消息发送到了正确的 YundaDesk 工作区，在收件箱中检查会话筛选、分配及接待状态，再按验证渠道消息送达排查。Widget 显示正常不代表每条消息已经送达；以对端实际收到为准。

如果只是 AI 没有回复，请检查该聊天渠道的 Agent 绑定和接待设置，参见配置 Agent。

店铺或工作区不匹配#

检查 SHOPLINE 当前登录店铺，以及 YundaDesk 当前账号和工作区。已连接店铺的确认页可能提供继续访问或账号关联操作，请阅读页面提示后选择。需要改换归属时联系原工作区管理员；不要直接卸载来试探是否能解决，也不要把临时授权链接转发给其他人。

需要重新授权#

1. 在对应店铺的接入状态中按提示选择重新授权。
2. 到 SHOPLINE 核对店铺和权限，完成授权并返回 YundaDesk。
3. 重新检查店铺数据状态、主题中的 YundaDesk Chat 和消息收发。

如果返回页提示请求已失效，请从当前应用入口重新开始。重新授权后仍需验证实际结果，不能只依据跳转完成判断成功。

关闭聊天与卸载有什么区别#

卸载前确认店铺及影响；只是想暂时隐藏聊天时，使用主题开关即可。卸载后返回 YundaDesk 查看最新状态。卸载不等同于立即删除全部历史会话或个人资料；如需数据删除，请参阅安全与数据并联系支持。

联系支持前准备#

通过联系支持提供失败步骤、大致时间、主题名称及版本、页面提示和已脱敏截图。请勿提交密码、授权链接、密钥或完整客户订单资料。