CreateUser_云联络中心_API文档

2020-07-01

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

创建坐席实际上就是创建一个 RAM 子账户，云联络中心的坐席与 RAM 子账户是相互映射的，所以创建时传入的参数就和创建 RAM 账户时类似，比如：LoginName 就是 RAM 账号的登录名，Email 就是创建 RAM 账号时预留的邮箱，该邮箱会接收到带有 RAM 账户初始登录密码的邮件。

流控信息

请求速率为100/1(s)。更多流控信息，请前往配额中心查看

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称	字段详情
InstanceIdstring	实例 ID。示例值:ccc-test参考取值来源: ListInstances
LoginNamestring	坐席登录名，长度为 4-64 个字符，可包含英文大小写字母、数字、英文句点“.”、下划线“_”或短划线“-”。示例值:agent
DisplayNamestring	坐席展示名，长度为 1-128 个字符。示例值:坐席小王字符长度 <= 500字符长度 >= 0
Mobilestring	坐席的个人电话号码，该号码在场外模式下会用到，坐席可以使用该号码进行场外模式接听。示例值:1382114****
Emailstring	坐席邮箱地址，坐席创建成功后会发送邮件到该邮箱，邮件中包含云联络中心登录地址，以及 RAM 账户的用户名和密码，请妥善保管。示例值:username@example.com
WorkModestring	工作模式。示例值:ON_SITE枚举值:ON_SITEOFF_SITEOFFICE_PHONE参考取值来源: ChangeWorkMode
RoleIdstring	角色 ID，格式为：角色@实例 ID，包含三种角色：Admin（管理员）、Manager（技能组组长）、Agent（坐席）。示例值:Agent@ccc-test参考取值来源: ListRoles
SkillLevelListstring	技能组的技能等级列表，格式为 JSON 数组的字符串，数组元素最大为 100 个，数组元素是一个对象，包含两个字段：skillGroupId 和 skillLevel，skillGroupId 填写要添加的技能组 ID，skillLevel 填写要添加的技能等级，取值范围 1-10，值越小，业务能力越强，单位时间内能处理更多的通话。示例值:[{"skillGroupId":"skillgroup1@ccc-test","skillLevel":1},{"skillGroupId":"skillgroup2@ccc-test","skillLevel":10}]
ResetPasswordboolean	首次登录时是否需要重置密码，如果为 true，则在首次登录 RAM 账户时会提示重置密码，否则不提示。默认为 false。示例值:false
DisplayIdstring	坐席的工号，客户可根据需要自行设置。示例值:1001
AvatarUrlstring	坐席头像地址。示例值:http://abc.com/sam.jpg
Nicknamestring	座席昵称。示例值:老王

返回参数

字段名称	字段详情
Codestring	响应码。示例值:OK
HttpStatusCodeinteger<int32>	HTTP 状态码。示例值:200
Messagestring	响应信息。示例值:无
RequestIdstring	请求 ID。示例值:BA03159C-E808-4FF1-B27E-A61B6E888D7F
Dataobject	数据。
Paramsarray<string>	响应参数。

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	Parameter.Blank	The parameter %s may not be null or blank.	诊断
400	Parameter.Enumeration	The parameter %s must be one of the value of enumeration %s.	诊断
400	Parameter.Maximum	The parameter %s must be less than or equal to %s.	诊断
403	Permission.StsToken	You have no permission to access sts token %s.	诊断
404	NotExists.InstanceId	The specified instance %s does not exist.	诊断
404	NotExists.RoleId	Role %s does not exist.	诊断
409	AlreadyExists.User	User %s already exists in instance %s.	诊断

变更历史

	变更时间	变更内容概要	操作
	2023-12-22	变更请求参数WorkMode
	2023-11-07	新增请求参数AvatarUrl 新增请求参数Nickname 变更返回参数
	2021-12-21	新增请求参数DisplayId

相关示例