全部产品
阿里云办公

客服列表

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

(ListUsers)

描述

获取呼叫中心实例中的所有用户。需要提供角色,技能组,技能级别,以及按需提供用户详细信息。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,ListUsers
InstanceId 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 用户所归属的呼叫中心实例。
            Primary String 是否为主账户。
            Roles List\ 用户的角色列表。
                  RoleId String 角色ID,系统自动生成的唯一标示符
                  InstanceId String 角色所归属的呼叫中心实例。
                  RoleName String 角色名称
                  RoleDescription String 角色描述
            SkillLevels List\ 用户所归属的技能组及相应等级,一个用户可以不属于任何技能组。
                  SkillLevelId String 技能级别唯一ID,系统自动生成的唯一标示符。
                  Skill SkillGroup 技能
                        SkillGroupId String 技能组唯一ID,系统自动生成的唯一标示符。
                        InstanceId String 技能组所归属的呼叫中心实例。
                        SkillGroupName String 技能组名字,需要在所归属的呼叫中心实例中唯一。
                        SkillGroupDescription String 技能组简单描述。
                  Level int 技能级别。
            Detail UserDetail 用户详细信息。@Transient
                  LoginName String 用户登陆名。
                  DisplayName String 用户的全名。
                  Phone String 用户的电话号码。
                  Email String 用户的电子邮件地址。
                  Department String 所属部门

请求示例

  1. https://ccc.cn-shanghai.aliyuncs.com/?
  2. &Action=ListUsers
  3. &PageNumber=1
  4. &PageSize=2
  5. &<公共请求参数>

返回示例

  1. {
  2. "HttpStatusCode":200,
  3. "Users":{
  4. "PageNumber":1,
  5. "TotalCount":14,
  6. "PageSize":2,
  7. "List":{
  8. "User":[
  9. {
  10. "Detail":{
  11. "Phone":"",
  12. "Email":"293417@alibaba-inc.com",
  13. "LoginName":"yanle12312321232",
  14. "Department":"",
  15. "DisplayName":"ly0021"
  16. },
  17. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  18. "Primary":false,
  19. "UserId":"b80bd838-a5a5-4ed3-ac9a-30be353d0e52",
  20. "RamId":"293032931468912519",
  21. "SkillLevels":{
  22. "SkillLevel":[
  23. {
  24. "SkillLevelId":"121151",
  25. "Skill":{
  26. "SkillGroupDescription":"售后技术支持人员使用",
  27. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  28. "SkillGroupName":"售后技术支持技能组",
  29. "SkillGroupId":"0ead7334-83e7-42a0-a5bd-c2ef9f18ef28"
  30. },
  31. "Level":5
  32. }
  33. ]
  34. },
  35. "Roles":{
  36. "Role":[
  37. {
  38. "RoleName":"AGENT",
  39. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  40. "RoleDescription":"坐席",
  41. "RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
  42. }
  43. ]
  44. }
  45. },
  46. {
  47. "Detail":{
  48. "Phone":"18866668888",
  49. "Email":"18866668888@163.com",
  50. "LoginName":"user05",
  51. "Department":"",
  52. "DisplayName":"王明"
  53. },
  54. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  55. "Primary":false,
  56. "UserId":"6f3e7751-fa61-453f-8057-a2fe9741a387",
  57. "RamId":"202254621208793807",
  58. "SkillLevels":{
  59. "SkillLevel":[
  60. {
  61. "SkillLevelId":"121335",
  62. "Skill":{
  63. "SkillGroupDescription":"售后技术支持人员使用",
  64. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  65. "SkillGroupName":"售后技术支持技能组",
  66. "SkillGroupId":"0ead7334-83e7-42a0-a5bd-c2ef9f18ef28"
  67. },
  68. "Level":4
  69. }
  70. ]
  71. },
  72. "Roles":{
  73. "Role":[
  74. {
  75. "RoleName":"AGENT",
  76. "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
  77. "RoleDescription":"坐席",
  78. "RoleId":"4c2e158e-ddd9-464a-a3fc-338eca10277c"
  79. }
  80. ]
  81. }
  82. }
  83. ]
  84. }
  85. },
  86. "RequestId":"707EF054-E614-4A4A-98D4-F4457073F111",
  87. "Success":true,
  88. "Code":"OK"
  89. }

错误码

错误代码 描述 Http状态码 语义
NotExist.Instance “Call center instance ‘%s’ does not exist” 404 呼叫中心实例不存在,请确认实例ID是否正确,或者实例是否已被删除。
NoPermission.User “User ‘%s’ has no permission to ‘%s’ (User = ‘%s’)” 403 当前用户没有权限进行角色相关的操作。请通过呼叫中心控制台为用户进行授权。