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

获取外呼任务明细详情列表

按外呼任务 ID 分页查询任务号码明细,默认按 page 翻页;传 lastId 时按游标方式翻页,文档建议每页不超过 2000 条。

请求参数

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

请求体

名称类型必填描述示例值
lastIdint64否上一页最后一条明细 ID;传入后按游标方式翻页90001
pageint32否页码;不传默认 1。传 lastId 时进入游标翻页模式1
taskIdint64是外呼任务 ID100001

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示业务成功200
dataobject
└totalint32总条数128
└dataobject[]任务明细列表
└callOutDurationint64外呼通话时长,单位秒120
└staffNamestring分配客服名称李四
└callCountint32呼叫次数2
└idint64明细 ID90001
└sessionIdint64关联会话 ID10000001
└callResultstring呼叫结果:未呼叫、未接通、已接通已接通
└guestNumberstring客户号码;企业开启外呼号码加密时返回密文13800000000
└taskIdint64任务 ID100001
└remarksstring备注客户上午方便接听
└guestNamestring客户姓名张三
└hasMoreboolean是否还有下一页;游标翻页模式返回true
└lastIdint64当前页最后一条明细 ID;游标翻页模式返回90099
messagestring响应消息;业务失败时为失败原因success

错误码

状态码描述
12001查询过于频繁
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数或内容不合法
14009请求过于频繁
14500系统异常或处理超时
postEndpoint
/openapi/ipcc/calltaskdetail/get
POST
/openapi/ipcc/calltaskdetail/get
curl -X POST "https://qiyukf.com/openapi/ipcc/calltaskdetail/get?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "page": 1,    "taskId": 100001  }'
{
  "code": 200,
  "data": {
    "total": 128,
    "data": [
      {
        "callOutDuration": 120,
        "staffName": "李四",
        "callCount": 2,
        "id": 90001,
        "sessionId": 10000001,
        "callResult": "已接通",
        "guestNumber": "13800000000",
        "taskId": 100001,
        "remarks": "客户上午方便接听",
        "guestName": "张三"
      }
    ],
    "hasMore": true,
    "lastId": 90099
  },
  "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": "系统异常或处理超时"
}

这篇文档有帮助吗?