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

补充自动外呼号码

向指定自动外呼任务补充客户号码,单次最多 1000 条;仅支持未过期且任务周期不大于一周的自动外呼任务,上一次插入未完成时会调用失败。

请求参数

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

请求体

名称类型必填描述示例值
customerInfoobject[]否补充的客户号码列表,最多 1000 条
└namestring否客户姓名张三
└fromTaskDetailIdint64否来源任务明细 ID90001
└valuestring是客户号码;企业开启外呼号码加密时传密文13800000000
└remarksstring否备注VIP客户
└staffIdint64否指定分配客服 ID1001
taskIdint64是外呼任务 ID100001

返回参数

名称类型描述示例值
codeint32业务状态码,200 表示业务成功200
messagestring响应消息;业务失败时为失败原因success

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求参数或内容不合法
14009请求过于频繁
14500系统异常或处理超时
postEndpoint
/openapi/ipcc/calltaskdetail/add
POST
/openapi/ipcc/calltaskdetail/add
curl -X POST "https://qiyukf.com/openapi/ipcc/calltaskdetail/add?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{    "customerInfo": [      {        "name": "张三",        "value": "13800000000",        "remarks": "VIP客户"      }    ],    "taskId": 100001  }'
{
  "code": 200,
  "message": "success"
}
{
  "code": 14001,
  "message": "AppKey 不存在"
}
{
  "code": 14002,
  "message": "checksum 校验失败"
}
{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}
{
  "code": 14004,
  "message": "请求参数或内容不合法"
}
{
  "code": 14009,
  "message": "请求过于频繁"
}
{
  "code": 14500,
  "message": "系统异常或处理超时"
}

这篇文档有帮助吗?