差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- 帮我吧文档:能力接口:呼叫中心:高级对接 [2018/06/20 11:10]
admin 创建
+++ 帮我吧文档:能力接口:呼叫中心:高级对接 [2023/08/16 15:42] (当前版本)
admin [高级对接]
@@ 行 1: / 行 1: @@
 =====高级对接=====
-高级对接您可以自定义更多的内容，除了跟快速集成一样能够自定义弹屏的信息页面外，还可以自定义收到不同系统消息推送时（比如振铃消息、接听消息、挂断消息等）的操作，具体请参考[[帮我吧文档:能力接口:呼叫中心:高级接口]]文档说明及demo源码。demo源码请到http://bangwo8.oss-cn-shenzhen.aliyuncs.com/SDK/callCenterSDK_v1.rar下载。
+高级对接您可以自定义更多的内容，除了跟快速集成一样能够自定义弹屏的信息页面外，还可以自定义收到不同系统消息推送时（比如振铃消息、接听消息、挂断消息等）的操作，具体请参考[[帮我吧文档:能力接口:呼叫中心:高级接口]]文档说明及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>
+\\

差别

页面工具