服務(wù)端開發(fā)指南
本文為您介紹服務(wù)端的操作步驟及說明。
調(diào)用 CreateAgent創(chuàng)建移動(dòng)坐席賬號(hào)。
請(qǐng)求參數(shù)
參數(shù)名稱
參數(shù)類型
是否必選
示例值
描述
InstanceId
String
是
agent_12345
AICCS實(shí)例ID。可在智能聯(lián)絡(luò)中心控制臺(tái)上獲取。
AccountName
String
是
1501234****
賬號(hào)名稱，實(shí)例內(nèi)唯一（可使用坐席手機(jī)號(hào)、郵箱）。
DisplayName
String
是
測(cè)試賬號(hào)
賬號(hào)顯示名稱。
SkillGroupLists
List<Long>
否
123456，145678
坐席所屬的技能組列表。
返回?cái)?shù)據(jù)
參數(shù)名稱
出參類型
示例值
描述
RequestId
String
"563075BA-4E7A-4546-A8B4-14326822F39C"
請(qǐng)求ID，用于跟蹤錯(cuò)誤原因。
Success
Boolean
true
接口調(diào)用是否成功。
Data
Long
54325
坐席ID。
Code
String
xxxx
錯(cuò)誤編碼。
Message
String
xxxx
錯(cuò)誤描述。
示例程序
// 阿里云賬號(hào)獲取AccessKey ID，AccessKey Secret DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", AK, SK); IAcsClient client = new DefaultAcsClient(profile); CreateAgentRequest request = new CreateAgentRequest(); request.setInstanceId("agent_88888"); request.setAccountName("150293453****"); request.setDisplayName("測(cè)試賬號(hào)"); try { CreateAgentResponse response = client.getAcsResponse(request); System.out.println(JSON.toJSONString(response)); } catch (Exception e) { // TODO }
調(diào)用GetRtcToken獲取token。
請(qǐng)求參數(shù)
參數(shù)名稱
參數(shù)類型
是否必選
示例值
描述
InstanceId
String
是
agent_12345
AICCS實(shí)例ID。可在智能聯(lián)絡(luò)中心控制臺(tái)上獲取。
AccountName
String
是
1501234****
賬號(hào)名稱，實(shí)例內(nèi)唯一（可使用坐席手機(jī)號(hào)、郵箱）。
返回?cái)?shù)據(jù)
參數(shù)名稱
出參類型
示例值
描述
RequestId
String
563075BA-4E7A-4546-A8B4-14326822F39C
請(qǐng)求ID，用于跟蹤錯(cuò)誤原因。
Success
Boolean
true
接口調(diào)用是否成功。
Data
Object
54325
坐席ID。
Data.Token
String
{“cleansession”:true,”clientId”:”GID_VOIP@@@ClientId_2000000000000009_100648480015”,”conferenceTopic”:”cs_alicom_voip_conference”,”host”:”mqtt-cn-4590mdhb901.mqtt.aliyuncs.com”,”meetingEventKeepAliveInterval”:0,”phoneTopic”:”alicom_voip_phone”,”port”:0,”reconnectTimeout”:2000,”registerTime”:0,”sdkClientPort”:8883,”serverId”:”GID_VOIP@@@MTEuMTMuMTM2LjExOA==”,”sgwServerTopic”:”alicom_voip_server_pre”,”tlsport”:443,”tokenData”:”abcdef”,”useTLS”:false}
token對(duì)象，整個(gè)JSON都需要反饋給客戶端并且傳給SDK。
Data.RtcId
String
2000000000000009
移動(dòng)端坐席號(hào)。
Data.AccountName
String
1501234****
坐席賬號(hào)。
Code
String
xxxx
錯(cuò)誤編碼。
Message
String
xxxx
錯(cuò)誤描述。
示例程序
// 阿里云賬號(hào)獲取AccessKey ID，AccessKey Secret DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", AK, SK); IAcsClient client = new DefaultAcsClient(profile); CommonRequest request = new CommonRequest(); request.setSysDomain("aiccs.aliyuncs.com"); request.setSysVersion("2019-10-15"); request.setSysAction("GetRtcToken"); request.setSysMethod(MethodType.GET); request.putQueryParameter("InstanceId", "agent_123234"); request.putQueryParameter("AccountName", "1501912****"); try { CommonResponse response = getClient().getCommonResponse(request); if (response != null && response.getHttpStatus() == 200 && StringUtils.isNotBlank(response.getData())) { JSONObject data = JSONObject.parseObject(response.getData()); if (data.getBoolean("Success")) { Object result = data.get("Data"); System.out.println(result); } } } catch (ServerException e) { log.error(e.getErrCode()); } catch (Exception e) { log.error(""); }
調(diào)用MakeDoubleCall發(fā)起呼叫。
請(qǐng)求參數(shù)
參數(shù)名稱
參數(shù)類型
是否必選
示例值
描述
InstanceId
String
是
agent_12345
AICCS實(shí)例ID。可在智能聯(lián)絡(luò)中心控制臺(tái)上獲取。
AccountName
String
是
1501234****
賬號(hào)名稱，實(shí)例內(nèi)唯一（可使用坐席手機(jī)號(hào)、郵箱）。
ServicerPhone
String
否
150****1234
坐席手機(jī)號(hào)（若填此參數(shù)，則呼叫時(shí)發(fā)起的是pstn的雙呼）。
MemberPhone
String
是
150****1234
用戶手機(jī)號(hào)。
OutboundCallNumber
String
是
0571****1234
外呼主叫號(hào)碼。
BizData
String
否
{"bizData": "2323"}
擴(kuò)展字段。
返回?cái)?shù)據(jù)
參數(shù)名稱
出參類型
示例值
描述
RequestId
String
563075BA-4E7A-4546-A8B4-14326822F39C
請(qǐng)求ID，用于跟蹤錯(cuò)誤原因。
Success
Boolean
true
接口調(diào)用是否成功。
Data
JSONObject
{"Acid": 68255155365620598}
會(huì)話ID。
Code
String
xxxx
錯(cuò)誤編碼。
Message
String
xxxx
錯(cuò)誤描述。
示例程序
// 阿里云賬號(hào)獲取AccessKey ID，AccessKey Secret DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", AK, SK); IAcsClient client = new DefaultAcsClient(profile); CommonRequest request = new CommonRequest(); request.setSysDomain("aiccs.aliyuncs.com"); request.setSysVersion("2019-10-15"); request.setSysAction("MakeDoubleCall"); request.setSysMethod(MethodType.POST); request.putBodyParameter("InstanceId", INSTANCE_ID); request.putBodyParameter("AccountName", "150****7032"); request.putBodyParameter("ServicerPhone", ""); request.putBodyParameter("MemberPhone", "10086"); request.putBodyParameter("OutboundCallNumber", "0571****5980"); try { CommonResponse response = getClient().getCommonResponse(request); if (response != null && response.getHttpStatus() == 200 && StringUtils.isNotBlank(response.getData())) { JSONObject data = JSONObject.parseObject(response.getData()); if (data.getBoolean("Success")) { Object result = data.get("Data"); System.out.println(result); } } } catch (ServerException e) { log.error(e.getErrCode()); } catch (Exception e) { log.error(""); }