开发者文档 开发者文档
帮助中心 (opens new window)
帮助中心 (opens new window)
  • 呼叫中心V7

  • 外呼机器人V5
  • 电销中心

  • 行业语音 Agents

    • 权限认证
    • 基础信息接口

    • 短信平台接口

    • 风控策略接口

    • AI引擎接口

    • 回调接口

    • AI外呼接口

      • 外呼场景调用流程说明
      • 任务操作接口

        • 新增任务接口
        • 启动任务接口
        • 暂停任务接口
        • 修改任务接口
          • 1、接口描述
          • 2、请求头
          • 3、输入参数
          • 4、输出参数
          • 5、示例
        • 删除任务接口
        • 终止任务接口
        • 检查所有任务
        • 异步导入客户到外呼任务接口
        • 执行(开始,暂停)所有任务
      • 任务信息查询接口

      • 任务完成电话信息查询接口

      • 通话统计接口

      • 通话计费接口

  • 语音类产品 API
  • 行业语音 Agents
  • AI外呼接口
  • 任务操作接口
智齿科技
2026-08-04
目录

修改任务接口

# 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

输出示例:

{
	"code": 200,
	"data": null,
	"requestId": "WYPNOVHI",
	"resultMsg": "修改成功",
	"host": "prod-web-7",
	"errorStackTrace": null
}
1
2
3
4
5
6
7
8
上次更新: 2026/8/4 16:21:54

← 暂停任务接口 删除任务接口→

最近更新
01
权限认证
08-04
02
短信接收结果回调
08-04
03
外呼场景调用流程说明
08-04
更多文章>
Theme by Vdoing
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式