批量重置号码状态 (兼容2.0任务重置号码状态)
请求接口
agent-api/user/{user_id}/task/{task_id}/number-batch-reset
请求方式
PUT
路由参数
参数
类型
示例
解释
是否必填
user_id
string
4d99d91c-f5d9-49da-88da-758977cc58a9
用户id
是
task_id
string
b15b7392-a83f-4e0e-9570-31dd2ec8f85c
任务id
是
注意:如果使用2.0 任务id ,需暂停任务才可以重置号码状态 否则 会出现以下报错
{
"code": 422,
"status": "error",
"message": "任务正在拨打中,请先暂停任务",
"data": []
}
2
3
4
5
6
请求参数
参数
类型
示例
解释
必填
keyword
string
18365474148
号码
否
phones
array
[“13073797565”,“18565891012”]
需要重呼的号码,数组中的号码请传字符串类型 可开启加密
否
start_at
string
2020-07-28
创建开始时间
否
end_at
string
2020-07-28
创建开结束时间(和start_at同时存在)
否
status
array
[0,2]
筛选你所需要重置的号码的状态,数组中为0-12的数字,代表的含义分别是 0等待呼叫 1呼叫成功 2运营商拦截 3拒接 4无应答、无人接听 5空号 6关机 7停机 8占线、用户正忙 9呼入限制 10欠费 11黑名单 12 用户屏蔽
否
encryption
bool
false
是否加密号码(开启接口加密后有效)
否
is_new_task
bool
false
是否是2.0 任务(传递true 将重置2.0 任务号码状态)
否
请求示例
{ "is_new_task":true "keyword":"13934373090", "phones":[ "13934373090" ], "start_at":"2020-07-28 10:00:00", "end_at":"2020-07-28 23:59:59", "status":[0,2] }
1plaintext
2
3
4
5
6
7
8
9
10返回数据
{ "code": 200, "status": "success", "message": "批量重置号码成功" }
1plaintext
2
3
4
5