传递您的访客数据到客服系统

传递访客数据到客服系统，可以实现：

• 绑定访客身份。不再依赖 Cookie 记录临时访客身份。
• 传递您的业务数据到客服系统。如访客在您网站或 App 中的会员信息、订单信息、消费信息等，客服可以直接查看。

注意：

由于访客接入不需要密码登录，所以参数传递是公开的，具备一些技术基础的人可以很容易的修改传递的参数，改变访客身份或信息。
所以客服在查看传递的访客信息时，仅供参考，对于业务操作，务必通过聊天核实用户身份！

支持参数

externalId

访客唯一标识，由网站或 App 传入客服系统，客服系统用它来标识访客的唯一身份。
可以实现访客身份的永久识别，不再依赖浏览器 Cookie，并使访客身份与网站或 App 真实用户一一匹配。
注意：必须确保此参数有效且每个访客唯一，如果重复使用或传递错误，会造成访客信息混乱。

externalName

访客的名称，默认情况下访客的名称根据所在地域进行自动编号命名。使用此参数可以直接指定访客的名称，可以把你的网站或 App 中真实的客户注册名称传入，客服系统将用此名称来命名访客，并显示给客服人员，如：

externalData

通过键值对的方式，向客服系统传递任意自定义信息。
格式：

key|value,key|value

键和值通过英文竖线分隔，不同的键值对通过英文逗号分隔。

如：

VIP|是,消费金额|100000

客服端程序将展示传递的数据给客服查看。

集成方法

直接打开聊天页面的场景

通过聊天页面 URL 传递即可：

PC：

https://kf-resource.shengxunwei.com/WebChat/WebChat.html
?siteCode=站点代码&externalId=5&externalName=刘备&externalData=VIP|是,消费金额|100000

移动：
对于直接在手机上嵌入使用的的情况，可以直接打开“MobileWebChat.html”，避免一次无意义的跳转，如：

https://kf-resource.shengxunwei.com/WebChat/MobileWebChat.html
?siteCode=站点代码&externalId=5&externalName=刘备&externalData=VIP|是,消费金额|100000

集成到网站页面中的场景

对于集成在网站页面中，追踪访客使用的场景（也就是引用了 embedded.js 的网站页面）。
首先在客服端程序的站点基本信息设置中，把“加载方式”修改为“手工加载”。

然后在引用了 embedded.js 的页面，通过 kf_load 函数加载，在加载前，必须检查 kf_readyToLoad 变量为 true。

<script src="https://kf-resource.shengxunwei.com/ua-parser.min.js"></script>
<script src="https://kf-resource.shengxunwei.com/embedded.js?siteCode=站点代码"></script>

<script>
    var kfLoadInterval = setInterval(function ()
    {
        if(kf_readyToLoad)
        {
            clearInterval(kfLoadInterval);
            kf_load(
                {
                    ExternalId:"5",
                    ExternalName:"刘备",
                    ExternalData:"VIP|是,消费金额|100000"
                }
            );
        }
    },500);
</script>

注意：如果您希望在使用 embedded.js 跟踪访客的同时，能通过自己设计的链接打开聊天窗口，则必须通过 kf_getWebChatUrl() 方法来获取目标链接地址，参阅：在集成的同时自主打开聊天窗口