调用UpdateAiCallTask接口更新通信智能体外呼任务-智能联络中心-阿里云-智能联络中心(AICCS)-阿里云帮助中心

更新呼叫任务配置。

接口说明

在更新呼叫任务配置前，请先确保呼叫任务的状态为已停止。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aiccs:UpdateAiCallTask

update

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
TaskName	string	是	任务名称，同一个账号下不允许重复。	测试任务
VirtualNumber	string	否	呼出使用的服务实例。	0537022*****
StartType	string	是	启动方式。取值： IMMEDIATE：立即启动。 SCHEDULE：定时启动。	IMMEDIATE
MissCallRetry	boolean	否	是否开启重试。取值： true：是。 false（默认）：否。	true
CallRetryReason	array	否	失败重试原因。
	string	否	具体重试原因。取值： CALL_REJECTED：拒接。 USER_BUSY：被叫忙。 SUSPEND：停机。 INVALID_NUMBER：空号。 POWERED_OFF：关机。 NETWORK_BUSY：网络忙。 NO_ANSWER：无应答。	CALL_REJECTED
CallRetryTimes	integer	否	重试次数，最大不能超过 3 次。	2
CallRetryInterval	integer	否	重试间隔，单位：分钟，最大不能超过 120 分钟。	25
CallTime	array	是	可呼叫时间。
	string	否	呼叫时间段，格式如下： `{"startTime":"09:00:00","endTime":"10:00:00"}` `startTime`代表开始时间，`endTime`代表结束时间，仅处于这个时间段内的时刻才会发起呼出调度，否则将等待下一个可调度是间段到来。说明根据运营商政策要求，最终执行时间以平台调度为准，您可通过真实号管理查看号码限呼时段。	{"startTime":"09:00:00","endTime":"10:00:00"}
CallableTime	array	否
	string	否
CallDay	array	是	可呼叫日。
	string	否	可呼叫日。取值： MONDAY：周一。 TUESDAY：周二。 WEDNESDAY：周三。 THURSDAY：周四。 FRIDAY：周五。 SATURDAY：周六。 SUNDAY：周天。枚举值： WEDNESDAY : 周三 MONDAY : 周一 THURSDAY : 周四 SUNDAY : 周天 TUESDAY : 周二 FRIDAY : 周五 SATURDAY : 周六	MONDAY
TaskStartTime	integer	否	任务预设的启动时间，时间戳，单位毫秒。StarType 字段为 SCHEDULE 时该字段有效且必填，任务将在该字段设置的时间进行自动启动。	1748923429000
TaskId	string	是	待更新的任务 ID。	1187**************
TaskCps	integer	是	任务并发，最大不超过 500。	57
PhoneType	integer	否	号码类型（创建来源为引擎创建时使用） 0：阿里云号码 1：客户自带线路	0
LineEncoding	string	否	线路编码	JILIANG_*_*_NET
LinePhoneNum	string	否	自带线路号码	152****3120
Source	integer	否	创建来源：取值 0：智能体创建 1：引擎创建	无法修改，不必填写
CallExpireType	integer	否	外呼有效期类型： 0：长期有效； 1：导入后一段时间内有效； 2：截止指定时间有效；	0
CallExpireMinutes	integer	否	外呼明细过期时长（分钟）	10
CallExpireDate	string	否	外呼明细过期日期（具体截止时间）	2026-07-30 20:00:20

返回参数

名称	类型	描述	示例值
	object
AccessDeniedDetail	string	访问被拒绝的详细原因。	None
Message	string	错误信息。仅当返回异常时显示。	参数不合法
RequestId	string	请求 ID。	FCD94A7F-316D-54D1-9BFC-814006CB1C34
Data	boolean	更新结果。取值： true：更新成功。 false：更新失败。	true
Code	string	状态码。	OK
Success	boolean	接口调用是否成功。取值： true：成功。 false：失败。	false

示例

正常返回示例

JSON格式

{
  "AccessDeniedDetail": "None",
  "Message": "参数不合法",
  "RequestId": "FCD94A7F-316D-54D1-9BFC-814006CB1C34",
  "Data": true,
  "Code": "OK",
  "Success": false
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。