查询自动外呼和智能外呼的通话记录(V1.0.0)
场景描述
查询自动外呼和智能外呼的通话记录。
本接口只能查询AICC 22.100.0及后续版本产生的呼叫的通话记录。
接口方法
POST
接口URL
https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/callRecord。
其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。
| 参数名 | 数据类型 | 选取原则 | 说明 |
|---|---|---|---|
| vdnId | int | 必选 | 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。 |
请求说明
| 序号 | 名称 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|---|
| 1 | Authorization | string | True | 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
| 2 | Content-Type | string | True | 固定填 application/json; charset=UTF-8。 |
| 3 | locale | String | False | i18n(internationalization,国际语言代码),如zh_CN表示中文、en_US表示英文等,默认zh_CN。 |
响应说明
- 响应状态码: 200
表4 响应体参数 序号
名称
参数类型
是否必选
说明
1
resultCode
String
True
原因码。0200000表示成功,其他表示失败。
错误码请参考表5。
2
recordList
List
false
通话记录。
2.1
interNo
string
True
内部序号
2.2
systemReply
string
True
系统回复。
系统回复为IVR流程或智能IVR流程中的语音文件时,语音文件有杂音或为音乐将会无法准确转写为文本信息。
语音文件或TTS文本在通话过程中如果被打断无法播放完整,查询出来的系统回复也会是完整的语音文件内容。
2.3
userSaying
string
True
用户回复
2.4
intention
string
True
用户意图
2.5
systemReplyTime
string
True
系统回复时间
2.6
requestTime
string
True
用户请求时间
2.7
responseSource
string
True
回复来自机器人还是静默座席。
机器人--0,静默座席--1
3
resultDesc
String
true
返回描述信息
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值
错误码
| 序号 | 错误码 | 说明 |
|---|---|---|
| 1 | 0200001 | 参数异常,异常详情在resultDesc中描述。 |
| 2 | 02000001 | 参数值为空 |
| 3 | 02000002 | 参数包含非法字符 |
| 4 | 02000003 | 参数长度不能大于规定长度 |
| 5 | 02000004 | 参数长度不能小于规定长度 |
| 6 | 02000005 | 参数长度需要介于规定长度之间 |
| 7 | 02000006 | 参数值类型不正确 |
| 8 | 02000007 | 参数值大小不正确 |
| 9 | 02000008 | 参数转换异常,请检查请求参数 |
| 10 | 02000009 | 参数组合不正确,请检查请求参数 |
| 11 | 02000010 | hour和minute必须同时存在 |
| 12 | 02000011 | 参数个数不能大于规定个数 |
报文样例
请求头:
Content-Type:application/json;charset=UTF-8 Authorization:XXXXXXXXXXXXXXXXXXXXXXX
请求参数:
{
"callId" : "1688028889-836"
} {
"returnCode": "0200000",
"recordList": [
{
"interNo": "1",
"userSaying": null,
"systemReply": "啊您看我们请专门负责的同事和您简要介绍一下展会亮点您看可以吗只要和外贸相关的企业对于我们展会都会有兴趣的",
"intention": null,
"systemReplyTime": "2022-05-31 20:13:08",
"requestTime": "2022-05-31 20:13:10",
"responseSource": "0"
},
{
"interNo": "2",
"userSaying": "null",
"systemReply": "您好,欢迎使用智能机器人",
"intention": null,
"systemReplyTime": "2022-05-31 20:13:08",
"requestTime": "2022-05-31 20:13:08",
"responseSource": "0"
}
],
"resultCode": "0200000",
"resultDesc": "success",
"returnDesc": "success"
}