传入客户身份资料
商户可以把当前客户的用户名、会员等级、服务编号等信息传给美忆客服。客服在会话右侧直接查看这些资料及客户进入的渠道。
第一步,定义字段
在商家后台打开 接入渠道 → 客户身份字段。填写显示名称和字段标识,点击 保存修改。
| 显示名称 | 字段标识 | 业务示例 |
|---|---|---|
| 用户名 | username | alice |
| 会员等级 | member_level | 专业版 |
| 服务编号 | service_id | svc_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。匿名访问时可以省略此配置,后台会显示带编号的访客名称。
客户身份字段用于接待时展示业务资料。业务系统负责确认客户登录身份,敏感操作需要沿用业务系统的身份核验流程。
