呼叫中心外呼任务
查询外呼任务列表
按开始时间范围分页查询企业外呼任务列表。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳,单位秒 | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0=SHA1,1=SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| pageSize | int32 | 否 | 每页条数;不传默认 50,最大值由 YCC 配置 openapi.ipcc.calltask.list.maxPageSize 控制 | 50 |
| startTime | int64 | 是 | 查询开始时间,毫秒时间戳 | 1719763200000 |
| page | int32 | 否 | 当前页码,从 1 开始;不传默认 1 | 1 |
| endTime | int64 | 是 | 查询结束时间,毫秒时间戳;必须大于 startTime,时间跨度默认不得超过 366 天 | 1719849599000 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务状态码,200 表示成功 | 200 |
| data | object | ||
| └totalPages | int32 | 总页数 | 3 |
| └pageSize | int32 | 每页条数 | 50 |
| └list | object[] | 外呼任务列表 | |
| └name | string | 外呼任务名称 | 6月客户回访任务 |
| └forecastType | int32 | 外呼任务类型:0=预览式(手动外呼),1=预测式(自动外呼) | 0 |
| └bizStatus | int32 | 外呼任务业务状态:0=未开始,1=进行中,2=已完成,3=延期未完成,4=延期完成,5=暂停,6=待分配 | 1 |
| └taskId | int64 | 外呼任务 ID | 100001 |
| └desc | string | 外呼任务描述 | 客户回访名单 |
| └pageNum | int32 | 当前页码,从 1 开始 | 1 |
| └totalElements | int64 | 总条数 | 128 |
| message | string | 响应消息 | success |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求参数或内容不合法 |
| 14009 | 请求过于频繁 |
| 14500 | 系统异常或处理超时 |
postEndpoint
/openapi/ipcc/calltask/listcurl -X POST "https://qiyukf.com/openapi/ipcc/calltask/list?appKey=string&time=0&checksum=string" \ -H "Content-Type: application/json" \ -d '{ "pageSize": 50, "startTime": 1719763200000, "endTime": 1719849599000, "page": 1 }'{
"code": 200,
"data": {
"totalPages": 3,
"pageSize": 50,
"list": [
{
"name": "6月客户回访任务",
"forecastType": 0,
"bizStatus": 1,
"taskId": 100001,
"desc": "客户回访名单"
}
],
"pageNum": 1,
"totalElements": 128
},
"message": "success"
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求参数或内容不合法"
}{
"code": 14009,
"message": "请求过于频繁"
}{
"code": 14500,
"message": "系统异常或处理超时"
}这篇文档有帮助吗?