全部产品
阿里云办公

技能组相关联客服列表

更新时间:2018-11-16 15:45:56

(ListUsersOfSkillGroup)

描述

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

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,ListUsersOfSkillGroup
InstanceId String 待获取用户列表的技能组所属呼叫中心实例ID。
SkillGroupId String 待获取用户列表的技能组ID。
PageNumber int 分页序号
PageSize int 分页大小

返回参数

名称 类型 是否必须 描述
Users Page\ 获取到的一个技能组的所有用户。
      TotalCount int 对象总数
      PageNumber int 分页序号
      PageSize int 分页大小
      List List\ 对象列表
            UserId String 用户ID, 系统自动生成的唯一标示符;注意这里是RAM子账号在呼叫中心实例的唯一标示符并非RamId,即UUID
            RamId String 用户所对应的RAM账户ID。
            InstanceId String 用户所归属的呼叫中心实例。
            Detail UserDetail 用户详细信息。
                  LoginName String 用户登陆名。
                  displayName String 用户的全名。
                  Phone String 用户的电话号码。
                  Email String 用户的电子邮件地址。
                  Department String 所属部门。
            Roles List\ 用户的角色列表。
                  RoleId String 角色ID,系统自动生成的唯一标示符
                  InstanceId String 角色所归属的呼叫中心实例。
                  RoleName String 角色名称
                  RoleDescription String 角色描述
                  Privileges List\ 角色权限列表
                        PrivilegeId String 权限ID,系统自动生成的唯一标示符。
                        PrivilegeName String 权限名称,需要唯一。
                        PrivilegeDescription String 权限描述。
                  UserCount int 拥有该角色的用户的数量。
            SkillLevels List\ 用户所归属的技能组及相应等级,一个用户可以不属于任何技能组。
                  SkillLevelId String 技能级别唯一ID,系统自动生成的唯一标示符。
                  Skill SkillGroup 技能
                        SkillGroupId String 技能组唯一ID,系统自动生成的唯一标示符。
                        InstanceId String 技能组所归属的呼叫中心实例。
                        SkillGroupName String 技能组名字,需要在所归属的呼叫中心实例中唯一。
                        SkillGroupDescription String 技能组简单描述。
                  Level int 技能级别。

请求示例

  1. https://ccc.cn-shanghai.aliyuncs.com/?
  2. &Action=ListUsersOfSkillGroup
  3. &InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
  4. &SkillGroupId=0ead7334-83e7-42a0-a5bd-c2ef9f18ef28
  5. &PageNumber=1
  6. &PageSize=5
  7. &<公共请求参数>

返回示例

  1. {
  2. "HttpStatusCode":200,
  3. "Users":{
  4. "PageNumber":1,
  5. "TotalCount":2,
  6. "PageSize":5,
  7. "List":{
  8. "User":[
  9. {
  10. "Detail":{
  11. "Phone":"",
  12. "Email":"seagull.zwc@alibaba-inc.com",
  13. "LoginName":"zwc_test_2",
  14. "Department":"",
  15. "DisplayName":"般石"
  16. },
  17. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  18. "UserId":"8b33d247-128c-4013-b79d-ec11a6a8f108",
  19. "RamId":"206434627175162163",
  20. "SkillLevels":{
  21. "SkillLevel":[
  22. {
  23. "SkillLevelId":"121131",
  24. "Skill":{
  25. "SkillGroupDescription":"售后技术支持人员使用",
  26. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  27. "SkillGroupName":"售后技术支持技能组",
  28. "SkillGroupId":"0ead7334-83e7-42a0-a5bd-c2ef9f18ef28"
  29. },
  30. "Level":5
  31. }
  32. ]
  33. },
  34. "Roles":{
  35. "Role":[
  36. {
  37. "RoleName":"AGENT",
  38. "UserCount":0,
  39. "Privileges":{
  40. "Privilege":[
  41. ]
  42. },
  43. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  44. "RoleDescription":"坐席",
  45. "RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
  46. }
  47. ]
  48. }
  49. },
  50. {
  51. "Detail":{
  52. "Phone":"",
  53. "Email":"17839227541@163.com",
  54. "LoginName":"xinyan",
  55. "Department":"",
  56. "DisplayName":"馨言"
  57. },
  58. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  59. "UserId":"b27644cb-f491-4929-bd51-58ec34274360",
  60. "RamId":"2087687511490631192",
  61. "SkillLevels":{
  62. "SkillLevel":[
  63. {
  64. "SkillLevelId":"121132",
  65. "Skill":{
  66. "SkillGroupDescription":"售后技术支持人员使用",
  67. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  68. "SkillGroupName":"售后技术支持技能组",
  69. "SkillGroupId":"0ead7334-83e7-42a0-a5bd-c2ef9f18ef28"
  70. },
  71. "Level":9
  72. }
  73. ]
  74. },
  75. "Roles":{
  76. "Role":[
  77. {
  78. "RoleName":"AGENT",
  79. "UserCount":0,
  80. "Privileges":{
  81. "Privilege":[
  82. ]
  83. },
  84. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  85. "RoleDescription":"坐席",
  86. "RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
  87. }
  88. ]
  89. }
  90. }
  91. ]
  92. }
  93. },
  94. "RequestId":"C0628E65-1D39-4C26-9AF8-E64775D4BE0F",
  95. "Success":true,
  96. "Code":"OK"
  97. }

错误码

错误代码 描述 Http状态码 语义
NotExist.SkillGroup “Skill group ‘%s’ does not exist” 404 技能组不存在,请确认技能组Id是否正确。
NoPermission.User “User ‘%s’ has no permission to ‘%s’ (Skill Group = ‘%s’)” 403 当前用户没有权限进行角色相关的操作,请通过呼叫中心控制台为用户进行授权。