手机号查询外呼记录
服务描述
本接口可用于查询指定手机号码近3月拨打记录
开发须知
调用本接口前,请先获取appId
服务地址
GET/POST https://{您的专属域名}/outbound/openapi/v2/detail/cellphone?cellphone={cellphone}
请求参数
参数 | 位置 | 类型 | 是否必填 | 说明 |
---|---|---|---|---|
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 |
cellphone | url | String | Y | 手机号码 |
post请求
POST https://{您的专属域名}/outbound/openapi/v2/detail/cellphone?cellphone=13410011001
Body数据示例:
GET https://{您的专属域名}/outbound/openapi/v2/detail/cellphone?cellphone=13410011001
返回结果加密
加密方式
header
中的encrypted
传值,表示需要对返回结果进行加密,拿到加密后的返回结果, 使用私钥加解密工具进行解密
返回结果
- 需要加密,以下是返回结果加密前的json
- 不需要加密则直接直接返回不加密的结果
参数 | 类型 | 说明 |
---|---|---|
code | String | 结果码 |
message | String | 结果描述 |
data | List<OpenAudioRecordResponse> | 拨打记录 |
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 | 认证失败,请重新登录 |