目录

高级对接

高级对接您可以自定义更多的内容,除了跟快速集成一样能够自定义弹屏的信息页面外,还可以自定义收到不同系统消息推送时(比如振铃消息、接听消息、挂断消息等)的操作,具体请参考高级接口文档说明及demo源码。demo源码请到callcentersdk_v1.zip下载。

初始化及登录

函数说明

BW8.CC.init(username,pwd,onConnection,onError);

参数说明

名称 类型 注释
usernamestring 帮我吧的客服账号
pwdstring客服账号对应的密码
onConnection回调函数用来接收系统消息推送。如果该参数为空,则执行系统默认消息处理。具体消息参见demo
onError回调函数用来接收系统错误消息。具体请参考返回值格式

说明:仅需在程序开始的时候调用一次。

外呼

函数说明

BW8.CC.call(number); 

参数说明

名称 类型 注释
numberstring 拨打的电话号码。支持手机和座机,如果对方是座机,则拨号为“01063701717”


通话挂断

函数说明

BW8.CC.hangUp();


呼叫弹屏

函数说明

function callPop(url, type){
    if(type == true){
        $('body').append('<div class="container-fluid callPop" id="callPop"><div class="header"><div class="pull-right"><span class="close_icon" onclick="callPop(\'\', false)"></span></div></div><div class="answer"><div class="col-xs-10 answer_left"><div class="pull-left"><span class="glyphicon glyphicon-earphone"></span> <input class="iphone_num" placeholder="'+BW8.CC.getCallNumber()+'" onkeyup="value=value.replace(/[^\d]/g,&quot;&quot;)"></div><div class="pull-right"><span class="iphone_time">00:00</span></div></div><div class="col-xs-2"><span class="hangup_bk" onclick="hangUp();"></span></div></div><div class="url_if_content"><iframe src="'+url+'" width="100%" frameborder="0" scrolling="" height="100%" border="none"></iframe></div></div>');
    }else{
        $('#callPop').remove();
    }
}

参数说明

名称 类型 注释
urlstring 弹屏里面要显示的第三方系统的信息页面。该页面默认宽度为593px,高度为362px。
typebool为“true”时,表示要弹屏;为“false”时,表示要关闭弹屏。默认为false。

说明:如果您想自定义弹屏样式,请直接修改函数里面的css样式


获取来电号码

BW8.CC.getCallNumber();


获取callid

BW8.CC.callId();


开启debug模式

BW8.CC.debug();

转接功能接口

请求参数

名称 类型 必传 注释
action string 操作类型,serviceList-客服列表、groupList-客服组列表、transferService-客服、transferGroup-客服组
callId string 是(转给具体客服、客服组时) 函数中获取的callId
transferIdstring 两个参数至少写一个(转给客服时) 有呼叫中心权限的客服可以指定ID转接
mobile string 没有呼叫中心的客服只能通过具体的号码转接
groupId string 是(转给客服组时) 客服组id

接口地址

GET /api/v1/callCenter.json

转接客服列表

调用示例

curl --location --request GET 'http://ccapi-transfer-20230529.test4.bangwo8.com/api/v1/callCenter.json?action=serviceList' \
--header 'Authorization: Basic b3NwdGVzdDoxMjMxMjNh'

返回参数

名称 类型 注释
call_data array 有呼叫中心权限的在线空闲的客服列表
except_call_data object 没有呼叫中心的客服列表
active_tab string 默认打开的tab kfgroup客服组 kf客服

返回示例

{
    "call_data": [],
    "except_call_data": {
        "189106": {
            "sId": "189106",
            "realName": "cctest002",
            "mobile": "18770918874",
            "sNum": "002" 
        },
        "189109": {
            "sId": "189109",
            "realName": "cctest003勿动舞动舞动舞动",
            "mobile": "17773896237",
            "sNum": "003" 
        }
    },
    "active_tab": "kfgroup" 
}

转接客服组列表

调用示例

curl --location --request GET 'http://ccapi-transfer-20230529.test4.bangwo8.com/api/v1/callCenter.json?action=groupList' \
--header 'Authorization: Basic b3NwdGVzdDoxMjMxMjNh'

返回参数

名称 类型 注释
group object 有呼叫中心权限的在线空闲的客服列表
active_tab string 默认打开的tab kfgroup客服组 kf客服

返回示例

{
    "group": {
        "7339": {
            "groupId": "7339",
            "groupName": "流云" 
        },
        "8957": {
            "groupId": "8957",
            "groupName": "标签测试组" 
        }
    },
    "active_tab": "kfgroup" 
}

转接(客服)操作

调用示例

curl --location --request GET 'http://ccapi-transfer-20230529.test4.bangwo8.com/api/v1/callCenter.json?action=transferService&callId=2323232&transferId=189106&mobile=17600208764' \
--header 'Authorization: Basic b3NwdGVzdDoxMjMxMjNh'

返回结果 status=200 转接成功 其他表示转接失败

{
    "status": "7",
    "message": "{\"msg\":\"Failed to connect to 47.104.61.120 port 1858: Connection refused\",\"data\":{\"action\":\"<?xml version='1.0' encoding='UTF-8'?><Response userdata='-189106-17600208764--2323232-transfer--'><Play_1 async='false' stop_on_input='true' global_sound_file='true'>transfering.wav<\\/Play_1><Play_2 async='true' stop_on_input='true' global_sound_file='true'>background.wav<\\/Play_2><Dial onActionCallback='call_busy' onEndCallback='transfer_end' onAccept='bridge' onAcceptCallback='' record='true' recordingStatusCallback='voice_record' timeout='30'><Number url='agent_transfer' statusCallback='agent_state' StatusCallbackEvent='' LineNumber='' DisplayNumber=''>17600208764<\\/Number><\\/Dial><Hangup><\\/Hangup><\\/Response>\"},\"uri\":\"https:\\/\\/47.104.61.120:1858\\/v1\\/accounts\\/9afb90c41a0bbfc6\\/apps\\/a02d35242988c233\\/calls\"}" 
}

转接(客服组)操作

调用示例

curl --location --request GET 'http://ccapi-transfer-20230529.test4.bangwo8.com/api/v1/callCenter.json?action=transferGroup&callId=2323232&groupId=7339' \
--header 'Authorization: Basic b3NwdGVzdDoxMjMxMjNh'

返回结果 status=200 转接成功 其他表示转接失败

{
    "status": "404",
    "message": "group member is empty" 
}