调用ListUsers获取呼叫中心实例中的所有用户。

需要提供角色,技能组,技能级别,以及按需提供用户详细信息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListUsers

系统规定参数。取值:ListUsers

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

待获取用户的呼叫中心实例ID

PageNumber Integer 1

分页序号

PageSize Integer 2

分页大小

返回数据

名称 类型 示例值 描述
Code String OK

响应码

HttpStatusCode Integer 200

HTTP状态码

Message String

响应信息

RequestId String 707EF054-E614-4A4A-98D4-F4457073F111

请求ID

Success Boolean true

是否成功

Users

获取到的呼叫中心实例中的用户列表

List

对象列表

User

对象列表

Detail

用户详细信息。

Department String IT

所属部门

DisplayName String 王明

用户的全名

Email String 18866668888@163.com

用户的电子邮件地址

LoginName String user05

用户登陆名

Phone String 18866668888

用户的电话号码

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

用户所归属的呼叫中心实例ID

Primary Boolean false

是否为主账户

PrivateOutboundNumberId String a08d255e-12a5-48f8-93e0-6b8e1b6dec5a

个人外呼号码的PhoneNumberId

RamId String 293032931468912519

用户所对应的RAM子账户ID

Roles

用户的角色列表

Role

用户的角色列表

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

角色所归属的呼叫中心实例ID

RoleDescription String 坐席

角色描述

RoleId String 4c2e158e-ddd9-464a-a3fc-338eca10277c

角色ID,系统自动生成的唯一标示符。

RoleName String AGENT

角色名称

SkillLevels

用户所归属的技能组及相应等级,一个用户可以不属于任何技能组。

SkillLevel

用户所归属的技能组及相应等级,一个用户可以不属于任何技能组。

Level Integer 4

技能级别

Skill

技能

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

技能组所归属的呼叫中心实例ID

SkillGroupDescription String 售后技术支持人员使用

技能组简单描述

SkillGroupId String 0ead7334-83e7-42a0-a5bd-c2ef9f18ef28

技能组唯一ID,系统自动生成的唯一标示符。

SkillGroupName String 售后技术支持技能组

技能组名字,需要在所归属的呼叫中心实例中唯一。

SkillLevelId String 121335

技能级别唯一ID,系统自动生成的唯一标示符。

UserId String b80bd838-a5a5-4ed3-ac9a-30be353d0e52

用户ID,系统自动生成的唯一标示符。

注意这里是RAM子账号在呼叫中心实例的唯一标识并非RamId,即UUID。

PageNumber Integer 1

分页序号

PageSize Integer 2

分页大小

TotalCount Integer 14

对象总数

示例

请求示例


http(s)://ccc.cn-shanghai.aliyuncs.com/?Action=ListUsers
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&PageNumber=1
&PageSize=2
&<公共请求参数>

正常返回示例

XML 格式

<ListUsersResponse>
      <HttpStatusCode>200</HttpStatusCode>
      <Users>
            <PageNumber>1</PageNumber>
            <TotalCount>14</TotalCount>
            <PageSize>2</PageSize>
            <List>
                  <User>
                        <Detail>
                              <Phone></Phone>
                              <Email>293417@alibaba-inc.com</Email>
                              <LoginName>yanle12312321232</LoginName>
                              <Department></Department>
                              <DisplayName>ly0021</DisplayName>
                        </Detail>
                        <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                        <Primary>false</Primary>
                        <UserId>b80bd838-a5a5-4ed3-ac9a-30be353d0e52</UserId>
                        <RamId>293032931468912519</RamId>
                        <SkillLevels>
                              <SkillLevel>
                                    <SkillLevelId>121151</SkillLevelId>
                                    <Skill>
                                          <SkillGroupDescription>售后技术支持人员使用</SkillGroupDescription>
                                          <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                                          <SkillGroupName>售后技术支持技能组</SkillGroupName>
                                          <SkillGroupId>0ead7334-83e7-42a0-a5bd-c2ef9f18ef28</SkillGroupId>
                                    </Skill>
                                    <Level>5</Level>
                              </SkillLevel>
                        </SkillLevels>
                        <Roles>
                              <Role>
                                    <RoleName>AGENT</RoleName>
                                    <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                                    <RoleDescription>坐席</RoleDescription>
                                    <RoleId>4c2e158e-ddd9-464a-a3fc-338eca10277c</RoleId>
                              </Role>
                        </Roles>
                  </User>
                  <User>
                        <Detail>
                              <Phone>18866668888</Phone>
                              <Email>18866668888@163.com</Email>
                              <LoginName>user05</LoginName>
                              <Department></Department>
                              <DisplayName>王明</DisplayName>
                        </Detail>
                        <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                        <Primary>false</Primary>
                        <UserId>6f3e7751-fa61-453f-8057-a2fe9741a387</UserId>
                        <RamId>202254621208793807</RamId>
                        <SkillLevels>
                              <SkillLevel>
                                    <SkillLevelId>121335</SkillLevelId>
                                    <Skill>
                                          <SkillGroupDescription>售后技术支持人员使用</SkillGroupDescription>
                                          <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                                          <SkillGroupName>售后技术支持技能组</SkillGroupName>
                                          <SkillGroupId>0ead7334-83e7-42a0-a5bd-c2ef9f18ef28</SkillGroupId>
                                    </Skill>
                                    <Level>4</Level>
                              </SkillLevel>
                        </SkillLevels>
                        <Roles>
                              <Role>
                                    <RoleName>AGENT</RoleName>
                                    <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                                    <RoleDescription>坐席</RoleDescription>
                                    <RoleId>4c2e158e-ddd9-464a-a3fc-338eca10277c</RoleId>
                              </Role>
                        </Roles>
                  </User>
            </List>
      </Users>
      <RequestId>707EF054-E614-4A4A-98D4-F4457073F111</RequestId>
      <Success>true</Success>
      <Code>OK</Code>
</ListUsersResponse>

JSON 格式

{
	"Users":{
		"PageNumber":1,
		"TotalCount":14,
		"PageSize":2,
		"List":{
			"User":[
				{
					"Detail":{
						"Phone":"",
						"Email":"293417@alibaba-inc.com",
						"LoginName":"yanle12312321232",
						"DisplayName":"ly0021",
						"Department":""
					},
					"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
					"UserId":"b80bd838-a5a5-4ed3-ac9a-30be353d0e52",
					"Primary":false,
					"RamId":"293032931468912519",
					"Roles":{
						"Role":[
							{
								"RoleName":"AGENT",
								"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
								"RoleDescription":"坐席",
								"RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
							}
						]
					},
					"SkillLevels":{
						"SkillLevel":[
							{
								"SkillLevelId":"121151",
								"Skill":{
									"SkillGroupDescription":"售后技术支持人员使用",
									"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
									"SkillGroupName":"售后技术支持技能组",
									"SkillGroupId":"0ead7334-83e7-42a0-a5bd-c2ef9f18ef28"
								},
								"Level":5
							}
						]
					}
				},
				{
					"Detail":{
						"Phone":"18866668888",
						"Email":"18866668888@163.com",
						"LoginName":"user05",
						"DisplayName":"王明",
						"Department":""
					},
					"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
					"UserId":"6f3e7751-fa61-453f-8057-a2fe9741a387",
					"Primary":false,
					"RamId":"202254621208793807",
					"Roles":{
						"Role":[
							{
								"RoleName":"AGENT",
								"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
								"RoleDescription":"坐席",
								"RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
							}
						]
					},
					"SkillLevels":{
						"SkillLevel":[
							{
								"SkillLevelId":"121335",
								"Skill":{
									"SkillGroupDescription":"售后技术支持人员使用",
									"InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
									"SkillGroupName":"售后技术支持技能组",
									"SkillGroupId":"0ead7334-83e7-42a0-a5bd-c2ef9f18ef28"
								},
								"Level":4
							}
						]
					}
				}
			]
		}
	},
	"HttpStatusCode":200,
	"RequestId":"707EF054-E614-4A4A-98D4-F4457073F111",
	"Success":true,
	"Code":"OK"
}

错误码

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