調(diào)用CreateUser在指定實例下創(chuàng)建一個新的坐席。
接口說明
創(chuàng)建坐席實際上就是創(chuàng)建一個 RAM 子賬戶，云呼叫中心的坐席與 RAM 子賬戶是相互映射的，所以創(chuàng)建時傳入的參數(shù)就和創(chuàng)建 RAM 賬戶時類似，比如：LoginName 就是 RAM 賬號的登錄名，Email 就是創(chuàng)建 RAM 賬號時預(yù)留的郵箱，該郵箱會接收到帶有 RAM 賬戶初始登錄密碼的郵件。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 實例 ID。 | ccc-test |
| LoginName | string | 是 | 坐席登錄名，長度為 4-64 個字符，可包含英文大小寫字母、數(shù)字、英文句點“.”、下劃線“_”或短劃線“-”。 | agent |
| DisplayName | string | 是 | 坐席展示名，長度為 1-128 個字符。 | 坐席小王 |
| Mobile | string | 否 | 坐席的個人電話號碼，該號碼在場外模式下會用到，坐席可以使用該號碼進(jìn)行場外模式接聽。 | 1382114**** |
| string | 是 | 坐席郵箱地址，坐席創(chuàng)建成功后會發(fā)送郵件到該郵箱，郵件中包含呼叫中心登錄地址，以及 RAM 賬戶的用戶名和密碼，請妥善保管。 | username@example.com | |
| WorkMode | string | 是 | 工作模式。 枚舉值：
| ON_SITE |
| RoleId | string | 是 | 角色 ID，格式為：角色@實例 ID，包含三種角色：Admin（管理員）、Manager（技能組組長）、Agent（坐席）。 | Agent@ccc-test |
| SkillLevelList | string | 否 | 技能組的技能等級列表，格式為 JSON 數(shù)組的字符串，數(shù)組元素最大為 100 個，數(shù)組元素是一個對象，包含兩個字段：skillGroupId 和 skillLevel，skillGroupId 填寫要添加的技能組 ID，skillLevel 填寫要添加的技能等級，取值范圍 1-10，值越小，業(yè)務(wù)能力越強，單位時間內(nèi)能處理更多的通話。 | [{"skillGroupId":"skillgroup1@ccc-test","skillLevel":1},{"skillGroupId":"skillgroup2@ccc-test","skillLevel":10}] |
| ResetPassword | boolean | 否 | 首次登錄時是否需要重置密碼，如果為 true，則在首次登錄 RAM 賬戶時會提示重置密碼，否則不提示。默認(rèn)為 false。 | false |
| DisplayId | string | 否 | 坐席的工號，客戶可根據(jù)需要自行設(shè)置。 | 1001 |
| AvatarUrl | string | 否 | 坐席頭像地址。 | http://abc.com/sam.jpg |
| Nickname | string | 否 | 座席昵稱。 | 老王 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "無",
"RequestId": "BA03159C-E808-4FF1-B27E-A61B6E888D7F",
"Data": {
"DisplayName": "坐席小王",
"Extension": "8032****",
"Email": "username@example.com",
"LoginName": "agent",
"WorkMode": "ON_SITE",
"Mobile": "1382114****",
"UserId": "agent@ccc-test",
"AvatarUrl": "http://abc.com/sam.jpg",
"Nickname": "老王。"
},
"Params": [
"無"
]
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.Blank | The parameter %s may not be null or blank. | 該參數(shù)不能為null或含有空白符的字符串。 |
| 400 | Parameter.Enumeration | The parameter %s must be one of the value of enumeration %s. | 該參數(shù)必須為系統(tǒng)限定的枚舉值之一。 |
| 400 | Parameter.Maximum | The parameter %s must be less than or equal to %s. | 參數(shù)必須小于或等于系統(tǒng)規(guī)定的最大值。 |
| 403 | Permission.StsToken | You have no permission to access sts token %s. | 您無權(quán)訪問STS Token。 |
| 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. | 呼叫中心實例下已存在指定的用戶。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-12-22 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-11-07 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更、OpenAPI 返回結(jié)構(gòu)發(fā)生變更 | 查看變更詳情 |
| 2021-12-21 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |