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