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>

客户档案用于汇总客户身份、来源渠道、会话历史、标签、备注和客户记忆，帮助团队在回复前了解上下文。

查找客户#

打开“通讯录”页面，可按姓名、社媒 ID 或邮箱搜索，并在“客户”和“已归档”之间切换。默认列表展示客户、渠道 / 来源、地区 / 语言、标签、最近互动和加入时间，末列的三个点菜单提供“查看详情”入口。邮箱或电话放在客户姓名下方；地区与客户档案中的首选语言分两行显示，尽量按当前界面语言展示。标签最多显示两个，多余的用 +N 表示，悬停可查看其名称。加入时间是客户档案的创建日期。最近互动与加入时间使用相同的日期格式，悬停可查看完整时间。“显示列”可隐藏地区 / 语言、标签或加入时间。缺失资料显示为空，不推测补全。没有聊天记录的店铺客户不会把资料同步时间显示成互动时间。客户可能在不同渠道使用不同身份，系统只会根据渠道已确认的精确身份关系进行自动归并；访客在网站聊天中自行填写的邮箱或电话不会被当作已验证身份。无法可靠确认时，不应强行合并。

客户列提供联系方式筛选，渠道 / 来源和地区 / 语言列也提供结构化筛选：可选择有邮箱、有电话或无联系方式，按消息渠道或店铺来源筛选，并按国家 / 地区或未知来源地缩小列表。每组内可多选，不同组的条件会同时生效。名称继续使用顶部搜索，最近互动不提供时间筛选。隐藏来源地列不会清除已选条件，可用“清除全部筛选”恢复完整列表。

点击任一客户行，或打开末列的三个点菜单并选择“查看详情”，即可从右侧打开客户详情；没有消息渠道或已归档的客户也可查看。详情按“概览 / 会话历史 / 行为时间线 / AI 记忆 / 商城”分类，跨渠道身份的归并与解除集中在“会话历史”页签。可点击右上角关闭按钮、按 Esc，或点击详情外的区域返回列表。

客户已关联可收发消息的渠道且未归档时，可从客户详情点击“查看对话”。宽屏下，客户资料保持在右侧，左侧并排打开更窄的快捷回复面板；空间不足时，快捷回复叠放在资料上方。这里显示该客户的真实会话消息，并遵循聊天工作台相同的接入权限；无人接待或由 AI 接待时需先接入，其他坐席接待中的会话需到聊天工作台处理。关闭快捷回复或第一次按 Esc 只关闭快捷回复面板，客户资料仍会保留。

网站、Telegram 或其他消息渠道发生首条业务消息后，对应对象会自动进入“客户”列表；只有初始化或系统事件、尚未发生消息交互的访客不会进入。客户可能需要短暂等待才会出现在列表中；刷新后仍未出现时，先检查消息是否已成功接收。

档案中可以看到什么#

• 已连接的渠道身份和来源；
• 历史会话与最近互动；
• 团队标签和备注；
• 只对该客户生效的 AI 记忆及待跟进事项；
• 已接入系统提供的订单或行为摘要。

聊天侧栏和客户详情的“档案信息”中，可直接查看渠道提供的原名称、用户名、用户 ID、邮箱和电话；有值才显示，并标明所属渠道。修改客户名称后，主标题使用修改后的名称，渠道原名称与主标题不同时仍保留在档案信息中。联系方式与主档相同时不重复，用户名与用户 ID 相同时只显示 ID。聊天侧栏的设备与屏幕尺寸合并展示。客户来源同时显示渠道图标和名称，无需切换到“会话历史”查看这些资料。

网站“浏览页面”行为显示客户实际访问的页面。为保护隐私，页面地址中的参数不会显示。

可见字段取决于渠道、应用和当前工作区能力。未接入数据源时，不会凭空出现订单或行为数据。

店铺同步的客户#

连接 Shopify、Shoplazza 或 SHOPLINE 等店铺应用后，已同步的客户会出现在“客户”列表。列表先展示客户来源；平台客户编号、订单数、累计消费、来源状态与更新时间保留在客户详情中。

店铺客户与消息渠道客户使用同一套客户档案。即使尚未关联网站聊天、社媒或其他可收发消息的渠道身份，也可以维护姓名、邮箱、电话、国家 / 地区、语言和时区等基础资料；但在没有可达消息渠道时不能查看或回复对话。店铺资料会在同步完成后更新，不会在每次打开档案时实时刷新。

维护客户上下文#

标签适合团队分类和协作；备注适合人工补充事实；客户记忆用于 AI 后续服务中的个体偏好。不要把未经确认的推断写成事实，也不要存储与客服无关的敏感信息。

使用客户身份管理把渠道身份归并到目标客户时，相关店铺来源也会保留在目标档案中；后续店铺同步不会自动拆开已经确认的人工归并。归并前请核对客户身份，错误归并会影响会话和店铺上下文。

合并、归档与恢复#

拥有客户数据管理权限的成员可以在客户详情的“更多操作”中合并或归档客户：

• 合并前先搜索另一个客户并查看预览；预览会列出将迁移的渠道身份、会话、店铺来源和字段冲突。确认合并后不能撤销。
• 归档不会删除客户资料。可在客户页顶部的“客户状态”下拉框中选择“已归档”找到并恢复；该客户再次发来消息时也可能自动恢复。
• 没有相应权限时，这些入口不会显示。

删除与纠正#

错误标签、备注和记忆应及时修改。需要永久删除客户数据时，在客户详情中提交删除原因；系统只会创建待审批申请，不会立即删除。管理员批准后才执行不可逆擦除。归档与删除申请是两种不同操作：归档可恢复，已完成的数据擦除不可恢复。