# 查询自动外呼和智能外呼的通话记录（V1.0.0）
#### 场景描述
查询自动外呼和智能外呼的通话记录。
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png)
本接口只能查询AICC 22.100.0及后续版本产生的呼叫的通话记录。
#### 接口方法
POST
#### 接口URL
https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/callRecord。
其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。
表1URL中携带的参数说明 
| 参数名   | 数据类型 | 选取原则 | 说明                                                                                                                                      |
|:---|:---|:---|:---|
| vdnId | int  | 必选   | 虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。 |
   
#### 请求说明
表2请求头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | Authorization | string | True  | 生成方式参见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 |
| 2  | Content-Type  | string | True  | 固定填 application/json; charset=UTF-8。                                                                                          |
| 3  | locale        | String | False | i18n（internationalization，国际语言代码），如zh_CN表示中文、en_US表示英文等，默认zh_CN。                                                              |
   
表3请求体参数 
| 序号 | 名称     | 参数类型   | 是否必选 | 说明                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|:---|
| 1  | callId | String | true | 通话记录ID，用于与CTI平台的话单等通话数据关联。通过[查询外呼结果](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0783.html#ZH-CN_TOPIC_0000002481113908)或者[外呼结果回调接口](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0788.html#ZH-CN_TOPIC_0000002481273874)中返回的callId字段获取。 |
   
#### 响应说明
- **响应状态码: 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**
  业务失败：请依次确认您请求中各参数的取值
  
 
#### 错误码
 表5错误原因码说明 
| 序号 | 错误码      | 说明                       |
|:---|:---|:---|
| 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"
}
```