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

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
帮我吧文档:能力接口:呼叫中心:高级对接 [2018/06/20 11:11]
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 |}}下载。
  
 ====初始化及登录==== ====初始化及登录====
行 69: 行 69:
 BW8.CC.debug(); BW8.CC.debug();
 </code> </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>
 +
 +
 +
 +\\

页面工具