调用ListUsersOfSkillGroup获取一个技能组的用户列表。

调试

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

请求参数

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

系统规定参数。取值:ListUsersOfSkillGroup

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

待获取用户列表的技能组所属呼叫中心实例ID

PageNumber Integer 1

分页序号

PageSize Integer 5

分页大小

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

待获取用户列表的技能组ID

返回数据

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

响应码

HttpStatusCode Integer 200

HTTP状态码

Message String

响应信息

RequestId String C0628E65-1D39-4C26-9AF8-E64775D4BE0F

请求ID

Success Boolean true

是否成功

Users Struct

获取到的一个技能组的所有用户

List Array of User

对象列表

User
Detail Struct

用户详细信息

Department String IT

所属部门

DisplayName String 馨言

用户的全名

Email String 1783922****@163.com

用户的电子邮件地址

LoginName String xinyan

用户登陆名

Phone String 12345****

用户的电话号码

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

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

RamId String 20643462717516xxxx

用户所对应的RAM账户ID

Roles Array of Role

用户的角色列表

Role
InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb3xxxx

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

Privileges Array of Privilege

角色权限列表

Privilege
PrivilegeDescription String xxx

权限描述

PrivilegeId String xxx

权限ID,系统自动生成的唯一标示符。

PrivilegeName String xxx

权限名称,需要唯一。

RoleDescription String 坐席

角色描述

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

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

RoleName String AGENT

角色名称

UserCount Integer 0

拥有该角色的用户的数量

SkillLevels Array of SkillLevel

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

SkillLevel
Level Integer 4

技能级别

Skill Struct

技能

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

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

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

技能组简单描述

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

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

SkillGroupName String 售后技术支持技能组

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

SkillLevelId String 121131

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

UserId String 8b33d247-128c-4013-b79d-ec11a6a8xxxx

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

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

PageNumber Integer 1

分页序号

PageSize Integer 5

分页大小

TotalCount Integer 2

对象总数

示例

请求示例

http(s)://[Endpoint]/?Action=ListUsersOfSkillGroup
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb3xxxx
&PageNumber=1
&PageSize=5
&SkillGroupId=0ead7334-83e7-42a0-a5bd-c2ef9f18xxxx
&<公共请求参数>

正常返回示例

XML格式

<Message>无</Message>
<RequestId>C0628E65-1D39-4C26-9AF8-E64775D4BE0F</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Users>
    <TotalCount>2</TotalCount>
    <PageSize>5</PageSize>
    <PageNumber>1</PageNumber>
    <List>
        <User>
            <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb3xxxx</InstanceId>
            <UserId>8b33d247-128c-4013-b79d-ec11a6a8xxxx</UserId>
            <RamId>20643462717516xxxx</RamId>
            <SkillLevels>
                <SkillLevel>
                    <SkillLevelId>121131</SkillLevelId>
                    <Level>4</Level>
                    <Skill>
                        <SkillGroupName>售后技术支持技能组</SkillGroupName>
                        <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb3xxxx</InstanceId>
                        <SkillGroupId>0ead7334-83e7-42a0-a5bd-c2ef9f18xxxx</SkillGroupId>
                        <SkillGroupDescription>售后技术支持人员使用</SkillGroupDescription>
                    </Skill>
                </SkillLevel>
            </SkillLevels>
            <Roles>
                <Role>
                    <RoleName>AGENT</RoleName>
                    <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb3xxxx</InstanceId>
                    <UserCount>0</UserCount>
                    <RoleDescription>坐席</RoleDescription>
                    <RoleId>4c2e158e-ddd9-464a-a3fc-338eca10xxxx</RoleId>
                    <Privileges>
                        <Privilege>
                            <PrivilegeDescription>xxx</PrivilegeDescription>
                            <PrivilegeId>xxx</PrivilegeId>
                            <PrivilegeName>xxx</PrivilegeName>
                        </Privilege>
                    </Privileges>
                </Role>
            </Roles>
            <Detail>
                <LoginName>xinyan</LoginName>
                <Department>IT</Department>
                <Email>1783922****@163.com</Email>
                <Phone>12345****</Phone>
                <DisplayName>馨言</DisplayName>
            </Detail>
        </User>
    </List>
</Users>
<Code>OK</Code>
<Success>true</Success>

JSON格式

{
    "Message": "无",
    "RequestId": "C0628E65-1D39-4C26-9AF8-E64775D4BE0F",
    "HttpStatusCode": 200,
    "Users": {
        "TotalCount": 2,
        "PageSize": 5,
        "PageNumber": 1,
        "List": {
            "User": {
                "InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb3xxxx",
                "UserId": "8b33d247-128c-4013-b79d-ec11a6a8xxxx",
                "RamId": "20643462717516xxxx",
                "SkillLevels": {
                    "SkillLevel": {
                        "SkillLevelId": 121131,
                        "Level": 4,
                        "Skill": {
                            "SkillGroupName": "售后技术支持技能组",
                            "InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb3xxxx",
                            "SkillGroupId": "0ead7334-83e7-42a0-a5bd-c2ef9f18xxxx",
                            "SkillGroupDescription": "售后技术支持人员使用"
                        }
                    }
                },
                "Roles": {
                    "Role": {
                        "RoleName": "AGENT",
                        "InstanceId": "9cfad875-6260-4a53-ab6e-b13e3fb3xxxx",
                        "UserCount": 0,
                        "RoleDescription": "坐席",
                        "RoleId": "4c2e158e-ddd9-464a-a3fc-338eca10xxxx",
                        "Privileges": {
                            "Privilege": {
                                "PrivilegeDescription": "xxx",
                                "PrivilegeId": "xxx",
                                "PrivilegeName": "xxx"
                            }
                        }
                    }
                },
                "Detail": {
                    "LoginName": "xinyan",
                    "Department": "IT",
                    "Email": "1783922****@163.com",
                    "Phone": "12345****",
                    "DisplayName": "馨言"
                }
            }
        }
    },
    "Code": "OK",
    "Success": true
}

错误码

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