查询呼叫记录详情
服务描述
本接口,根据手机号,呼叫时间,呼叫类型拨打记录信息
开发须知
调用本接口前,请先获取appId
服务地址
GET/POST https://{您的专属域名}/outbound/openapi/v2/detail/query?startTime={startTime}&endTime={endTime}&cellphone={cellphone}&chatType={chatType}&pageNum={pageNum}&pageSize={pageSize}
请求参数
参数 |
位置 |
类型 |
是否必填 |
说明 |
appId |
header |
String |
Y |
应用ID |
timestamp |
header |
String |
Y |
时间戳,毫秒 |
sign |
header |
String |
Y |
签名 |
encrypted |
header |
String |
N |
是否需要加密,需要加密传值(加密方式):AES/REQBODY/RESP,不需要加密不用传该字段 |
Content-Type |
header |
String |
Y |
application/json |
startTime |
url |
String |
N |
查询通话开始时间 格式:2020-10-10 10:00:00 |
endTime |
url |
String |
N |
查询通话结束时间 格式:2020-10-10 11:00:00 |
cellphone |
url |
String |
N |
手机号 |
chatType |
url |
int |
N |
呼叫类型 1-外呼,2-呼入 |
pageNum |
url |
int |
N |
页码,默认1 |
pageSize |
url |
int |
N |
分页大小,默认20,最大1000 |
post请求
POST https://{您的专属域名}/outbound/openapi/v2/detail/query?&chatType=2pageNum=1&pageSize=20
Body数据示例:
GET https://{您的专属域名}/outbound/openapi/v2/detail/query?&chatType=2pageNum=1&pageSize=20
返回结果加密
加密方式header
中的encrypted
传值,表示需要对返回结果进行加密,拿到加密后的返回结果,
使用私钥加解密工具进行解密
返回结果
- 需要加密,以下是返回结果加密前的json
- 不需要加密则直接直接返回不加密的结果
OpenAudioRecordResponse
参数 |
类型 |
说明 |
audioRecordCode |
String(32) |
外呼名单编码,长度32位或外部名单code |
sessionId |
String(25) |
会话id |
callStartTime |
long |
开始时间 |
callEndTime |
long |
结束时间 |
callDurationSec |
int |
通话时长,单位秒 |
customerName |
String(20) |
姓名 |
cellphone |
String(11) |
电话 |
callStatus |
int |
拨打状态(1:未拨打 2:等待接听 3:接听中 4:等待重呼 5:未接听 6:拨打失败 7:已接听 8:限制拨打 9:占线 10:用户挂断 11:来的提醒 12:无法接通 13:空号 14:停机 15:关机 16:呼损 17:号码故障 18:线路故障) |
callTimes |
int |
拨打次数 |
manualStatus |
int |
是否转人工 1转人工 0 否 |
taskname |
String(50) |
任务名称 |
taskCode |
String(32) |
任务编码 |
aiTagName |
String(64) |
意向标签 |
extendInfos |
String(1000) |
扩展信息,json串 |
audioLinkUrl |
String |
录音下载地址 |
返回结果示例:
{
"code": "10000",
"message": "请求成功",
"data": [{
"audioRecordCode": "a492e8f048d00bcc723d62719e245546",
"sessionId": null,
"recordId": null,
"recordDate": null,
"callStartTime": 1586331390000,
"callEndTime": null,
"callDurationSec": null,
"customerName": "张三",
"cellphone": "17628041469",
"callStatus": 2,
"callTimes": 1,
"manualStatus": 0,
"taskname": "20201202",
"taskCode": "fbe766f9679360af55cf89871370d3c4",
"tagname": null,
"extendInfos": {
"银行卡": "123",
"授信额度": "3000"
},
"audioLinkUrl": "https://134.175.7.156/public/api/callrecords/audiorid/null?recordDate=null"
}]
}
结果码说明
结果码 |
说明 |
10000 |
请求成功 |
20001 |
请求失败 |
21002 |
认证失败,请重新登录 |
FAQ: