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>

网站聊天组件让访客无需离开网页即可发起咨询。

安装步骤#

1. 打开“渠道”，选择网站渠道。
2. 填写渠道名称，并加入所有允许使用组件的可信网站来源，来源需要精确匹配。留空会取消来源限制，不建议用于生产环境；如果只为临时测试而留空，请在正式发布前补齐生产网站来源。YundaDesk 后台中的实时预览始终可用，不需要把后台域名加入列表。
3. 保存配置并复制页面生成的安装代码。
4. 把代码放到网站所有需要显示聊天入口的页面中，通常位于页面结束标签之前。
5. 发布网站并刷新页面。

如果通过支持的店铺应用安装，组件代码可能由应用自动接入。仍建议打开真实店铺页面完成测试。

查看登录客户接入说明#

在对应网站渠道的配置页，如果显示“客户身份签名密钥”，未生成时可从输入框右侧的“生成密钥”按钮开始。已有密钥时，点击输入框右侧的眼睛图标查看；显示后该位置变为复制图标，复制成功会自动隐藏密钥并恢复眼睛图标。

点击标题旁的问号可查看简短提示，再点击“接入说明”打开完整指南；也可用键盘聚焦问号后按回车打开。安装代码仍从页面顶部的“安装代码”入口查看和复制。

验证是否成功#

使用无痕窗口访问网站，打开聊天组件并发送一条消息。然后检查：

• 工作台是否出现新会话；
• 客户名称和来源是否正确；
• 人工回复能否回到组件；
• 开启 AI 接待后，AI 回复能否在组件中真实出现。

渠道配置页右侧也是同一套真实聊天组件，可以直接输入和发送消息验证接待效果，不是静态示意图。配置预览会默认展开聊天面板，正式网站上的组件仍默认收起。有历史时，首页只显示当前访客最近的一条会话；没有历史时，同一位置显示“与客服对话”。组件刚打开时不会自动要求邮箱。「询问邮箱」默认开启：访客点击“与客服对话”后，首次对话才会显示邮箱表单，完成或跳过后进入消息区。关闭该开关后直接进入对话。最近会话已经结束也仍可查看，再次发送消息时会以同一访客身份进入新的接待会话，不会生成新的客户档案。仅打开组件、查看历史或点击入口不会产生空的排队会话。

每个网站渠道都有独立的安装标识、访客身份和历史记录；同一工作区内多个 Website Widget 的后台预览也不会共享会话。复制安装代码时应使用当前网站渠道页面生成的代码，不要把另一个 Widget 的代码重复用于不同站点。访客收起后再次打开同一个 Widget，或从会话返回首页后重新进入同一会话，都会保留当前内容、阅读位置和已经加载的品牌图片，不会重新从空白页或第一条消息加载；系统仍会在后台补充最新消息。如果 AI 仍在生成回复，返回首页或收起后重新进入同一会话时，三点等待状态也会继续显示；进入其他会话不会沿用该状态。

AI 和人工坐席的完整回复支持 Markdown 排版，包括标题、列表、引用、代码、链接和表格；较宽的表格或代码会在消息气泡内横向滚动，不会撑破聊天窗口。出于安全考虑，回复中的原始 HTML 和 Markdown 远程图片不会直接加载。

设置 界面语言#

进入“渠道”，选择对应的网站 Widget，在配置中找到“界面语言”。选择“English”并保存，然后刷新已挂载的网站，即可固定使用英文界面。重新打开渠道配置可检查保存结果。Free 套餐也可以使用，此设置只影响当前渠道。

选择“自动”时，优先跟随网站声明的页面语言；网站未声明支持的语言时，按访客浏览器的语言顺序选择。可固定选择 English、简体中文、繁體中文、日本語、한국어、Español、Português (Brasil)、Français、Deutsch、Bahasa Indonesia、ไทย和 Tiếng Việt。自动模式没有匹配语言时使用 English。

右侧实时预览会在保存前展示所选语言。“自动”模式下，可用“预览”旁的语言开关模拟访客语言，不会修改保存的设置；选择固定语言后，预览使用该语言。切换语言不会修改你的源文案。

也可以请 Yuna 将指定网站 Widget 的界面设为英文或自动。确认修改前，请核对渠道和提议的语言。这与 AI 回复语言、客服聊天工具中的“访客默认语言”不同：后者用于消息翻译，不控制 Widget 按钮或界面文字。

询问邮箱#

进入“渠道”，选择对应的网站 Widget，在网站渠道配置中找到「询问邮箱」，位于「隐藏署名」上方。该开关默认开启：访客第一次点“与客服对话”时会询问邮箱，可以跳过。关闭后直接进入对话。

也可以请 Yuna 为指定网站 Widget 打开或关闭询问邮箱。确认修改前，请核对渠道和提议的开关状态。关闭不会删除已经保存的邮箱，访客仍可在对话中自行留下联系方式。

新建网站渠道会自动获得欢迎语：系统按访客界面语言和工作区品牌名生成，不使用渠道名称。打开当前渠道的“展示设置”，只需编辑一套首页标题、首页简介和新对话欢迎语；系统会按访客界面语言翻译，不需要分别维护多种语言。右侧 Widget 在源语言下可即时预览正在编辑的源文案；切到其他语言时会读取对应翻译，不会继续显示源文案。推荐问题也按预览语言读取。翻译暂不可用时，不会把另一种语言的商户文案直接显示给访客。Agent 的自动问题预览读取失败时提供重试，不会误报为知识库暂无问题。

访客可通过聊天窗口的扬声器按钮关闭提示音。如果页面有新提示却没有声音，请检查浏览器的声音权限；部分浏览器会在访客首次与网站交互前限制播放。

联系方式统一在网站渠道独立的“联系我们”设置项中管理，不放在“展示设置”内，最多 8 项。点击“管理”后可以：

• 从已经接入的 Telegram、LINE、WhatsApp、邮箱等渠道添加；
• 手动添加经过校验的公开链接；
• 上传微信、LINE 等联系方式的二维码或图片；
• 使用胶囊开关控制是否展示，并调整顺序或删除。

这项配置需要“管理渠道”权限；只读成员可以查看，但不能修改。其他渠道的配置页只显示该渠道当前被哪些 Website Widget 使用，并提供“前往设置”入口，不再从渠道页反向分配。如果渠道尚未识别公开地址，也可以在 Widget 管理中手动补充。

访客侧优先看到你在“联系方式”中配置的公开名称；通过已接入渠道添加但没有单独填写名称时，使用该渠道的配置名称。只有名称为空时，才按访客界面语言回退到标准渠道类型，例如中文显示“微信”、英文显示“WeChat”。至少启用一个公开联系方式后，首页才显示“联系我们”入口；点击后可以在组件内查看邮箱、Telegram、LINE、二维码或图片等已启用方式。「询问邮箱」开启时，首次对话要求访客填写邮箱的表单只用于识别访客，仅在点击“与客服对话”后出现，不会作为“联系方式”出现；如需公开客服邮箱，请单独添加邮箱联系方式。配置页右侧预览会在保存前同步显示当前启用、排序和新增的全部联系方式；敏感配置不会展示给访客。Telegram 用户名会在渠道配置页以 @用户名 展示；无法自动取得时，也可以手动填写有效的公开用户名后保存。

在“展示设置”的“推荐问题”中开启“聊天首页”或“空白对话”，然后保存。两个开关独立；关闭两项可隐藏问题，已保存的内容仍会保留。点击“管理”可打开接待智能体，编辑展示列表或重新生成候选。具体操作见管理推荐问题。

聊天连接短暂中断时，首页不会显示常驻错误条。如果会话输入区出现“正在恢复连接”，可点击提示重试；连接恢复后提示会消失。消息显示“已发送”只表示该消息已经发送成功；若迟迟收不到回复，请检查网络或联系网站客服。

如果提示访客会话暂不可用，请点击该提示重试。此时已显示的消息和未发送的文字仍会保留；重试成功后可继续聊天。如果反复出现同一提示，请先复制保存未发送内容，再刷新网站页面。

常见问题#

• 看不到组件：如果配置了允许域名，检查当前网站的协议、域名和端口是否精确匹配；同时检查代码是否发布、浏览器是否缓存旧页面。
• 能发但收不到回复：检查渠道状态和消息投递记录。
• AI 不回复：打开 智能体，确认网站渠道已绑定到负责接待的 Agent，并检查 AI 用量和知识状态。