七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
呼叫中心外呼任务

查询外呼任务列表

按开始时间范围分页查询企业外呼任务列表。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳,单位秒
checksumstring是请求签名校验和
checksumAlgorithmint32否签名算法:0=SHA1,1=SHA256

请求体

名称类型必填描述示例值
pageSizeint32否每页条数;不传默认 50,最大值由 YCC 配置 openapi.ipcc.calltask.list.maxPageSize 控制50
startTimeint64是查询开始时间,毫秒时间戳1719763200000
pageint32否当前页码,从 1 开始;不传默认 11
endTimeint64是查询结束时间,毫秒时间戳;必须大于 startTime,时间跨度默认不得超过 366 天1719849599000

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示成功200
dataobject
└totalPagesint32总页数3
└pageSizeint32每页条数50
└listobject[]外呼任务列表
└namestring外呼任务名称6月客户回访任务
└forecastTypeint32外呼任务类型:0=预览式(手动外呼),1=预测式(自动外呼)0
└bizStatusint32外呼任务业务状态:0=未开始,1=进行中,2=已完成,3=延期未完成,4=延期完成,5=暂停,6=待分配1
└taskIdint64外呼任务 ID100001
└descstring外呼任务描述客户回访名单
└pageNumint32当前页码,从 1 开始1
└totalElementsint64总条数128
messagestring响应消息success

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数或内容不合法
14009请求过于频繁
14500系统异常或处理超时
postEndpoint
/openapi/ipcc/calltask/list
POST
/openapi/ipcc/calltask/list
curl -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": "系统异常或处理超时"
}

这篇文档有帮助吗?