Import existing RAM users as contact center agents.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
Instance ID. |
ccc-test |
| RoleId |
string |
Yes |
Role ID. This is the agent's role in the instance after successful import. Roles include administrator, skill group leader, and agent. |
Agent@ccc-test |
| SkillLevelList |
string |
No |
Skill level list for the skill group. This is a JSON array string. Each array element is an object with two fields: skillGroupId and skillLevel. skillGroupId is the ID of the skill group the agent wants to associate with. skillLevel is the agent's skill level in that skill group. The range is 1-10. A smaller value indicates stronger business capability and the ability to handle more calls per unit of time. |
[{"skillGroupId":"skillgroup@ccc-test","skillLevel":5}] |
| RamIdList |
string |
Yes |
List of RAM user IDs to add. |
["28036411123456****","29234301123456****"] |
| WorkMode |
string |
Yes |
Work mode. |
ON_SITE |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| HttpStatusCode |
integer |
HTTP status code. |
200 |
| Data |
string |
Data, import execution ID. |
1ca2b084-6f0a-454b-9851-29768a9a5832 |
| RequestId |
string |
Request ID. |
03C67DAD-EB26-41D8-949D-9B0C470FB716 |
| Code |
string |
Response code. |
OK |
| Message |
string |
Response message. |
无 |
Examples
Success response
JSON format
{
"HttpStatusCode": 200,
"Data": "1ca2b084-6f0a-454b-9851-29768a9a5832\n",
"RequestId": "03C67DAD-EB26-41D8-949D-9B0C470FB716",
"Code": "OK",
"Message": "无"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 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. | |
| 400 | Parameter.Minimum | The parameter %s must be greater than or equal to %s. | |
| 400 | Parameter.Blank | The parameter %s may not be null or blank. | |
| 400 | Parameter.Empty | The parameter %s may not be null or empty. | |
| 404 | NotExists.InstanceId | The specified instance %s does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.