根据呼叫CallID查询呼叫信息
前置条件
- 座席已签入
- 座席正在通话中
场景描述
座席签入后,根据呼叫CallID查询呼叫信息。
接口方法
设置成“GET”。该接口仅支持GET方法,不支持PUT、POST和DELETE等方法。
接口URI
https://ip:port/agentgateway/resource/calldata/{agentid}/callinfobycallid/{callid}
其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。
序号 |
参数名 |
数据类型 |
选取原则 |
说明 |
---|---|---|---|---|
1 |
agentid |
string |
True |
座席的工号,取值范围:101~59999。 |
2 |
callid |
string |
True |
被查询呼叫ID。 |
日志中的方法名
queryCallInfoByCallId
请求说明
- 消息头
表2 请求头参数说明 序号
名称
参数类型
是否必选
说明
1
Content-Type
string
True
消息主体编码方式,缺省值:application/json; charset=UTF-8
2
Guid
string
True
静态鉴权(AUTHMODE = 1)签入接口返回的Guid;动态鉴权(AUTHMODE = 2)轮询事件接口返回的Guid。
响应说明
序号 |
名称 |
参数类型 |
说明 |
---|---|---|---|
1 |
message |
string |
描述 |
2 |
retcode |
string |
错误码。取值如下: 0:成功 非0:失败 |
3 |
result |
list |
查询成功后,返回呼叫信息对象。 该对象的参数说明请参见表4。 |
序号 |
名称 |
参数类型 |
说明 |
---|---|---|---|
3.1 |
callfeature |
int |
呼叫类型,请参考表1 |
3.2 |
callid |
string |
呼叫ID |
3.3 |
caller |
int |
主叫号码 |
3.4 |
called |
int |
被叫号码 |
3.5 |
callskill |
string |
呼叫技能描述 |
3.6 |
callskillid |
int |
呼叫技能ID |
3.7 |
orgicallednum |
string |
未使用该返回参数 |
3.8 |
calldata |
string |
随路数据 |
3.9 |
begintime |
long |
应答开始时间 |
3.10 |
endtime |
long |
未使用该返回参数 |
3.11 |
userPriority |
int |
客户优先级 |
3.12 |
trunkNo |
int |
中继号 |
3.13 |
logontimes |
int |
进入总时长 |
3.14 |
mediaType |
int |
媒体类型。其中:
|
3.15 |
mediaAbility |
int |
媒体能力。其中:
|
3.16 |
waitTime |
long |
等待应答时间,时间戳(秒) |
3.17 |
trace |
HWCallDeviceTraceEx |
呼叫轨迹扩展属性,预留字段,默认为空。 |
触发事件
- 无
错误结果码
- 100-006
- 100-007
报文样例
- 消息头
Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
- 请求参数
- 响应参数
{ "message": "", "retcode": "0", "result": { "callfeature": 0, "callid": "1476070409-38", "caller": "70001", "called": "10086", "callskill": "voice_jst", "callskillid": 3, "orgicallednum": "12345678", "calldata": "", "begintime": 1476070413000, "endtime": null, "userPriority": 0, "trunkNo": 65535, "logontimes": 0, "mediaType": 5, "mediaAbility": 1, "waitTime": 0, "trace": null } }