文档

AssignUsers - 导入多个坐席

更新时间:
目前该API接口已标记为弃用,推荐使用替代API:CCC(2020-07-01) - ImportRamUsers

调用AssignUsers将一个或多个RAM账户导入到指定实例中,成功导入后,RAM账户将以坐席的形式存在于实例中。

接口说明

拥有 RAM 权限的账号可以到 RAM 控制台查询阿里云主账号下管理的所有 RAM 子账号,RAM 控制台地址:https://ram.console.aliyun.com/users

调试

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

授权信息

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

请求参数

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

实例 ID。

ccc-test
RoleIdstring

角色 ID,坐席导入成功后在实例中的角色,包括管理员、技能组组长和坐席三种角色。

Agent@ccc-test
SkillLevelListstring

技能组的技能等级列表,格式为 JSON 数组的字符串,数组元素是一个对象,包含两个字段:skillGroupId 和 skillLevel,skillGroupId 填写坐席想要关联的技能组 ID,skillLevel 填写坐席在该技能组的技能等级,取值范围 1-10,值越小,业务能力越强,单位时间内能处理更多的通话。

[{"skillGroupId":"skillgroup@ccc-test","skillLevel":5}]
RamIdListstring

待添加的 RAM 用户 ID 列表。

["28036411123456****","29234301123456****"]
WorkModestring

工作模式。

枚举值:
  • ON_SITE场内模式
  • OFF_SITE场外模式
  • OFFICE_PHONE办公电话模式
ON_SITE

返回参数

名称类型描述示例值
object
HttpStatusCodeinteger

HTTP 状态码。

200
Datastring

数据,内容与工作流 ID 相同。

1ca2b084-6f0a-454b-9851-29768a9a5832
RequestIdstring

请求 ID。

EEEE671A-3E24-4A04-81E6-6C4F5B39DF75
Codestring

响应码。

OK
WorkflowIdstring

工作流 ID。

1ca2b084-6f0a-454b-9851-29768a9a5832
Messagestring

响应信息。

示例

正常返回示例

JSON格式

{
  "HttpStatusCode": 200,
  "Data": "1ca2b084-6f0a-454b-9851-29768a9a5832",
  "RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
  "Code": "OK",
  "WorkflowId": "1ca2b084-6f0a-454b-9851-29768a9a5832",
  "Message": "无"
}

错误码

HTTP status code错误码错误信息描述
400Parameter.EnumerationThe parameter %s must be one of the value of enumeration %s.该参数必须为系统限定的枚举值之一。
400Parameter.MaximumThe parameter %s must be less than or equal to %s.参数必须小于或等于系统规定的最大值。
400Parameter.MinimumThe parameter %s must be greater than or equal to %s.参数必须大于或等于系统规定的最小值。
400Parameter.BlankThe parameter %s may not be null or blank.该参数不能为null或含有空白符的字符串。
400Parameter.EmptyThe parameter %s may not be null or empty.该参数不能为null值或为空字符串。
404NotExists.InstanceIdThe specified instance %s does not exist.指定的呼叫中心实例不存在。

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