修改任务接口
# 1、接口描述
功能说明: 通过此接口可以修改任务
请求地址: https://open-api.soboten.com/apiOpen/v1/job/modify 请求方法: PATCH
# 2、请求头
请求头参数获取详见权限认证
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| appkey | String | 是 | ISV账号信息里获取 |
| timestamp | Long | 是 | 生成验签字段时使用的时间戳 |
| signature | String | 是 | 验签字段,获取方法详见权限认证 |
# 3、输入参数
| 参数名 | 类型 | 是否必须 | 描述 | 示例 |
|---|---|---|---|---|
| concurrencyQuota | Integer | 是 | 并发数 开启一线多并发时可比robotCount大,不开启一线多并发是与robotCount相同(线路类型为手机号的时候可不传) | 10 |
| jobPhoneNumberIdList | List | 是 | 通过外呼线路接口获取tenantPhoneNumberId,当类型是手机号的时候他的size代表并发的个数,当类型非手机号的时候他的size只能是1;如果外呼方式选择的是外呼策略组,则里面内容为外呼策略组的id(size只能为1)可通过获取外呼策略组选择接口获取 | [1,2,3] |
| robotCallJob | Object | 是 | ||
| +robotCallJobId | Long | 是 | 外呼任务ID | 1222 |
| +phoneType | String | 是 | 号码类型 (MOBILE, "手机号码"),(LANDLINE, "线路"), (CALL_POLICY_GROUP, "外呼策略组") | |
| +robotCount | Integer | 是 | AI坐席数 | 10 |
| +name | String | 是 | 任务名称 | 测试API任务 |
| +dailyStartTime | String | 是 | 可拨打开始时间,默认不可以早于9点,可以联系商务同学调整 | 09:00 |
| +dailyEndTime | String | 是 | 可拨打结束时间,默认不可以晚于20点,可以联系商务同学调整 | 20:00 |
| +mode | String | 是 | 任务类型 (AUTO, "自动任务"),(MANUAL, "手动任务"); | AUTO |
| +startTime | String | 自动任务:是/手动任务:否 | 任务开始时间 | "2021-12-22 00:00:00" |
| +endTime | String | 否 | 结束日期, 当天的23:59:59 | "2019-10-10 23:59:59" |
| +isPrior | Boolean | 是 | 是否设置为优先 | true |
| +customerWhiteGroupIds | List | 否 | 白名单分组ids | [1,2] |
| +description | String | 否 | 备注 | 测试 |
| +earlyWarningAlertUsers | List | 否 | 行业预警消息推送人 | [1,2] |
| +riskControlStrategyId | Long | 否 | 风控策略id,可通过风控策略列表接口获取 | 5 有效id大于0,取消时传0,传null不更新 |
| +flashMessageTemplateId | Long | 否 | 外呼前闪信推送,传闪信模板ID | 1024 |
| +inactiveTimeList | List | 否 | 不可拨打时间段列表,最大三个不可拨打时段 | [{"startTime":"12:00", "endTime":"13:00"}] |
| +daysOfWeek | List | 否 | 一周内可拨打的日期 | ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"] |
| +inactiveDateList | List | 否 | 不可拨打日期 | [{"startDate":"2020-01-01", "endDate":"2020-01-03"}] |
| +csStaffGroupId | Long | 话术包含人工介入时必填 | 坐席组id,通过话术API中获取人工介入标识。如果存在人工介入标识,需要传入坐席组Id | 139 |
| +smsAlertLevelCode | List | 否 | 短信推送提醒意向等级编码(意向标签的ID) | [0, 1] |
| +smsTemplateId | Long | 否 | 短信模板id | 10 |
| +smsPushType | String | 否 | 短信发送类型 (DISTINCT_PUSH, "去重发送"),(EVERY_PUSH, "逐通推送") 空值传null不要传空字符串 | |
| +smsPushAnswered | Boolean | 否 | 是否只推送接通的客户 | false |
| +wechatPushConditionList | List | 否 | 微信推送条件 | |
| ++intentLevelCodes | List | 是 | 意向等级 | [0] |
| ++durationThreshold | Integer | 是 | 通话时长 | 10 |
| ++userIds | List | 是 | 微信推送人 | [1875] |
| ++wechatSendMethod | String | 是 | 微信推送方式(SENDTOALL,全推送),(SENDTOONE,单推送),(SENDTONONE 不推送) | SENDTOONE |
| ++transferCustomer | Boolean | 是 | 分配客户给微信推送人 | false |
| +redialSettingList | List | 选择自动重拨时必填 | 重播条件组 | |
| ++redialCondition | Set | 选择自动重拨时必填 | 重拨条件(CALL_LOSS,"呼损客户"),(NO_ANSWER,"无应答"),(BUSY,"忙线中"),(REFUSED,"拒接"),(POWER_OFF,"关机"),(OUT_OF_SERVICE,"停机"),(CAN_NOT_CONNECT,“无法接通“),(FROM_PHONE_ERROR,"主叫欠费"),(SYSTEM_ERROR,"外呼失败") ,(EXTENSION_NUMBER,"分机号错误") ,(CALL_LIMIT,"呼叫受限") | ["CALL_LOSS"] |
| ++redialInterval | Integer | 选择自动重拨时必填 | 重拨间隔(单位分钟 最大值10000) | 6 |
| ++redialTimes | Integer | 选择自动重拨时必填 | 重拨次数(取值范围1~10) | 6 |
| ++redialType | Enum | 否 | 重播方式 默认 NORMAL 首次优先 FIRST_CALL | NORMAL |
| ++connectRedialCondition | List | 否 | 电话接通后需要重拨的意向分类id,如果电话挂断后分析意向结果在该集合内则自动重拨 | [1, 2] |
| +reSendSmsTemplateIds | Array[Long] | 否 | 补发短信模板id列表 | [9755] |
| +enableReSendSms | Boolean | 否 | 短信补发开关 | true |
| +botSmsTemplateId | Long | 否 | 话术短信模板ID | 1023 |
# 4、输出参数
| 参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
| code | Integer | 响应码 | 200 |
| data | Object | null | |
| requestId | String | 请求Id | WYPNOVHI |
| resultMsg | String | 响应说明 | 修改成功 |
| host | String | 业务主机名 | prod-web-7 |
| errorStackTrace | String | 异常堆栈 | null |
# 5、示例
输入示例:
{
"robotCallJob": {
"robotCallJobId": 9795,
"name": "自动重播测试",
"mode": "MANUAL",
"robotCount": 16,
"smsTemplateId": 344,
"phoneType": "LANDLINE",
"dailyStartTime": "09:00",
"dailyEndTime": "23:59",
"inactiveTimeList": [],
"description": "222",
"smsAlertLevelCode": [
0,
1
],
"endTime": null,
"daysOfWeek": [
"WEDNESDAY",
"TUESDAY",
"SATURDAY",
"SUNDAY",
"THURSDAY",
"MONDAY",
"FRIDAY"
],
"earlyWarningAlertUsers": [
2051
],
"redialSettingList": [{
"redialCondition":["CALL_LOSS","NO_ANSWER"],
"redialInterval":30,
"redialTimes":2
}],
"concurrencyQuota": 16,
"wechatPushConditionList": [
{
"intentLevelCodes": [
0
],
"durationThreshold": 30,
"userIds": [
2051
],
"wechatSendMethod": "SENDTOTRANSFER",
"transferCustomer": false
}
],
"tenantCallInterceptId": 0,
"inactiveDateList": [],
"customerWhiteGroupIds": [
2877
],
"csStaffGroupId": null,
"redialType": "NORMAL",
"smsPushAnswered": true,
"flashMessageTemplateId":1024,
"reSendSmsTemplateIds":[9755],
"enableReSendSms":true,
"botSmsTemplateId":1023
},
"concurrencyQuota": 17,
"jobPhoneNumberIdList": [
2788
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
输出示例:
{
"code": 200,
"data": null,
"requestId": "WYPNOVHI",
"resultMsg": "修改成功",
"host": "prod-web-7",
"errorStackTrace": null
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
上次更新: 2026/8/4 16:21:54