访客引入-方式一(通过UID)

<script src="http://kf.ongl.cn/static/chat/js/xchat.js?uid=您的项目用户uid"></script>

说明:uid要求必须为数字,uid=0表示未登录访客,此方式简单灵活方便,但受绑定的域名限制,必须在添加应用时填写的域名(本地虚拟域名亦可)所在页面下进行引入。


访客引入-方式二(通过TOKEN,推荐)

<script src="http://kf.ongl.cn/static/chat/js/xchat.js?token=您的项目获取的token"></script>

// php后端获取token,此处Curl乃curl封装类
$data = Curl::get('http://xxkf.ongl.cn/oauth/getToken', [
    'appid'  => '添加应用时生成的appid',
    'appkey' => '添加应用时生成的appkey',
    'uid'    => '你项目的用户uid'
]);
// $data有2个参数:token和expire(过期时效)
$data = json_decode($data, true);

说明:此种方式不受域名限制,任何地方都可以引入。更加安全


通过自定义参数(强烈建议,src中尽量不传参数)

亦可通过以下方法初始化参数,但<script>src属性中url参数优先(会覆盖自定义参数)
XChat.init({
    token: '',     // 授权token
    uid: '',       // 通过uid绑定域名授权,token字段优先
    gid: 0,        // 分组id,商户后台添加客服分组对应id,默认0
    name: '',      // 自定义访客或用户昵称
    avatar: '',    // 自定义访客或用户图像
    open: 0,       // 是否自动打开聊天窗口,0不加载不打开,1为加载并打开,2为加载不打开
    icon: '<img>', // 自定义聊天按钮图标
    text: '',      // 自定义聊天按钮文字
    rel: '',       // 聊天窗口相对dom,值为dom“id”属性,默认插入body底部
    success: function(box) {  // 启动成功后的回调
        // box为当前聊天窗口对象
        // 你可以通过此回调调整窗口样式或添加事件监听
    },
    onStart: function(cb) {  // 自定义启动
        // 可以在这里添加自定义事件触发启动打开聊天窗口
        cb();  // 启动
    }
});



其它说明

当然也可以直接定义样式覆盖默认样式,如:

.xchat {}

.xchat .xchat-head {}

.xchat .xchat-body {}

.xchat .xchat-start {}

.xchat .xchat-start .xchat-tip {}