美忆客服 · 使用指南美忆客服 · 使用指南
新手入门
管理员手册
客服手册
网站接入
常见问题
新手入门
管理员手册
客服手册
网站接入
常见问题
  • 开始使用

    • 第一次使用美忆客服
    • 商户管理员手册
    • 客服操作手册
  • 网站接入

    • 接入美忆客服
    • 传入客户身份资料
    • 浏览器端接入示例
    • 服务端语言接入示例
    • 常见接入问题
  • 问题排查

    • 常见问题排查

传入客户身份资料

商户可以把当前客户的用户名、会员等级、服务编号等信息传给美忆客服。客服在会话右侧直接查看这些资料及客户进入的渠道。

第一步,定义字段

在商家后台打开 接入渠道 → 客户身份字段。填写显示名称和字段标识,点击 保存修改。

显示名称字段标识业务示例
用户名usernamealice
会员等级member_level专业版
服务编号service_idsvc_10086

字段标识以英文字母开头,支持字母、数字和下划线,最长 40 字符且不能重复。显示名称最长 40 字符。每个商户最多配置 20 个字段,全部渠道共用。

第二步,传入客户资料

在网站加载客服脚本前设置 window.MeiyiSettings。name 用于会话列表和客户卡片的显示名称,identity 中的键名对应后台的字段标识。

显示名称优先级:传入的 name → 已配置的 identity.display_name、nickname、username、name(按此顺序)→ 自动编号,例如“访客001”。空白或默认“访客”不作为有效名称。身份字段作为名称时最长 100 字,超过长度仍保留在客户详情中,但不作为列表名称。

匿名编号按商户独立递增并保存到客户记录,同一访客身份刷新页面或再次咨询不会换号;不同浏览器、资料变化或身份过期后建立的新客户会获得新编号。超过 999 后显示“访客1000”,不会截断。

<script>
  window.MeiyiSettings = {
    name: "Alice",
    identity: {
      username: "alice",
      member_level: "专业版",
      service_id: "svc_10086",
    },
  };
</script>
<script
  src="https://meiyi.chat/chat/widget.js"
  data-channel="YOUR_CHANNEL_ID"
  defer
></script>

脚本地址和渠道标识使用后台生成的实际值。客户姓名最长 100 字符,各自定义字段的值使用字符串,每个值最多 500 字符。可以仅传入已经定义的部分字段。未知字段标识会导致接入失败。

不同网站技术如何传入

name 是内置参数,不需要在“客户身份字段”里新增。资料准备好后再加载客服脚本,适用于任何前端框架或服务端语言:

  • HTML、原生 JavaScript、Vue、Nuxt、React、Next.js:在浏览器中读取网站已有用户资料。
  • PHP、Laravel、Python、Java、Node.js、Go、ASP.NET:服务端把已登录用户资料安全输出到页面。

前后端分离项目通常使用第一种方式。模板网站通常使用第二种方式。不要把用户昵称直接拼入 JavaScript 字符串;服务端示例给出了对应模板的 JSON 安全输出方法。

客服查看资料

客户进入聊天后,客服工作台会显示客户姓名、来源渠道及传入的字段。管理员可以单独添加内部备注和客户标签。

资料按客户建立访客身份时保存。字段名称或配置发生变化后,已有客户保留接入时的资料。

登录、退出与切换账号

同一浏览器、同一渠道和同一组资料会复用当前未过期的访客身份。姓名或字段值变化后,将使用独立的访客身份。不同浏览器之间的历史记录各自保存。

客户退出或切换账号后,重新加载网站页面,并根据当前登录状态重新设置 window.MeiyiSettings。匿名访问时可以省略此配置,后台会显示带编号的访客名称。

客户身份字段用于接待时展示业务资料。业务系统负责确认客户登录身份,敏感操作需要沿用业务系统的身份核验流程。

Prev
接入美忆客服
Next
浏览器端接入示例