呼叫中心外呼任务
补充自动外呼号码
向指定自动外呼任务补充客户号码,单次最多 1000 条;仅支持未过期且任务周期不大于一周的自动外呼任务,上一次插入未完成时会调用失败。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳,单位秒 | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0=SHA1,1=SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| customerInfo | object[] | 否 | 补充的客户号码列表,最多 1000 条 | |
| └name | string | 否 | 客户姓名 | 张三 |
| └fromTaskDetailId | int64 | 否 | 来源任务明细 ID | 90001 |
| └value | string | 是 | 客户号码;企业开启外呼号码加密时传密文 | 13800000000 |
| └remarks | string | 否 | 备注 | VIP客户 |
| └staffId | int64 | 否 | 指定分配客服 ID | 1001 |
| taskId | int64 | 是 | 外呼任务 ID | 100001 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 业务状态码,200 表示业务成功 | 200 |
| message | string | 响应消息;业务失败时为失败原因 | success |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求参数或内容不合法 |
| 14009 | 请求过于频繁 |
| 14500 | 系统异常或处理超时 |
postEndpoint
/openapi/ipcc/calltaskdetail/addcurl -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": "系统异常或处理超时"
}这篇文档有帮助吗?