UpdateConfigItems - 更新配置项

调用UpdateConfigItems添加或修改指定实例下的配置信息,例如:来电显示是否隐藏号码,呼入场景下是否允许坐席主动挂机等。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceIdstring

实例 ID。

ccc-test
ObjectIdstring

配置信息所属的对象的 ID。

ccc-test
ObjectTypestring

配置信息所属对象的类型。

INSTANCE
ConfigItemsstring

配置项列表,格式为 JSON 数组的字符串,数组元素是一个对象,该对象包含两个字段,name,value,name 是配置项的名称,value 是配置项的值。配置项名称包含系统定义和客户自定义两种,系统定义包括是否允许坐席挂机、是否自动接听、久振未接时长等,这部分配置项名称是固定的,值可以由客户自定义,除此之外,配置项名称也支持客户自定义,客户可以根据需要添加配置项。

枚举值:
  • AllowAudioDownload是否允许坐席下载录音,取值:0(不允许)、1(允许)。
  • RecordingStorageSetting实例录音存储配置。
  • AllowChooseSignedSkillGroup坐席上线前是否手动选择签入的技能组,取值:0(自动签入所属的全部技能组)、1(手动选择签入的技能组)。
  • AgentRingingTimeoutSeconds坐席久振未接超时时长,取值范围为5-90,单位秒。
  • ShowCalledID坐席来电显示,取值:-1(隐藏全部来电号码)、0(隐藏部分来电号码)、1(显示完整来电号码)。
  • ShowCalleeID坐席外呼显示,取值:-1(隐藏全部外呼号码)、0(隐藏部分外呼号码)、1(显示完整外呼号码)。
  • AllowHangup坐席呼入挂机方式,取值:0(不允许坐席挂机)、1(允许坐席挂机)。
  • AutoAnswerCall坐席接听来电方式,取值:-1(手动接听)、n(振铃n秒后接听)。
[{"name":"ShowCalledID","value":"-1"},{"name":"ShowCalleeID","value":"1"},{"name":"AllowHangup","value":"0"},{"name":"AutoAnswerCall","value":"-1"},{"name":"AllowAudioDownload","value":"1"},{"name":"AllowChooseSignedSkillGroup","value":"1"}]

返回参数

名称类型描述示例值
object
Codestring

响应码。

OK
HttpStatusCodeinteger

HTTP 状态码。

200
Messagestring

响应信息。

RequestIdstring

请求 ID。

8E7Y5B39-3E24-4A04-81E6-6C4F5B39DF75
Paramsarray
Paramstring

响应参数。

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "8E7Y5B39-3E24-4A04-81E6-6C4F5B39DF75",
  "Params": [
    "无"
  ]
}

错误码

HTTP status code错误码错误信息描述
400Parameter.EnumerationThe parameter %s must be one of the value of enumeration %s.该参数必须为系统限定的枚举值之一。
404NotExists.InstanceIdThe specified instance %s does not exist.指定的呼叫中心实例不存在。
404NotExists.UserIdThe user %s does not exist in instance %s.呼叫中心实例中不存在指定的用户。

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

变更历史

变更时间变更内容概要操作
2023-11-17OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情