NXCC API cdrQueryByOrder

通过orderid查询cdr记录

• URL：https://api2.nxcloud.com/saas/cc/openapi/cdr/queryByOrderId
• Method：POST
• Content-Type：application/json
• Required：yes

鉴权机制

鉴权规则请参考地址：API 接口调用约定

请求参数

header：

参数名	类型	必选	示例值	说明
accessKey	String	Y	fme2na3kdi3ki	用户身份标识
ts	String	Y	1655710885431	当前请求的时间戳（单位是毫秒），牛信服务端允许用户端请求最大时间误差为 60 秒
bizType	String	Y	8	业务类型，取固定值“8”
action	String	Y	cc	业务操作，取固定值“cc”
sign	String	Y	6e9506557d1f289501d333ee2c365826	API 入参参数签名，签名算法

body ：

参数名	类型	必选	示例值	说明
tenantId	Integer	Y	144	团队ID, 从牛信页面查询到并配置
orderId	string	N		业务id，客户侧发起呼叫的业务id

请求示例

body（application/json）：

{
  "tenantId": 144,
  "orderId": "12333333XXX"
}

响应参数

name	type	Description
code	Integer	code
data	Object	reponse data
msg	String	message

请求成功

• data ：

参数名	类型	说明
agentName	String	客服账号，可能为空
agentNickName	String	客服昵称，可能为空
answered	Boolean	是否接听
answerTime	Long	呼叫接通时间（时间戳 毫秒）
callDuration	Integer	通话时长
callee	String	被叫号码
caller	String	主叫号码
callId	String	通话 id
direction	Integer	呼叫方向，0:呼入,1:呼出,2:AICC
dtmfKeys	String	dtmf 按键，多个时候使用英文逗号分割
endTime	Long	呼叫结束时间（时间戳 毫秒）
hangupBy	Integer	挂断方，挂断方,0:客服挂断,1:用户挂断,2:未知
hangupCode	Integer	挂断原因码
callStatus	String	通话状态
hangupReason	String	挂断原因说明
inQueueTime	Long	入队时间戳（时间戳 毫秒）
leaveMsgUrl	String	留言 url
orderId	String	订单 id
other	String	透传信息
intent	String	意图名称
outQueueTime	Long	出队时间戳（时间戳 毫秒）
queueDuration	Integer	排队时长（单位 秒）
recordUrl	String	录音 url
ringDuration	Integer	响铃时长（单位 秒）
ringTime	Long	呼叫响铃时间（时间戳 毫秒）
startTime	Long	呼叫开始时间（时间戳 毫秒）
taskId	String	任务 ID，direction=2时展示的AICC任务信息
totalCustomerPrice	Double	费用

Response Example

Success Example

{
    "reqId": "a23738fb613d889026fa2c8f4e4378f1",
    "code": 0,
    "msg": "Success",
    "data": [
        {
            "agentName": null,
            "agentNickName": null,
            "answered": false,
            "answerTime": 0,
            "callDuration": 0,
            "callee": "85235757580",
            "caller": "85215236100",
            "callId": "63b09b9a163616c6c009cb326",
            "direction": 0,
            "dtmfKeys": null,
            "endTime": 1690442498901,
            "hangupBy": 0,
            "hangupCode": 1103,
            "callStatus": "Missed Call",
            "hangupReason": "User abandoned while in queue",
            "inQueueTime": 1690442492861,
            "leaveMsgUrl": null,
            "orderId": "",
            "other": null,
            "intent": null,
            "outQueueTime": 1690442498000,
            "queueDuration": 5139,
            "recordUrl": null,
            "ringDuration": 6,
            "ringTime": 1690442492000,
            "startTime": 1690442492841,
            "taskId": "",
            "totalCustomerPrice": 0.035
        },
        {
            "agentName": "NX094450006938",
            "agentNickName": "Example Agent",
            "answered": true,
            "answerTime": 1690423244000,
            "callDuration": 5,
            "callee": "85235757568",
            "caller": "85238531117",
            "callId": "6605fcd9563616c6c009c6240",
            "direction": 0,
            "dtmfKeys": null,
            "endTime": 1690423248124,
            "hangupBy": 1,
            "hangupCode": 1001,
            "callStatus": "Normal",
            "hangupReason": "Agent hang-up",
            "inQueueTime": 1690423237744,
            "leaveMsgUrl": null,
            "orderId": "",
            "other": null,
            "intent": null,
            "outQueueTime": 1690423244000,
            "queueDuration": 6,
            "recordUrl": "https://*********.mp3",
            "ringDuration": 7,
            "ringTime": 1690423237000,
            "startTime": 1690423237704,
            "taskId": "",
            "totalCustomerPrice": 0.035
        }
    ]
}

失败示例

{
  "reqId": "FFDD1791E22F4D9DBA967C245C58E544",
  "code": 41000,
  "msg": "结束日期不能为空",
  "data": {}
}

响应码说明

code	message	Resolution
0	Success
88	Failure	请联系技术人员排除问题
99	System Error	请联系技术人员排除问题
1000~100X	Authorization Failed	详情查看 API 鉴权部分