=====高级对接=====
高级对接您可以自定义更多的内容，除了跟快速集成一样能够自定义弹屏的信息页面外，还可以自定义收到不同系统消息推送时（比如振铃消息、接听消息、挂断消息等）的操作，具体请参考[[帮我吧文档:能力接口:呼叫中心:高级接口]]文档说明及demo源码。demo源码请到{{ :帮我吧文档:能力接口:呼叫中心:callcentersdk_v1.zip |}}下载。

====初始化及登录====
函数说明
<code>
BW8.CC.init(username,pwd,onConnection,onError)；
</code>

参数说明
^名称  ^类型  ^注释 ^
|username|string| 帮我吧的客服账号|
|pwd|string|客服账号对应的密码|
|onConnection|回调函数|用来接收系统消息推送。如果该参数为空，则执行系统默认消息处理。具体消息参见demo|
|onError|回调函数|用来接收系统错误消息。具体请参考[[帮我吧文档:能力接口:呼叫中心:概述#返回值格式]]|

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

====外呼====
函数说明
<code>
BW8.CC.call(number); 
</code>

参数说明
^名称  ^类型  ^注释^
|number|string |拨打的电话号码。支持手机和座机，如果对方是座机，则拨号为“01063701717”|
\\
====通话挂断====
函数说明
<code>
BW8.CC.hangUp();
</code>
\\
====呼叫弹屏====
函数说明
<code>
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();
    }
}
</code>

参数说明
^名称  ^类型  ^注释 ^
|url|string| 弹屏里面要显示的第三方系统的信息页面。该页面默认宽度为593px，高度为362px。|
|type|bool|为“true”时，表示要弹屏；为“false”时，表示要关闭弹屏。默认为false。|
//说明：如果您想自定义弹屏样式，请直接修改函数里面的css样式//

\\
====获取来电号码====
<code>
BW8.CC.getCallNumber();
</code>

\\
====获取callid====
<code>
BW8.CC.callId();
</code>

\\
====开启debug模式====
<code>
BW8.CC.debug();
</code>

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


接口地址
<code>
GET /api/v1/callCenter.json
</code>


====转接客服列表====
调用示例
<code>
curl --location --request GET 'http://ccapi-transfer-20230529.test4.bangwo8.com/api/v1/callCenter.json?action=serviceList' \
--header 'Authorization: Basic b3NwdGVzdDoxMjMxMjNh'
</code>

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

返回示例
<code>
{
    "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" 
}
</code>

====转接客服组列表====
调用示例
<code>
curl --location --request GET 'http://ccapi-transfer-20230529.test4.bangwo8.com/api/v1/callCenter.json?action=groupList' \
--header 'Authorization: Basic b3NwdGVzdDoxMjMxMjNh'
</code>

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

返回示例
<code>
{
    "group": {
        "7339": {
            "groupId": "7339",
            "groupName": "流云" 
        },
        "8957": {
            "groupId": "8957",
            "groupName": "标签测试组" 
        }
    },
    "active_tab": "kfgroup" 
}
</code>

====转接(客服)操作====
调用示例
<code>
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'
</code>

返回结果
status=200 转接成功
其他表示转接失败
<code>
{
    "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\"}" 
}
</code>

====转接(客服组)操作====
调用示例
<code>
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'
</code>

返回结果
status=200 转接成功
其他表示转接失败
<code>
{
    "status": "404",
    "message": "group member is empty" 
}
</code>



\\