插件定制功能已停止使用，请勿开发新的插件！

什么是客服插件

在客服接待过程中快速了解用户信息，您可以实现一个会员插件集成到聊天窗口右侧，提升客服接待效率。

插件环境搭建

 进入应用控制台，左侧： 基础技术开放管理——即时通讯服务——E客服设置。填写插件的链接，即可完成插件创建。如下图：

获取当前联系的用户

目前千牛客户端提供了丰富的JS接口，来使用千牛客户端的一些能力。这里只简单介绍如何获取当前接待用户（OpenIM自建账号的userid）的方法，获取到当前接待用户后，自行匹配并展示用户完整的信息。更多接口描述见文档。

        1、JS源引用

                http://g.tbcdn.cn/sj/qn/jssdk.js

        2、JS方法获取当前接待用户（消息通知+主动获取），所有JS的调用务必是在domready后，不然会报workbench未定义。

                消息通知

function regEvent() {
    //注册监听联系人切换的事件，千牛客户端主动发送内容给前端页面
    QN.event.regEvent( {
        eventId : 'wangwang.active_contact_changed',
        success : function(eventId) {
            alert("event success");
        },
        error : function(msg, eventId) {
            alert("event failed");

        },
        notify : function(data, eventId) {
            alert(JSON.stringify(data));
        }
    });
}

                主动获取

function getActiveUser() {
    //手动按钮触发获取当前接待用户的userid
    QN.application.invoke( {
        cmd : 'getActiveUser',
        param : {},
        error : function(msg, cmd, param) {
        },
        success : function(rsp, cmd, param) {
            //alert(JSON.stringify(rsp.uid));
        alert(getSubString(rsp.uid));
    }
    });
}

                解析方法

function getSubString(s) {
    var ss;
    ss = s.substring(8, 100);//截取掉前面8位域信息，剩下的就是OpenIM的自建账号的userid
    return ss;
}

FAQ