査詢通話記錄清單

POST

https://api.laaffic.com/v3/cc/record/query

査詢通話記錄清單。

請求參數

參數	說明	是否必填	類型
current	當前頁碼，1-N	是	Integer
size	每頁顯示數，1-100	是	Integer
params	分頁參數	是	JSONObject
startTime	查詢起始時間，ISO8601標準時間格式:2022-01-01T00:00:00+08:00	是	String
endTime	查詢起始時間，ISO8601標準時間格式:2022-01-31T00:00:00+08:00	是	String
voiceGroupId	坐席組(坐席組查詢返回voiceGroupId)	否	Integer
sipGroupName	坐席組	否	String
seatId	坐席id	否	List<Integer>
seatNameList	坐席名稱列表	否	List<String>
callType	呼叫類型 1-群呼轉坐席，2-呼入，3-呼出	否	List<Integer>
hangupReason	掛機原因：0-呼出未接聽,1-呼出被掛斷,2-轉接響鈴掛斷,3-轉接成功掛斷,4-呼叫失敗,5-被叫運營商暫無服務,6-被叫不在服務區,7-被叫忙線,8-呼入未接聽,9-呼入被掛斷	否	List<Integer>
calledOrCaller	被叫或者主叫號碼	否	String
ccode	國家碼	否	List<String>
hangingDirection	掛斷方向，0-客戶掛斷，1-坐席掛斷，3-無	否	List<Integer>
labelNames	標籤名稱	否	List<String>

請求示例

      Request URL: 
    https://api.laaffic.com/v3/cc/record/query
Request Method:
    POST
Request Headers:
    Content-Type: application/json;charset=UTF-8
    Sign: 05d7a50893e22a5c4bb3216ae3396c7c
    Timestamp: 1630468800
    Api-Key: bDqJFiq9
Request Body:
{
    "current":1,
    "size":15,
    "params":{
        "startTime": "2025-01-08 00:00:00",
        "endTime": "2025-01-09 00:00:00",
        "voiceGroupId": 12
    }
}

響應參數

參數	說明	類型
status	狀態碼，0成功，其他失敗參見響應狀態碼說明	String
reason	失敗原因說明	String
data	對象集合	JSONArray
total	總記錄條數	Integer
size	每頁顯示數	Integer
current	當前頁碼	Integer
pages	總頁碼	Integer
records	數據集合	JSONArray
keyId	主鍵id	Integer
callSessionId	會話id	String
called	加密前的被叫	String
encryptCalled	加密後的被叫	String
calledInfo	被叫資訊	String
caller	主叫	String
region	國家/地區	String
seatName	坐席名稱	String
sipGroupName	坐席組名稱	String
voiceGroupId	坐席組Id	Integer
callDuration	通話時長（單位秒）	Integer
callType	呼叫類型，1-群呼轉坐席	Integer
hangupReason	掛機原因：0-呼出未接聽,1-呼出被掛斷,2-轉接響鈴掛斷,3-轉接成功掛斷,4-呼叫失敗,5-被叫運營商暫無服務,6-被叫不在服務區,7-被叫忙線,8-呼入未接聽,9-呼入被掛斷	Integer
hangupCode	sip碼	String
callStartTime	呼叫開始時間	DateTime
calledAnswerTime	被叫應答時間	DateTime
calledHangupTime	被叫掛機時間	DateTime
voiceUrl	錄音url	String
voiceUrlList	錄音url數組	List<String>
createTime	創建時間	DateTime
updateTime	修改時間	DateTime
ccode	國家碼	String
hangingDirection	掛斷方向，0-客戶掛斷，1-坐席掛斷，3-無	Integer
labelName	標籤名稱	String
labelNameList	標籤名稱轉化數組	List<String>
remark	備註	String
callId	語音id	String
brandId	品牌ID	Integer
brandName	品牌名稱	String
errorReason	錯誤描述	String
ringDuration	響鈴時長	Integer
mediaDetected	媒體檢測	String

響應示例

      {
    "status": 0,
    "reason": "success",
    "data": {
        "total": 1,
        "size": 50,
        "current": 1,
        "searchCount": true,
        "pages": 1,
        "records": [
          {
                "keyId": 50180345,
                "callSessionId": "25010316113064799",
                "called": null,
                "encryptCalled": "8613242926514",
                "calledInfo": "{"被叫資訊1":null,"被叫資訊5":null,"被叫資訊10":null,"被叫資訊4":null,"被叫資訊3":null,"被叫資訊2":null,"被叫資訊9":null,"被叫資訊8":null,"被叫資訊7":null,"被叫資訊6":null}",
                "caller": "8613200000003",
                "region": null,
                "seatName": "為空看顯示號碼",
                "sipGroupName": "測試基礎設置（話機）",
                "callDuration": 47,
                "callType": 3,
                "hangupReason": 1,
                "hangupCode": "1",
                "callStartTime": "2025-01-03 16:10:39",
                "calledAnswerTime": "2025-01-03 16:10:43",
                "calledHangupTime": "2025-01-03 16:11:30",
                "voiceUrl": "agent-call-record-250103/25010316113064799.wav",
                "voiceUrlList": [
                    "agent-call-record-250103/25010316113064799.wav"
                ],
                "createTime": "2025-01-03 16:11:30",
                "updateTime": "2025-01-03 16:11:30",
                "ccode": "86(China)",
                "hangingDirection": 1,
                "labelName": "[]",
                "labelNameList": [],
                "remark": "11111",
                "callId": "250103161038410100100",
                "brandId": 101,
                "brandName": "Laaffic",
                "errorReason": "sucess call(200)",
                "ringDuration": 4,
                "mediaDetected": null
            }
    ]
    }
}

響應狀態碼

status	狀態說明
0	成功
-1	帳號認證異常
-2	ip限制
-16	時間戳過期
-18	系統異常
-20	數據已存在
-22	參數異常
-23	數據上限
-76	搜索時間區間不能大於93天