3、访客名片

1.1 接口说明

当企业自有业务系统（如 CRM、会员平台、用户中心）已完成用户身份识别时，可通过本接口将客户相关信息同步至优音云客服系统。本接口支持自定义配置访客核心信息与扩展参数，包括但不限于访客昵称、会员等级、历史消费记录等字段；
配置完成后，云客服坐席在工作台接待访客时，可直观查看用户的全量关键信息，无需重复向用户核验或询问信息，有效提升沟通效率与服务精准度。

1.2 电商企业 CRM 系统对接场景示例

1.前置条件：用户登录电商平台系统，已识别用户身份，并存储有用户的会员等级（如钻石会员）、近 3 个月消费记录、常用收货地址、历史咨询问题等信息；
2.接口集成：电商平台通过本接口，在用户发起咨询时，将用户的会员等级、近3个月消费总额、常用收货地址等自定义字段信息同步至优音云客服系统；
3.效果展示：

• 访客接入客服会话后，坐席在云客服工作台的访客信息栏中，可直接查看该用户的会员等级、消费记录、收货地址等全量同步信息；
• 接待时无需重复向用户确认身份或订单信息，可直接基于用户画像提供针对性服务（如为钻石会员优先处理售后问题），大幅缩短服务响应时长。

4.延伸说明
优势：对接流程轻量化，无需复杂配置即可快速集成；支持自定义扩展参数，适配不同企业的用户信息展示需求。
限制说明：不建议用于传递大段文本或超大规模数据（如完整订单明细、全量历史聊天记录）；本接口仅支持访客信息的被动展示，无法发起跨平台的业务交互操作（如修改用户等级、编辑订单信息）。

注：在优音云客服系统中，可通过设置–>开发者中心,查看租户ID:tenant_id。

1.3 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.4 传参说明

1.5 示例代码

1. 访客基本信息：

const visitorId= 'user12345';
const visitorNickname= '张三';
const visitorExtra= [
  {
    "key": "用户身份",
    "value": "张三"
  },
  {
    "key": "客商机来源",
    "value": "优音推广"
  },
  {
    "key": "客户等级",
    "value": "VIP5"
  },
  {
    "key": "客户标签",
    "value": "131xxxxxxxx"
  }

];

2. URL编码处理

const encodedNickname = encodeURI(visitorNickname);
const encodedExtra = encodeURI(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.6 对接效果示例