帮我吧文档:能力接口:呼叫中心:高级对接 [帮我吧开发文档]

高级对接

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

初始化及登录

函数说明

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

参数说明

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

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

外呼

函数说明

BW8.CC.call(number);

参数说明

名称	类型	注释
number	string	拨打的电话号码。支持手机和座机，如果对方是座机，则拨号为“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();
    }
}

参数说明

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

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

获取来电号码

BW8.CC.getCallNumber();

获取callid

BW8.CC.callId();

开启debug模式

BW8.CC.debug();

转接功能接口

请求参数

名称	类型	必传	注释
action	string	是	操作类型，serviceList-客服列表、groupList-客服组列表、transferService-客服、transferGroup-客服组
callId	string	是（转给具体客服、客服组时）	函数中获取的callId
transferId	string	两个参数至少写一个(转给客服时)	有呼叫中心权限的客服可以指定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" 
}

侧边栏

CRM扩展

数据接口

呼叫能力

Android IM SDK手册（暂停使用）

iOS IM SDK手册（暂停使用）

Android SIP SDK手册

iOS SIP SDK手册

客户端标准版快速集成

帮我吧远程SDK版本

网页在线客服集成

微信接入

目录

高级对接

初始化及登录

外呼

通话挂断

呼叫弹屏

获取来电号码

获取callid

开启debug模式

转接功能接口

转接客服列表

转接客服组列表

转接(客服)操作

转接(客服组)操作

侧边栏

CRM扩展

数据接口

呼叫能力

Android IM SDK手册（暂停使用）

iOS IM SDK手册（暂停使用）

Android SIP SDK手册

iOS SIP SDK手册

客户端标准版快速集成

帮我吧远程SDK版本

网页在线客服集成

微信接入

目录

高级对接

初始化及登录

外呼

通话挂断

呼叫弹屏

获取来电号码

获取callid

开启debug模式

转接功能接口

转接客服列表

转接客服组列表

转接(客服)操作

转接(客服组)操作

页面工具