状态报告获取
提交方式：
接口数据输入输出均采用JSON格式封装的字符串，编码（对整个请求的字符串编码）统一为UTF-8，采用post方式提交请求
功能:
指用户主动向大汉三通语音平台获取语音外呼状态报告
请求参数:
参数值说明：以下json内容为提交请求数据格式
{
"account":"dh****",
"password":"0243614f784a8cfa94a94b85cbee7540"
}
| 参数名 | 说明 |
|---|---|
| account | 用户账号,必填 |
| password | 账号密码，需采用MD5加密(32位小写) |
返回示例:
{
"result":"DH:0000",
"desc":"成功",
"data":[{
"msgid":"99e4d62ca31c4270a920e31d8bf08d20",
"duration":0,
"callee":"13056525567",
"calledtimes":1,
"status":"DH:0001",
"desc":"被叫忙【占线或繁忙】",
"presskeys":"无",
"reporttime":"2020-09-08 14:17:59",
"starttime":"2020-09-08 14:17:27",
"ringingtimelong":"32",
"params":{"param1":"value1","param2":"value2"}
},{
"msgid":"ba860dc438cf2c44984ac88e2264a394",
"duration":123,
"callee":"19945711234,18601714321",
"calledtimes":1,
"status":"DH:0000",
"desc":"呼叫成功",
"presskeys":"无",
"reporttime":"2020-09-08 13:52:57",
"recordurl":"http://oss-radio.oss-cn-hangzhou.aliyuncs.com/20200908/80fc2fd3411e43cdbe13b417fa2d317e.mp3?Expires\u003d1602136384\u0026OSSAccessKeyId\u003dLTAIWClG7juTTAk5\u0026Signature\u003dN9R32hUji7IKix4u%2FHGSmp%2BsyLU%3D",
"starttime":"2016-05-11 13:12:11",
"answertime":"2016-05-11 13:12:11",
"ringingtimeLong":"10"
}]
}
示例解释：该示例表示客户向语音平台请求获取状态报告，请求处理成功，并获取到两条外呼语音消息状态报告，其中一条显示其呼叫无人应答，另一条成功外呼。
返回参数说明:
| result | 约束 | 说明 |
|---|---|---|
| result | 必须（String） | 请求结果；说明请参照：提交响应码 |
| desc | 可选（String） | 描述 |
| 下列为具体状态报告内容参数（0-200条）： | ||
| msgid | 必须（String） | 消息ID |
| callid | 必须（String） | 隐号通话，话单唯一ID |
| callee | 必须（String） | 被叫号码（如果是隐号通话此处为2个号码，以英文逗号分隔，例：A,B） |
| status | 必须（String） | 外呼状态码；说明请参照：呼叫状态码 |
| duration | 可选（String） | 通话时长。单位为秒 |
| phoneX | 可选（String） | 小号号码 |
| phoneXx | 可选（String） | AXxYB模式下的小号分机号 |
| calltype | 可选（String） | 呼叫类型： 10：通话主叫 11：通话被叫 12：XYB-短信发送；AXxYB-收号呼叫 13：短信接收 20：呼叫不允许 21: 未开户不允许 30：短信不允许 31：转接短信 126: 双呼 |
| calledtimes | 可选（int） | 最终实际呼叫总次数。如果没有失败重呼，则值为1，表示只呼叫了一次 |
| releasedir | 可选（String） | 释放方向: 0 表示平台释放，1 表示主叫释放，2 表示被叫释放 |
| presskeys | 可选（String） | 用户的按键信息 |
| starttime | 可选（String） | 发起呼叫时间。一般指实际呼叫发起的时间。"yyyy-MM-ddHH:mm:ss" |
| answertime | 可选（String） | 通话开始时间。一般指实际通话开始的时间。"yyyy-MM-ddHH:mm:ss" |
| reporttime | 可选（String） | 状态报告时间。一般指实际呼叫结束的时间。"yyyy-MM-ddHH:mm:ss" |
| ringingtimeLong | 可选（int） | 振铃时长(秒) |
| recordurl | 可选（String） | 隐号通话录音文件下载路径，路径有效时间72小时 |
| params | 可选（Map对象） | 终端客户自定义参数params（总长度限制为1000） |
文档更新时间: 2024-08-28 09:08 作者：夏亮
