入门
免费私有化部署 👈
免费在线使用(快速上手指引)
详细使用说明书(功能介绍) 📔
集成到您的网站、APP或公众号

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


传递访客数据到客服系统,可以实现:

  • 绑定访客身份。不再依赖 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() 方法来获取目标链接地址,参阅:在集成的同时自主打开聊天窗口

All Rights Reserved. 曹旭升 版权所有

E-mail:cao.silhouette@msn.com,来信必复

Skype:live:cao.silhouette,微信:sheng-incog

@南京

关于我 我的产品 我的开源项目

ICP证:皖ICP备14020687号-1

公安备案:34110202000256