1.1 接口说明
当三方平台获取到访客信息时,可通过调用此接口实现对访客昵称、访客ID、与其他相关信息(如会员等级、历史消费记录等)进行扩展参数配置,以便云客服座席在接待过程中直观获取访客的关键信息,提升沟通效率和服务质量
注:在优音云客服系统中,可通过设置–>开发者中心,查看租户ID:tenant_id。
1.2 H5对接方法
在js接入代码的src中拼接对应参数即可,格式如下:
<script src="https://ykf.uincall.com/implugin/implugin/uincallInit.js?id=12429c1e52e443cebf009b8b03c16b97&language=zh-CN&customButton=false&visitorId=访客ID&visitorNickname=访客昵称&visitorExtra=其他相关信息" async="async"></script>
1.3 传参说明
序号 | 名称 | 说明 |
---|---|---|
1 | visitorId | 访客唯一标识符(非必填) |
2 | visitorNickname | 访客昵称(需URL编码,非必填)) |
3 | visitorExtra | 访客其他自定义信息(JSON字符串,需URL编码,非必填) |
1.4 示例代码
1. 访客基本信息:
const visitorId= 'user12345';
const visitorNickname= '张三';
const visitorExtra= [
{
"key": "用户身份",
"value": "张三"
},
{
"key": "客商机来源",
"value": "优音推广"
},
{
"key": "客户等级",
"value": "VIP5"
},
{
"key": "客户标签",
"value": "131xxxxxxxx"
}
];
2. URL编码处理
const encodedNickname = encodeURIComponent(visitorNickname);
const encodedExtra = encodeURIComponent(JSON.stringify(visitorExtra));
3. 拼接完整URL
<script src="https://ykf.uincall.com/implugin/implugin/uincallInit.js?id=12429c1e52e443cebf009b8b03c16b97&language=zh-CN&customButton=false&visitorId=${visitorId}&visitorNickname=${encodedNickname}&visitorExtra=${encodedExtra}" async="async"></script>
1.5 对接效果示例
文档更新时间: 2025-08-22 10:53 作者:admin