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

获取外呼任务详情

按外呼任务 ID 查询自动或手动外呼任务的基础信息和执行统计;同一企业查询间隔不小于一分钟。

请求参数

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

请求体

名称类型必填描述示例值
taskIdint64是外呼任务 ID100001

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示业务成功200
dataobject
└answerCountint32接通数量52
└namestring任务名称6月客户回访
└startTimeint64开始时间,毫秒时间戳1719763200000
└forecastTypeint32外呼任务类型:0=手动外呼,1=自动外呼0
└endTimeint64结束时间,毫秒时间戳1719849599000
└bizStatusint32业务状态1
└exeCountint32执行数量80
└customCountint32客户数量128
└statusint32任务状态1
└staffCountint32客服数量5
└seatNamesstring坐席名称张三,李四
└descstring任务描述回访近期咨询客户
messagestring响应消息;业务失败时为失败原因success

错误码

状态码描述
12001查询过于频繁
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数或内容不合法
14009请求过于频繁
14500系统异常或处理超时
postEndpoint
/openapi/ipcc/calltask/get
POST
/openapi/ipcc/calltask/get
curl -X POST "https://qiyukf.com/openapi/ipcc/calltask/get?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "taskId": 100001  }'
{
  "code": 200,
  "data": {
    "answerCount": 52,
    "name": "6月客户回访",
    "startTime": 1719763200000,
    "forecastType": 0,
    "endTime": 1719849599000,
    "bizStatus": 1,
    "exeCount": 80,
    "customCount": 128,
    "status": 1,
    "staffCount": 5,
    "seatNames": "张三,李四",
    "desc": "回访近期咨询客户"
  },
  "message": "success"
}
{
  "code": 12001,
  "message": "查询过于频繁"
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求参数或内容不合法"
}
{
  "code": 14009,
  "message": "请求过于频繁"
}
{
  "code": 14500,
  "message": "系统异常或处理超时"
}

这篇文档有帮助吗?