贤客服
注册试用
自定义配置

在您部署贤客服的代码中,支持配置以下参数:

分配特定客服

在同一个帐号中,如果购买了多个坐席,当客户访问页面时,系统默认随机分配在线坐席。有时你希望指定专属客服,如:

<script>
  (function(w, d, s, g, o) {
    var x = document.createElement(s)
    ,s = document.getElementsByTagName(s)[0];
    w[g] = o;
    x.async = true;
    x.charset = 'utf-8';
    x.src = 'https://cdn.xiankefu.com/dist/xiankefu.js';
    s.parentNode.insertBefore(x, s);
  })(window, document, 'script', 'XIANKEFU_GLOBAL', {
    bid: '您的商家ID' //必传。该值可在贤客服控制台“部署”页面中获取
    ,csid: '客服ID' //用于指定特定客服坐席。该值可在贤客服控制台“部署”页面中获取
  });
</script>

设置悬浮框风格

我们提供了多种悬浮框风格,您可以自由选择。目前支持的风格如下:

<script>
  (function(w, d, s, g, o) {
    var x = document.createElement(s)
    ,s = document.getElementsByTagName(s)[0];
    w[g] = o;
    x.async = true;
    x.charset = 'utf-8';
    x.src = 'https://cdn.xiankefu.com/dist/xiankefu.js';
    s.parentNode.insertBefore(x, s);
  })(window, document, 'script', 'XIANKEFU_GLOBAL', {
    bid: '您的商家ID' //必传。该值可在贤客服控制台“部署”页面中获取
    ,style: 1 //可供选择的值有:1(小横块,默认)、2(圆形)、3(小竖块)
  });
</script>

设置悬浮框标题

如果你想自定义标题,或者不显示标题,可以通过 title 参数实现。

<script>
  (function(w, d, s, g, o) {
    var x = document.createElement(s)
    ,s = document.getElementsByTagName(s)[0];
    w[g] = o;
    x.async = true;
    x.charset = 'utf-8';
    x.src = 'https://cdn.xiankefu.com/dist/xiankefu.js';
    s.parentNode.insertBefore(x, s);
  })(window, document, 'script', 'XIANKEFU_GLOBAL', {
    bid: '您的商家ID' //必选参数。该值可在贤客服控制台“部署”页面中获取
    ,title: '在线咨询' //悬浮框标题。如果不想显示,去掉文字即可。
  });
</script>

设置悬浮框图标

有时你可能希望自定义悬浮框的图标,那么你只需要设置该图标地址即可。

<script>
  (function(w, d, s, g, o) {
    var x = document.createElement(s)
    ,s = document.getElementsByTagName(s)[0];
    w[g] = o;
    x.async = true;
    x.charset = 'utf-8';
    x.src = 'https://cdn.xiankefu.com/dist/xiankefu.js';
    s.parentNode.insertBefore(x, s);
  })(window, document, 'script', 'XIANKEFU_GLOBAL', {
    bid: '您的商家ID' //必选参数。该值可在贤客服控制台“部署”页面中获取
    ,icon: 'url' //图标地址,如:http://abc.com/1.jpg
  });
</script>

自定义悬浮框样式

如果你想改变右下角悬浮框的样式,那么这完全是允许的,你甚至可以任意去改变它(如果你熟悉 css 的话)

<script>
  (function(w, d, s, g, o) {
    var x = document.createElement(s)
    ,s = document.getElementsByTagName(s)[0];
    w[g] = o;
    x.async = true;
    x.charset = 'utf-8';
    x.src = 'https://cdn.xiankefu.com/dist/xiankefu.js';
    s.parentNode.insertBefore(x, s);
  })(window, document, 'script', 'XIANKEFU_GLOBAL', {
    bid: '您的商家ID' //必选参数。该值可在贤客服控制台“部署”页面中获取
    ,css: { //自定义悬浮框样式,支持所有 css 属性
      "bottom": "10px" //悬浮框下外边距
      ,"right": "10px" //悬浮框右外边距
      ,"background": "#000" //悬浮框背景色
      //…
    }
  });
</script>

自定义唯一索引

有时你希望设置一个帐号索引,用于让贤客服在处理数据时进行隔离

<script>
  (function(w, d, s, g, o) {
    var x = document.createElement(s)
    ,s = document.getElementsByTagName(s)[0];
    w[g] = o;
    x.async = true;
    x.charset = 'utf-8';
    x.src = 'https://cdn.xiankefu.com/dist/xiankefu.js';
    s.parentNode.insertBefore(x, s);
  })(window, document, 'script', 'XIANKEFU_GLOBAL', {
    bid: '您的商家ID' //必选参数。该值可在贤客服控制台“部署”页面中获取
    ,key: '索引值' //高阶参数,一般需开发人员配合使用。
  });
</script>

传入用户信息

贤客服会对匿名访客自动生成用户昵称,这意味着你的网站不需要登录即可与客服发起聊天。但很多时候,我们并不想这么做,而是希望将注册用户的信息传递到客服后台,那么即需要用到以下所示的 data 参数:

<script>
  (function(w, d, s, g, o) {
    var x = document.createElement(s)
    ,s = document.getElementsByTagName(s)[0];
    w[g] = o;
    x.async = true;
    x.charset = 'utf-8';
    x.src = 'https://cdn.xiankefu.com/dist/xiankefu.js';
    s.parentNode.insertBefore(x, s);
  })(window, document, 'script', 'XIANKEFU_GLOBAL', {
    bid: '您的商家ID' //必选参数。该值可在贤客服控制台“部署”页面中获取
    ,data:  { //定义用户信息,目前支持以下字段
      "nickname": "马小云" //昵称
      ,"mobile": "18688888888" //手机号
      ,"email": "jack@taobao.com" //邮箱
      ,"avatar": "https://abc.com/1.jpg" //头像
      ,"sex": "男" //性别
      ,"age": "18" //年龄
      ,"qq": "123" //QQ号
      ,"wechat": "mayun" //微信号
      ,"company": "阿里巴巴" //公司名
      ,"remark": "让天下没有难做的生意" //备注信息
    }
  });
</script>

上述赋值给贤客服 data 参数中的用户信息,一般是通过你网站自身的接口得到,你可以在请求该接口后,再进行贤客服代码的初始化操作。赋值后的用户信息将会在贤客服控制台的客服会话界面得以展现。

注意:如果 data 参数中的值带有 & 或 = 字符,请务必先将其按照如下字符转义:

  & 用 %26 替代
  = 用 %3D 替代