cisco webex cce administration portal api guide · cisco webex cce administration portal api guide...
TRANSCRIPT
-
Cisco Webex CCE Administration Portal API Guide Published: 2020-11-20
Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000
800 553-NETS (6387) Fax: 408 527-0883
http://www.cisco.com/
-
Cisco Webex CCE Administration Portal API Guide ii
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for
the latest version. Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website
at www.cisco.com/go/offices.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com go trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R)
© 2010–2020 Cisco Systems, Inc. All rights reserved.
http://www.cisco.com/go/officeshttp://www.cisco.com/go/trademarkshttp://www.cisco.com/go/trademarks
-
Cisco Webex CCE Administration Portal API Guide iii
C O N T E N T S
About This Document 1
Overview 1
Conventions 1
Audience 1
Objective: 1
Login Services 2
Login API 2
Partner User Login API 2
Login 2 authorizeUserToTenant API 3
Customer User Login API 3
Logout API 4
Skill Services API 5
GetAllAgents API 5
GetAllAgentsForSkill API 5
GetAllAttributes API 6
GetAllPrecisionQueues API 6
GetPQByID API 7
GetSkillGroups API 7
GetSkillsForAgent API 7
SaveAgentsToSkill API 8
SaveAttributesToAgent API 8
SaveSkillGroup API 9
SaveSkillsToAgent API 9
UpdateAgentAttributes API 9
UpdatePrecisionQueue API 10
User Services API 11
CloneUser API 11
DeleteUser API 12
EnableDisableUserInICM API 12
-
iv Cisco Webex CCE Administration Portal API Guide
EnableDisableUserInPortal API 12
GetAccessSummaryByUser API 13
GetAllAgentDeskSettings API 13
GetAllApmProfiles API 14
GetAllBillingUnits API 14
GetAllDepartments API 14
GetAllPlatforms API 15
GetAllRoles API 15
GetAllSites API 15
GetManageableAccessCollectionsForCloneUserObjectsByCriteria API 16
GetUserByIdProgram API 16
GetUsers API 17
ResetPassword API 17
SetUserStatus API 18
UpdateUser API 18
Request Objects 19
AccessGroupTreeInfoRequest 19
AuthorizeUserToTenantRequest 19
AuthorizeUserToTenantRequest – Example 20
CloneUserRequest 20
CloneUser – Non-Contat Center User – Example 21
GetAgentsForSkillRequest 21
GetAllAgentsRequest 21
GetAllPrecisionQueuesByCriteriaRequest 21
Example 22
GetAllAttributesByCriteriaRequest 22
GetManageableAccessCollectionsForCloneUserObjectCriteriaRequest 22
Example 22
GetPQByIDRequest 23
GetSkillGroupsRequest 23
GetSkillsForAgentRequest 23
GetSkillsForAgentRequest – Example 23
GetUsersRequest 24
GetUsersRequest – Full Example 24
GetUsersRequest – Minimum Example 25
LoginRequest 25
LoginRequest – Example 25
ResetPasswordRequest 25
-
Cisco Webex CCE Administration Portal API Guide v
SaveAgentsToSkillRequest 26
SaveAttributesToAgentRequest 26
Example 26
SaveSkillGroupRequest 26
SaveSkillGroupRequest – Example 26
SaveSkillsToAgentRequest 26
SaveSkillsToAgentRequest – Example 27
SearchByIdRequest 27
SetUserStatusRequest 27
UpdateAgentAttributesRequest 27
UpdatePrecisionQueueRequest 27
UpdateUserInfoRequest 27
Response Objects 29
AccessGroupTreeInfoResponse 29
AuthorizeUserToTenantResponse 29
AuthorizeUserToTenantResponse – Example 30
BaseResponse 31
CloneUserResponse 31
GetAgentsForSkillResponse 31
GetAllAgentDeskSettingsResponse 32
GetAllAgentsResponse 32
GetAllApmProfilesResponse 32
GetAllAttributesResponse 32
GetAllPrecisionQueuesResponse 32
GetAllRolesResponse 32
GetAllSitesResponse 33
GetManageableAccessCollectionsForCloneUserObjectsByCriteriaResponse 33
GetPQByIDResponse 33
GetRefInfoResponse 33
GetSkillsForAgentResponse 33
GetSkillGroupsResponse 33
GetUserAgentInfoResponse 34
GetUsersResponse 34
LoginResponse 34
LoginResponse - Example 35
LogoutResponse 36
LogoutResponse – Example 36
SaveAgentsToSkillResponse 36
-
vi Cisco Webex CCE Administration Portal API Guide
SaveSkillGroupResponse 37
SaveSkillsToAgentResponse 37
ResetPasswordResponse 37
UpdateUserInfoResponse 37
Data Types 38
AccessCollectionsInfo 38
AccessGroupSummary 39
AgentAttributes 39
AgentInfo 39
AgentSkillInfo 39
AttributeInfo 39
BasicAgentDeskSettingsInfo 40
BasicAgentSkillInfo 40
BasicPrecisionQueueInfo 40
BasicProfileInfo 40
BasicRefInfo 41
BasicSkillGroupInfo 41
BasicUserAgentInfoMobile 41
BasicUserAgentInfo 41
BasicUserInfo 42
CollectionInfo 43
LoggedUserInfo 43
UserAgentInfo 43
PagingInfo 44
PrecisionQueueInfo 45
PrecisionQueueSteps 45
ProgramGroupInfo 45
ProgramObjectBasicInfo 45
ReferenceBean 45
SitesUserInfo 45
SimpleSkillGroupInfo 46
SkillGroupInfo 46
Term 46
API Response Constants 47
AuthorizeUserToTenant API Response Constants 47
CloneUser API Response Constants 48
DeleteUser API Response Constants 49
EnableDisableUserInICM API Response Constants 49
-
Cisco Webex CCE Administration Portal API Guide vii
EnableDisableUserInPortal API Response Constants 49
GetAccessSummaryByUser API Response Constants 49
GetAgentsForSkill API Response Constants 50
GetAllAgentDeskSettings API Response Constants 50
GetAllAgents API Response Constants 50
GetAllApmProfiles API Response Constants 50
GetAllAttributes API Response Constants 50
GetAllBillingUnits API Response Constants 50
GetAllDepartments API Response Constants 50
GetAllPrecisionQueues API Response Constants 50
GetAllPlatforms API Response Constants 50
GetAllRoles API Response Constants 51
GetAllSites API Response Constants 51
GetPQByID API Response Constants 51
GetSkillGroups API Response Constants 51
GetSkillsForAgent API Response Constants 51
GetUserByIdProgram API Response Constants 51
GetUsers API Response Constants 51
Login API Response Constants 51
Logout API Response Constants 52
SaveAgentsToSkill API Response Constants 52
SaveAttributesToAgent API Response Constants 52
SaveSkillGroup API Response Constants 52
SaveSkillsToAgent API Response Constants 53
SetUserStatus API Response Constants 53
UpdateAgentAttributes API Response Constants 53
UpdatePrecisionQueue API Response Constants 53
UpdateUser API Response Constants 53
-
Cisco Webex CCE Administration Portal API Guide 1
About This Document • Overview on page 1. • Conventions on page 1. • Audience on page 1. • Objective: on page 1.
Overview This document describes the available APIs within Webex CCE Administration Portal. It presents all User Management services, models, and related models.
Conventions This document includes the following conventions:
• Tables present data as an aid in comprehension, and to prevent confusion. • Table cells containing a dash confirm a cell has no information to display. • Font size helps to discern a reference model’s structure level, whether it is primary,
secondary, or a deeper level.
Audience The Webex CCE Administration Portal User Management API document includes only information about Java models used within the Users page of Webex CCE Administration Portal. Persons interested in working to develop and improve code for the Users page should read this document.
Objective: The objective of this document is to provide details on:
• Webex CCE Administration Portal APIs
I N T R O D U C T I O N
-
2 Cisco Webex CCE Administration Portal API Guide
Login Services • Login API on page 2. • Logout API on page 4.
Login API If you are a Partner, to get authenticated using your management domain user, see Partner User Login. If you are a Customer, to get authenticated using your customer domain user, see Customer Login.
Partner User Login API Authenticating Partner Users with access to more than one Tenant requires a 2-step process.
• Call the Login API • Call the authorizeUserToTenant API
When a Partner User with access to a single Tenant successfully authenticates, the user is automatically authorized to the assigned tenant.
Login Description Login API to login to Portal. The Login API is required before any other API can be called.
You must authenticate. URI https://portal01.mtn01.webexcce.com/portal/services/login/login Security Constraints
The data must be Hex64 encoded. The username format should be: @.
HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request { "username" : "...", "password" : "..." }
HTTP Response 200 -Success 500 – Internal Server Error 415 – Unsupported Exception 404 – Bad Request
Response Body LoginResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See Login API Response Constants.
C H A P T E R 1
https://portal01.mtn01.webexcce.com/portal/services/login/login
-
Cisco Webex CCE Administration Portal API Guide 3
Upon successful authentication, get the Header and get the Cookie (the JSESSIONID). On all subsequent requests, you will need to set the JSESSIONID in the cookie. If the user has access to only one tenant, and upon successful, authentication, the user will be automatically authorized to the tenant and the codeMessage in the response will be USER_AUTHENTICATED_SUCCESSFULLY. If the user has access to more than one tenant, and upon successful authentication, the codeMessage in the response will be TENANT_SELECTION_REQUIRED. The response will contain the list of all the tenants that the user has access to. To complete authorizing the user to a specific tenant, you must call the authorizeUserToTenant API.
authorizeUserToTenant API Description Login API to login to Portal. The Login API is required before any other API can be called. You
must authenticate. URI https://portal01.mtn01.webexcce.com/portal/services/login/authorizeUserToTenant Security Constraints
You will need to set the JSESSIONID in the cookie.
HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request { "username":"…", "idProgram":12345 }
HTTP Response 200 -Success 401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body AuthorizeUserToTenantResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call was successful. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See AuthorizeUserToTenant API Response Constants. Upon successful authentication, the userToken is returned in the response. Note that the userToken should be passed in all subsequent API requests. Upon successful authentication and authorization, the Constant String: USER_AUTHENTICATED_SUCCESSFULLY.will be returned in the codeMessage field in the AuthorizeUserToTenantResponse.
Customer User Login API Description Login API to login to Portal. The Login API is required before any other API can be called.
You must authenticate URI https://portal01.mtn01.webexcce.com/portal/services/login/login Security Constraints
The data must be Hex64 encoded. The username format should be: @ You must have received your - which is a 3 char unique code. If you have not received this code, please contact your Account Manager.
HTTP Method POST
https://portal01.mtn01.webexcce.com/portal/services/login/authorizeUserToTenanthttps://portal01.mtn01.webexcce.com/portal/services/login/login
-
4 Cisco Webex CCE Administration Portal API Guide
Content Type Application/json Input/Output Format
JSON
HTTP Request { "username" : "...", "password" : "..." }
Request Example:
The data must be encoded.
HTTP Response 200 -Success 500 – Internal Server Error 415 – Unsupported Exception 404 – Bad Request
Response Body LoginResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See Login API Response Constants. Upon successful authentication, get the Header and get the Cookie (the JSESSIONID). On all subsequent requests, you will need to set the JSESSIONID in the cookie. Upon successful authentication and authorization, the Constant String: USER_AUTHENTICATED_SUCCESSFULLY will be returned in the codeMessage field in the LoginResponse.
Logout API Description Logout API is to logout the user. The default idle session timeout is 30 mins. Also, after 12
hours, the system will forcefully logout users. URI https://portal01.mtn01.webexcce.com/portal/services/login/logout Security Constraints
HTTP Method GET Content Type Application/json Input/Output Format
JSON
HTTP Request None HTTP Response 200 -Success
500 – Internal Server Error 415 – Unsupported Exception 404 – Bad Request
Response Body LogoutResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See Logout API Response Constants.
https://portal01.mtn01.webexcce.com/portal/services/login/logout
-
Cisco Webex CCE Administration Portal API Guide 5
Skill Services API • GetAllAgents API on page 5. • GetAllAgentsForSkill API on page 5. • GetAllAttributes API on page 6. • GetAllPrecisionQueues API on page 6. • GetPQByID API on page 7. • GetSkillGroups API on page 7. • GetSkillsForAgent API on page 7. • SaveAgentsToSkill API on page 8. • SaveAttributesToAgent API on page 8. • SaveSkillGroup API on page 9. • SaveSkillsToAgent API on page 9. • UpdateAgentAttributes API on page 9. • UpdatePrecisionQueue API on page 10.
GetAllAgents API Description GetAllAgents API gets a list of all agents and supervisors. URI https://portal01.mtn01.webexcce.com/portal/services/protected/attributes/getAllAgents HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request GetAllAgentsRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetAllAgentsResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllAgents API Response Constants.
GetAllAgentsForSkill API Description GetAllAgentsForSkill API gets a list of all available or assigned agents for the skill group ID. URI https://portal01.mtn01.webexcce.com/portal/services/protected/quickskills/getAllAgentsForSkill HTTP Method POST
C H A P T E R 2
https://portal01.mtn01.webexcce.com/portal/services/protected/attributes/getAllAgentshttps://portal01.mtn01.webexcce.com/portal/services/protected/quickskills/getAllAgentsForSkill
-
6 Cisco Webex CCE Administration Portal API Guide
Content Type Application/json Input/Output Format
JSON
HTTP Request GetAgentsForSkillRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetAgentsForSkillResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAgentsForSkill API Response Constants.
GetAllAttributes API Description GetAllAttributes API gets a list of all attributes for the agent. URI https://portal01.mtn01.webexcce.com/portal/services/protected/attributes/getAllAttributes HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request GetAllAttributesB yCriteriaRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetAllAttributesResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllAttributes API Response Constants.
GetAllPrecisionQueues API Description GetAllPrecisionQueues API gets a list of all Precision Queues. URI https://portal01.mtn01.webexcce.com/portal/services/protected/precisionQueues/getAllPrecisionQu
eues HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request GetAllPrecisionQueuesByCriteriaRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetAllPrecisionQueuesResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded.
https://portal01.mtn01.webexcce.com/portal/services/protected/attributes/getAllAttributeshttps://portal01.mtn01.webexcce.com/portal/services/protected/precisionQueues/getAllPrecisionQueueshttps://portal01.mtn01.webexcce.com/portal/services/protected/precisionQueues/getAllPrecisionQueues
-
Cisco Webex CCE Administration Portal API Guide 7
If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllPrecisionQueues API Response Constants.
GetPQByID API Description GetPQByID API gets PQ details by ID. URI https://portal01.mtn01.webexcce.com/portal/services/protected/precisionQueues/getPQByID HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request GetAllPQByIDRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetPQByIDResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetlQByID API Response Constants.
GetSkillGroups API Description GetSkillGroups API gets a list of all skill groups. URI https://portal01.mtn01.webexcce.com/portal/services/protected/skills/getSkillGroups HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request GetSkillGroupsRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetSkillGroupsResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetSkillGroups API Response Constants.
GetSkillsForAgent API Description GetSkillsForAgent API gets a list of available skills or assigned skills for the agent. URI https://portal01.mtn01.webexcce.com/portal/services/protected/quickskills/getSkillsForAgent HTTP Method POST Content Type Application/json Input/Output Format
JSON
https://portal01.mtn01.webexcce.com/portal/services/protected/precisionQueues/getPQByIDhttps://portal01.mtn01.webexcce.com/portal/services/protected/skills/getSkillGroupshttps://portal01.mtn01.webexcce.com/portal/services/protected/quickskills/getSkillsForAgent
-
8 Cisco Webex CCE Administration Portal API Guide
HTTP Request GetSkillsForAgentRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetSkillsForAgentResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetSkillsForAgent API Response Constants.
SaveAgentsToSkill API Description SaveAgentsToSkill API saves the skill group info. URI https://portal01.mtn01.webexcce.com/portal/services/protected/quickskills/saveAgentsToSkill HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SaveAgentsToSkillRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body SaveAgentsToSkillResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See SaveAgentsToSkill API Response Constants.
SaveAttributesToAgent API Description SaveAttributesToAgent API adds attributes to the agent. URI https://portal01.mtn01.webexcce.com/portal/services/protected/attributes/saveAttributesToAgent HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SaveAttributesToAgentRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body BaseResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See SaveAttributesToAgentAPI Response Constants.
https://portal01.mtn01.webexcce.com/portal/services/protected/quickskills/saveAgentsToSkillhttps://portal01.mtn01.webexcce.com/portal/services/protected/attributes/saveAttributesToAgent
-
Cisco Webex CCE Administration Portal API Guide 9
SaveSkillGroup API Description SaveSkillGroup API saves the skill group info. URI https://portal01.mtn01.webexcce.com/portal/services/protected/skills/saveSkillGroup HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SaveSkillGroupRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body SaveSkillGroupResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See SaveSkillGroup API Response Constants.
SaveSkillsToAgent API Description SaveSkillsToAgent API saves the skill group info. URI https://portal01.mtn01.webexcce.com/portal/services/protected/quickskills/saveSkillsToAgent HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SaveSkillsToAgentRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body SaveSkillsToAgentResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See SaveSkillsToAgent API Response Constants.
UpdateAgentAttributes API Description UpdateAgentAttributes API deletes the attributes from the agent. URI https://portal01.mtn01.webexcce.com/portal/services/protected/attributes/updateAgentAttributes HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request UpdateAgentAttributesRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request
https://portal01.mtn01.webexcce.com/portal/services/protected/skills/saveSkillGrouphttps://portal01.mtn01.webexcce.com/portal/services/protected/quickskills/saveSkillsToAgenthttps://portal01.mtn01.webexcce.com/portal/services/protected/attributes/updateAgentAttributes
-
10 Cisco Webex CCE Administration Portal API Guide
415 – Unsupported Exception 500 – Internal Server Error
Response Body BaseResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See UpdateAgentAttributes API Response Constants.
UpdatePrecisionQueue API Description UpdatePrecisionQueue API saves the Precision Queue info. URI https://portal01.mtn01.webexcce.com/portal/services/protected/precisionQueues/updatePrecisionQ
ueue HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request UpdatePrecisionQueueRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body BaseResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See UpdatePrecisionQueue API Response Constants.
https://portal01.mtn01.webexcce.com/portal/services/protected/precisionQueues/updatePrecisionQueuehttps://portal01.mtn01.webexcce.com/portal/services/protected/precisionQueues/updatePrecisionQueue
-
Cisco Webex CCE Administration Portal API Guide 11
User Services API • CloneUser API on page 11. • DeleteUser API on page 12. • EnableDisableUserInICM API on page 12. • EnableDisableUserInPortal API on page 12. • GetAccessSummaryByUser API on page 13. • GetAllAgentDeskSettings API on page 13. • GetAllApmProfiles API on page 14. • GetAllBillingUnits API on page 14. • GetAllDepartments API on page 14. • GetAllPlatforms API on page 15. • GetAllRoles API on page 15. • GetAllSites API on page 15. • GetManageableAccessCollectionsForCloneUserObjectsByCriteria API on page 16. • GetUserByIdProgram API on page 16. • GetUsers API on page 17. • ResetPassword API on page 17. • SetUserStatus API on page 18. • UpdateUser API on page 18.
CloneUser API Description CloneUser API is to create new user based on an existing user and clone all the access control
settings, Skills, Agent Team, Agent Desktop Settings, Agent PQ Attributes, Location settings and Role Group Settings.
URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/cloneUser HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request CloneUserRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body CloneUserResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See CloneUser API Response Constants.
C H A P T E R 3
https://portal01.mtn01.webexcce.com/portal/services/protected/users/cloneUser
-
12 Cisco Webex CCE Administration Portal API Guide
DeleteUser API Description DeleteUser API deletes the user from all components including AD, Portal, ICM and, if Phones are
enabled, from Call Manager. Note that the delete user is a physical delete and cannot be reverted. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/deleteUser HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SearchByIdRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body BaseResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See DeleteUser API Response Constants.
EnableDisableUserInICM API Description EnableDisableUserInICM API activates or deactivates a user in ICM which will allow/dis-allow the
agent/supervisor to login to Finesse Desktop. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/enableDisableUserInICM HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SetUserStatusRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body BaseResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See EnableDisableUserInICM API Response Constants.
EnableDisableUserInPortal API Description EnableDisableUserInPortal API activates or deactivates a user in AD/Portal which will allow/dis-allow
the user to login to Portal. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/enableDisableUserInPortal HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SetUserStatusRequest
https://portal01.mtn01.webexcce.com/portal/services/protected/users/deleteUserhttps://portal01.mtn01.webexcce.com/portal/services/protected/users/enableDisableUserInICMhttps://portal01.mtn01.webexcce.com/portal/services/protected/users/enableDisableUserInPortal
-
Cisco Webex CCE Administration Portal API Guide 13
HTTP Response 200 -Success 401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body BaseResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See EnableDisableUserInPortal API Response Constants.
GetAccessSummaryByUser API Description GetAccessSummaryByUser gets a list of all access groups, access collections and the objects to
assign to the collections for the given user. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/getAccessSummaryByUser HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request AccessGroupTreeInfoRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body AccessGroupTreeInfoResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAccessSummaryByUser API Response Constants.
GetAllAgentDeskSettings API Description GetAllAgentDeskSettings API gets a list of all agent desk settings. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/getAllAgentDeskSettings HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request {} HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetAllAgentDeskSettingsResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllAgentDeskSettings API Response Constants.
https://portal01.mtn01.webexcce.com/portal/services/protected/users/getAccessSummaryByUserhttps://portal01.mtn01.webexcce.com/portal/services/protected/users/getAllAgentDeskSettings
-
14 Cisco Webex CCE Administration Portal API Guide
GetAllApmProfiles API Description GetAllApmProfiles API gets a list of all agent properties management profiles. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/getAllApmProfiles HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request {} HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetAllApmProfilesResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllApmProfiles API Response Constants.
GetAllBillingUnits API Description GetAllBillingUnits API gets a list of all billing units. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/getAllBillingUnits HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request {} HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetRefInfoResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllBillingUnits API Response Constants.
GetAllDepartments API Description GetAllDepartments API gets a list of all departments. URI https://portal01.mtn01.webexcce.com/portal/services/protected/departments/getAllDepartments HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request {} HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request
https://portal01.mtn01.webexcce.com/portal/services/protected/users/getAllApmProfileshttps://portal01.mtn01.webexcce.com/portal/services/protected/users/getAllBillingUnitshttps://portal01.mtn01.webexcce.com/portal/services/protected/departments/getAllDepartments
-
Cisco Webex CCE Administration Portal API Guide 15
415 – Unsupported Exception 500 – Internal Server Error
Response Body GetRefInfoResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllDepartments API Response Constants.
GetAllPlatforms API Description GetAllPlatforms API gets a list of all platforms (or peripherals) that the currently logged in user has
access to. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/getAllPlatforms HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request {} HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetRefInfoResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllPlatforms API Response Constants.
GetAllRoles API Description GetAllRoles API gets a list of all role groups. URI https://portal01.mtn01.webexcce.com/portal/services/protected/roles/getAllRoles HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request {} HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetAllRolesResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllRoles API Response Constants.
GetAllSites API
https://portal01.mtn01.webexcce.com/portal/services/protected/users/getAllPlatformshttps://portal01.mtn01.webexcce.com/portal/services/protected/roles/getAllRoles
-
16 Cisco Webex CCE Administration Portal API Guide
Description GetAllSites API gets a list of all sites that the currently logged in user has access to. URI https://portal01.mtn01.webexcce.com/portal/services/protected/sites/getAllSites HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request {} HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetAllSitesResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetAllSites API Response Constants
GetManageableAccessCollectionsForCloneUserObjectsByCriteria API
Description GetManageableAccessCollectionsForCloneUserObjectsByCriteria API retrieves all the user and agent collections that the currently logged in user has manage access to. Also, it checks the collections that the source user is a member of those collections and pre-selected. If the source is a member of a collection and that the currently logged in user does not have manage access, then mark it with disabled.
URI https://portal01.mtn01.webexcce.com/portal/services/protected/access/getManageableAccessCollectionsForCloneUserObjectsByCriteria
HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SearchByIdRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetManageableAccessCollectionsForCloneUserObjectsByCriteriaResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed.
GetUserByIdProgram API Description GetUserByIdProgram API retrieves the user info by ID. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/getUserByIdProgram HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SearchByIdRequest
https://portal01.mtn01.webexcce.com/portal/services/protected/sites/getAllSiteshttps://portal01.mtn01.webexcce.com/portal/services/protected/access/getManageableAccessCollectionsForCloneUserObjectsByCriteriahttps://portal01.mtn01.webexcce.com/portal/services/protected/access/getManageableAccessCollectionsForCloneUserObjectsByCriteriahttps://portal01.mtn01.webexcce.com/portal/services/protected/users/getUserByIdProgram
-
Cisco Webex CCE Administration Portal API Guide 17
HTTP Response 200 -Success 401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetUserAgentInfoResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetUserByIdProgram API Response Constants.
GetUsers API Description GetUsers API gets a list of all users that the currently logged in user has access to. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/getUsers HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request GetUsersRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body GetUsersResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See GetUsers API Response Constants.
ResetPassword API Description ResetPassword API resets the user’s AD password and/or ICM password. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/resetPassword HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request ResetPasswordRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body ResetPasswordResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded.
https://portal01.mtn01.webexcce.com/portal/services/protected/users/getUsershttps://portal01.mtn01.webexcce.com/portal/services/protected/users/resetPassword
-
18 Cisco Webex CCE Administration Portal API Guide
If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See ResetPassword API Response Constants.
SetUserStatus API Description SetUserStatus API sets the user status in AD, ICM and Portal. URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/setUserStatus HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request SetUserStatusRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body BaseResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See SetUserStatus API Response Constants.
UpdateUser API Description UpdateUser API updates the existing user, agent, or supervisor. Before calling this API, call the
GetUserByIdProgram API to retrieve the existing data for the user, and then make call to this UpdateUser API with the updated info to update the user info.
URI https://portal01.mtn01.webexcce.com/portal/services/protected/users/updateUser HTTP Method POST Content Type Application/json Input/Output Format
JSON
HTTP Request UpdateUserInfoRequest HTTP Response 200 -Success
401 - Unauthorized 404 – Bad Request 415 – Unsupported Exception 500 – Internal Server Error
Response Body UpdateUserInfoResponse You must parse the response body and check the value for the field: code If the code equals 0, the API call succeeded. If the code equals -1, the API call failed. The codeMessage is a string constant and can give more specific details on the response. See UpdateUser API Response Constants.
https://portal01.mtn01.webexcce.com/portal/services/protected/users/setUserStatushttps://portal01.mtn01.webexcce.com/portal/services/protected/users/updateUser
-
Cisco Webex CCE Administration Portal API Guide 19
Request Objects • AccessGroupTreeInfoRequest on page 19. • AuthorizeUserToTenantResponse on page 19. • CloneUserRequest on page 20. • GetAgentsForSkillRequest on page 21. • GetAllAgentsRequest on page 21. • GetAllPrecisionQueuesByCriteriaRequest on page 21. • GetAllAttributesByCriteriaRequest on page 22. • GetManageableAccessCollectionsForCloneUserObjectCriteriaRequest on page 22. • GetPQByIDRequest on page 23. • GetSkillGroupsRequest on page 23. • GetSkillsForAgentRequest on page 23. • GetSkillsForAgentRequest – Example on page 23. • GetUsersRequest on page 24. • LoginRequest on page 25. • ResetPasswordRequest on page 25. • SaveAgentsToSkillRequest on page 26. • SaveAttributesToAgentRequest on page 26. • Example on page 26. • SaveSkillGroupRequest on page 26. • SaveSkillGroupRequest – Example on page 26. • SaveSkillsToAgentRequest on page 26. • SaveSkillsToAgentRequest – Example on page 27. • SearchByIdRequest on page 27s. • SetUserStatusRequest on page 27. • UpdateAgentAttributesRequest on page 27. • UpdatePrecisionQueueRequest on page 27. • UpdateUserInfoRequest on page 27.
AccessGroupTreeInfoRequest Name Data Type Remarks idProgramUser number Properties inherited from BaseRequest authToken string
AuthorizeUserToTenantRequest Name Data Type Remarks Username string idProgram number Properties inherited from BaseRequest Properties inherited from BaseRequest
C H A P T E R 4
-
20 Cisco Webex CCE Administration Portal API Guide
authToken string
AuthorizeUserToTenantRequest – Example { "username" : "...", "idProgram" : 12345, "authToken" : "..." }
CloneUserRequest Name Data Type Remarks cloneUserIdAgentDeskSettings number Pass null, if you want the new user to copy the same Agent Desk
Settings as the source user. reUseADUser boolean Default: false. programPrefix string srcIdUser integer idUser of the source user. You can pass null if you want the search
source user based on the source username instead of source idUser.
cloneUserIdProgramDepartment integer Pass null, if you want the new user to copy the same Agent Desk Settings as the source user.
selectedAgentCollectionIds array of integer Applicable for Agent or Supervisors only. selectedUserCollectionIds array of integer cloneUserEmail string It is s required, if the email slider is turned on. cloneUserAgentTeamID integer Pass null, if you want the new user to add the agent/supervisor to
the same Agent Team as source user belongs to. reUseAgentId boolean Default: false. cloneUserIdProfile number Pass the source user’s idProfile. cloneUserFirstNm string New user’s First Name. cloneUserPassword string cloneUserProgramBillUnitNm string Pass null, if you want the new user to be added to the same Billing
Unit as the source user. cloneUserAgentId string This is required, if the source user is Agent or Supervisor. domain string null. cloneUserIdProgramSite integer Pass null, if you want the new user to be added to the same Site as
the source user. idProgramUser integer Not applicable. Pass null. cloneUserIdProgramBillUnit integer Pass null, if you want the new user to be added to the same Billing
Unit as the source user. cloneUserProgramSiteNm string Pass null, if you want the new user to be added to the same Site as
the source user. loginNm string Not Applicable, pass null. cloneUserPhoneNumber string Required. srcUserName string You can use either srcIdUser or srcUserName to specify the source
user. cloneUserLoginNm string Required. cloneUserProgramDepartmentNm string Pass null, if you want the new user to copy the same Agent Desk
Settings as the source user. cloneUserIdProgramGroup integer Pass null, if you want the new user to have the same role group as
the source user. If the source user is User Defined Role Group but say you want the new user to set Standard Role Group, then pass -1.
cloneAgentDescription string cloneUserLastNm string
-
Cisco Webex CCE Administration Portal API Guide 21
cloneUserTypeCode string Pass null, if you want the new user to be same user type as the source user.
idProgram integer Pass null. ssoEnabledUser boolean cloneAgentEnterpriseName string authToken string
CloneUser – Non-Contat Center User – Example { "cloneUserEmail": "…@...", "cloneUserFirstNm": "…", "cloneUserLastNm": "…", "cloneUserLoginNm": "…", "cloneUserPassword": "…", "cloneUserPhoneNumber": "12345", "cloneUserIdProfile":12345, "selectedUserCollectionIds": [12345, 12346], "srcUserName": “…”, "skipUnityUser": "true" }
GetAgentsForSkillRequest Name Data Type Remarks skillTargetId int platformId int Assigned Boolean 1 – to get assigned agents with the skill group 0 – to get
available agents for assignment searchTerm String searchColumn String searching Boolean getBaseObjectInfoOnly boolean filterByStatus Char A – To retrieve only active users.
D – To retrieve only de-activated users. B – To retrieve both active/de-activated users Default-null – To retrieve all users
pageSize Number To retrieve all collections with no pagination, send pageSize=0.
pageNumber Number sortBy array of string Direction String DESC – to sort in descending.
Default: ASC.
authToken String
GetAllAgentsRequest Name Data Type Remarks platformId Integer Pass null to retrieve all agents from all platforms filterByUserType array of string
GetAllPrecisionQueuesByCriteriaRequest Name Data Type Remarks
-
22 Cisco Webex CCE Administration Portal API Guide
colModel Array of String colName array of string gridName String pageSize Number pageNumber Number sortBy array of string Direction String DESC – to sort in descending.
Default: ASC.
authToken String
Example { "pageSize":"0", "pageNumber":1, }
GetAllAttributesByCriteriaRequest Name Data Type Remarks colModel Array of String colName array of string gridName String pageSize Number pageNumber Number sortBy array of string Direction String DESC – to sort in descending.
Default: ASC.
authToken String
GetManageableAccessCollectionsForCloneUserObjectCriteriaRequest
Name Data Type Remarks idProgramUserToClone Number Required. colModel array of string colNames array of string gridName String pageSize Number To retrieve all collections with no pagination, send
pageSize=0. pageNumber Number sortBy array of string Direction String DESC – to sort in descending.
Default: ASC.
authToken String
Example { "pageSize":"0", "pageNumber":1, "idProgramUserToClone": 300100
-
Cisco Webex CCE Administration Portal API Guide 23
}
GetPQByIDRequest Name Data Type Remarks Id Integer Required.
GetSkillGroupsRequest Name Data Type Remarks skillTargetId int peripheralId int peripheralName String Description String enterpriseName String transferNumber String getBaseObjectInfoOnly boolean skillChangeId Integer pageSize Number To retrieve all collections with no pagination, send
pageSize=0. pageNumber Number sortBy array of string Direction String DESC – to sort in descending.
Default: ASC.
authToken String
GetSkillsForAgentRequest Name Data Type Remarks Assigned boolean 1 – to get list of skills assigned to the agent; 0 – to get list of
available skills. searchTerm String Search is only one name and description. Searching boolean getBaseObjectInfoOnly boolean skillTargetId int idProgramUser int platformId Int pageSize Number To retrieve all collections with no pagination, send
pageSize=0. pageNumber Number sortBy array of string Direction String DESC – to sort in descending.
Default: ASC.
authToken String
GetSkillsForAgentRequest – Example { "pageNumber":0, "pageSize":99999, "direction":"ASC", "sortBy":[],
-
24 Cisco Webex CCE Administration Portal API Guide
"assigned":false, "searchTerm":"", "searching":false, "getBaseObjectInfoOnly":true, "platformId":5000004, "idProgramUser":300118 }
GetUsersRequest Name Data Type Remarks getUcmUsersOnly Boolean Applicable only if the Phone Management is enabled from
Portal. Default=false.
platformId Number Optional. searchColumn String The search can be performed on the following fields:
loginNm FirstNm LastNm AgentID (aka PeripheralNumber) Platform (aka PeripheralID) AgentTeamNm Phone All – All of the above columns.
filterByStatus Object A – To retrieve only active users. D – To retrieve only de-activated users. Default-null – To retrieve all users.
filterByUserType array of string A – Agents. S – Supervisors. NC – Non-Contact Center Users. Default: null – to retrieve all user types.
searchTerm string Combine this with searchColumn. Searching boolean Default: false. getMobileUserInfoOnly boolean Default: false.
Sending true will impact the response. The response will contain only BasicUserAgentInfoMobile.
getBaseObjectInfoOnly boolean Default=false. colModel array of string colNames array of string gridName string pageSize number To retrieve all users with no pagination, send pageSize=0. pageNumber number sortBy array of string Direction string DESC – to sort in descending.
Default: ASC.
authToken string
GetUsersRequest – Full Example { "getUcmUsersOnly" : false, "getUcmNoPrimaryUsersOnly" : false,
-
Cisco Webex CCE Administration Portal API Guide 25
"platformId" : 12345, "searchColumn" : "...", "cmClusterId" : 12345, "filterByStatus" : { }, "filterByUserType" : [ "...", "..." ], "searchTerm" : "...", "searching" : true, "getMobileUserInfoOnly" : true, "primaryIdPhone" : 12345, "getBaseObjectInfoOnly" : true, "colModel" : [ "...", "..." ], "colNames" : [ "...", "..." ], "gridName" : "...", "pageSize" : 12345, "pageNumber" : 12345, "sortBy" : [ "...", "..." ], "direction" : "...", "authToken" : "..." }
GetUsersRequest – Minimum Example { "pageSize":"0", "pageNumber":1, "filterByUserType": ["S", "A", "NC"] }
LoginRequest
Name Data Type Remarks Username String Password String
LoginRequest – Example Example { "username" : "...", "password" : "..." }
ResetPasswordRequest Name Data Type Remarks changeICMPassword boolean newPassword string changePwdAtNextLogon boolean changePortalPassword boolean userName String newICMPassword String Properties inherited from BaseRequest authToken String
-
26 Cisco Webex CCE Administration Portal API Guide
SaveAgentsToSkillRequest Name Data Type Remarks peripheralID Integer addedAgentIds Array of Integer removedAgentIds Array of Integer skillGroupSkillTargetId Integer Skill group Skill Target ID.
SaveAttributesToAgentRequest Name Data Type Remarks agentIds Array of String attributeInfo Array of AttributeInfo
Example { "agentsIds":["5547"], "attributesInfo":[{"id":5121, "name":"123Regression", "description":null, "dataType":"4", "dataTypeString":"Proficiency", "defaultValue":"5", "changeStamp":0, "refURL":"/unifiedconfig/config/attribute/5121", "allowedToEdit":true }] }
SaveSkillGroupRequest Name Data Type Remarks peripheralID Number skillGroupPeripheralName String Skill Group Peripheral Name. skillGroupDescription String Skill Group Description. skillGroupSkillTargetId Integer Skill Group Skill Target ID. serviceLevelThreshold Integer Properties inherited from BaseRequest authToken string
SaveSkillGroupRequest – Example {"peripheralID":5000004, "skillGroupPeripheralName":"Whisper_Test", "skillGroupDescription":"Whisper_Test", "skillGroupSkillTargetId":5709004, "serviceLevelThreshold":-1 }
SaveSkillsToAgentRequest
-
Cisco Webex CCE Administration Portal API Guide 27
Name Data Type Remarks peripheralID Integer addedSkillGroupSkillTargetIds Array of Integer removedSkillGroupSkillTargetIds Array of Integer agentSkillTargetId Integer Agent Skill Target ID. agentIdProgramUser Integer
SaveSkillsToAgentRequest – Example { "peripheralID":5000004, "addedSkillGroupSkillTargetIds":[5908004], "removedSkillGroupSkillTargetIds":[5556004], "agentIdProgramUser":300118 }
SearchByIdRequest Name Data Type Remarks searchId Number basicInfoOnly Boolean Not in use.
SetUserStatusRequest
Name Data Type Description Enabled Boolean idUser int idProgramUser int loginNm String authToken String
UpdateAgentAttributesRequest
Name Data Type Description agentId String attributeId String
UpdatePrecisionQueueRequest
Name Data Type Description precisionQueue PrecisionQueueInfo
UpdateUserInfoRequest
Name Data Type Description basicUserInfo BasicUserInfo reuseAgentId boolean skipUnityUser boolean
-
28 Cisco Webex CCE Administration Portal API Guide
Properties inherited from BaseRequest authToken string
-
Cisco Webex CCE Administration Portal API Guide 29
Response Objects • AccessGroupTreeInfoResponse on page 29. • AuthorizeUserToTenantResponse on page 29. • BaseResponse on page 31. • CloneUserResponse on page 31. • GetAgentsForSkillResponse on page 31. • GetAllAgentDeskSettingsResponse on page 32. • GetAllAgentsResponse on page 32. • GetAllApmProfilesResponse on page 32. • GetAllAttributesResponse on page 32. • GetAllPrecisionQueuesResponse on page 32. • GetAllRolesResponse on page 32. • GetAllSitesResponse on page 33. • GetManageableAccessCollectionsForCloneUserObjectsByCriteriaResponse on page 33. • GetPQByIDResponse on page 33. • GetRefInfoResponse on page 33. • GetSkillsForAgentResponse on page 33. • GetSkillGroupsResponse on page 33. • GetUserAgentInfoResponse on page 34. • GetUsersResponse on page 34. • LoginResponse on page 34. • LogoutResponse on page 36. • SaveAgentsToSkillResponse on page 36. • SaveSkillGroupResponse on page 37. • SaveSkillsToAgentResponse on page 37. • ResetPasswordResponse on page 37. • UpdateUserInfoResponse on page 37.
AccessGroupTreeInfoResponse Name Data Type Remarks listAccessGroupSummary array of AccessGroupSummary Properties inherited from BaseResponse errorMessage String codeMessage String Code Number freeTextResponse String
AuthorizeUserToTenantResponse Name Data Type Remarks
C H A P T E R 5
-
30 Cisco Webex CCE Administration Portal API Guide
accessRolesMap map of boolean idProgram number ssoLoggedUser boolean emailEnabled boolean maxAllowedConnectionsToTenant number deploymentType string ssoType number programUserRolesMap map of boolean userDomain string enableUsage boolean adReadOnlyEnabled boolean ssoEnabled boolean ucceVersion string feedbackFeaturesEnabledMap map of boolean sacNotificationsEnabled boolean userToken string loginExpiryMessage string schedulesNotificationEnabled boolean applicationCodesEnabled array of string icmSSOMode number loginExpiring boolean loginExpiryDays number loggedUserInfo LoggedUserInfo iptEnabled boolean internal boolean programPrefix string idProgramUser number icmUserNmFormat number errorMessage string codeMessage string code number
freeTextResponse string
AuthorizeUserToTenantResponse – Example { "accessRolesMap" : { "property1" : true, "property2" : true }, "idProgram" : 12345, "ssoLoggedUser" : true, "emailEnabled" : true, "maxAllowedConnectionsToTenant" : 12345, "deploymentType" : "...", "ssoType" : 12345, "programUserRolesMap" : { "property1" : true, "property2" : true }, "userDomain" : "...", "enableUsage" : true, "adReadOnlyEnabled" : true, "ssoEnabled" : true, "ucceVersion" : "...",
-
Cisco Webex CCE Administration Portal API Guide 31
"feedbackFeaturesEnabledMap" : { "property1" : true, "property2" : true }, "sacNotificationsEnabled" : true, "userToken" : "...", "loginExpiryMessage" : "...", "schedulesNotificationEnabled" : true, "applicationCodesEnabled" : [ "...", "..." ], "icmSSOMode" : 12345, "loginExpiring" : true, "loginExpiryDays" : 12345, "loggedUserInfo" : { "userEmail" : "...", "firstName" : "...", "firstPartOfUserName" : "...", "userTypeLevel" : "...", "internalUser" : true, "userTypeCode" : "...", "programPrefix" : "...", "lastName" : "...", "username" : "..." }, "iptEnabled" : true, "internal" : true, "programPrefix" : "...", "idProgramUser" : 12345, "icmUserNmFormat" : 12345, "errorMessage" : "...", "codeMessage" : "...", "code" : 12345, "freeTextResponse" : "..." }
BaseResponse Name Data Type Remarks codeMessage string Code Int errorMessage String freeTextResponse String
CloneUserResponse Name Data Type Remarks codeMessage string basicUserAgentInfo BasicUserAgentInfo code Int errorMessage string
GetAgentsForSkillResponse Name Data Type Remarks
-
32 Cisco Webex CCE Administration Portal API Guide
agentSkillInfoList array of AgentSkillInfo basicAgentSkillInfoList Array of BasicAgentSkillInfo Code Int codeMessage String pagingInfo PagingInfo
GetAllAgentDeskSettingsResponse Name Data Type Remarks basicAgentDeskSettingsInfoList array of BasicAgentDeskSettingsInfo Code Int codeMessage String pagingInfo PagingInfo
GetAllAgentsResponse Name Data Type Remarks agents array of AgentInfo Code Int codeMessage String pagingInfo PagingInfo
GetAllApmProfilesResponse Name Data Type Remarks basicProfileInfoList array of BasicProfileInfo Code Number codeMessage String pagingInfo PagingInfo
GetAllAttributesResponse Name Data Type Remarks Aatributes array of AttributeInfo Code Int codeMessage String pagingInfo PagingInfo
GetAllPrecisionQueuesResponse Name Data Type Remarks precisionQueues array of BasicPrecisionQueueInfo Code Number codeMessage String pagingInfo PagingInfo
GetAllRolesResponse Name Data Type Remarks siteInfoList array of ProgramGroupInfo Code Number codeMessage String pagingInfo PagingInfo
-
Cisco Webex CCE Administration Portal API Guide 33
GetAllSitesResponse Name Data Type Remarks siteInfoList array of SitesUserInfo Code Number codeMessage String pagingInfo PagingInfo
GetManageableAccessCollectionsForCloneUserObjectsByCriteriaResponse
Name Data Type Remarks accessibleUserCollectionNotSelectedList array of AccessCollectionsInfo accessibleUserCollectionSelectedList array of AccessCollectionsInfo accessibleAgentCollectionNotSelectedList array of AccessCollectionsInfo accessibleAgentCollectionSelectedList array of AccessCollectionsInfo Code Number codeMessage String pagingInfo PagingInfo
GetPQByIDResponse
Name Data Type Remarks precisionQueueInfo PrecisionQueueInfo Code Number codeMessage String
GetRefInfoResponse Name Data Type Remarks pagingInfo PagingInfo basicRefInfo array of BasicRefInfo Properties inherited from BaseResponse errorMessage String codeMessage String Code Number freeTextResponse String
GetSkillsForAgentResponse Name Data Type Remarks simpleSkillGroupList array of SimplekillGroupInfo basicSkillGroupList Array of BasicSkillGroupInfo skillGroupList array of SkillGroupInfo Code Number codeMessage String pagingInfo PagingInfo
GetSkillGroupsResponse Name Data Type Remarks
-
34 Cisco Webex CCE Administration Portal API Guide
skillGroupList array of SkillGroupInfo basicSkillGroupList Array of BasicSkillGroupInfo Code Number codeMessage String pagingInfo PagingInfo
GetUserAgentInfoResponse Name Data Type Remarks userAgentInfoList array of UserAgentInfo Code Number codeMessage string pagingInfo PagingInfo
GetUsersResponse Name Data Type Remarks
userMobileAgentInfoList array of BasicUserAgentInfoMobile Will be returned only if getMobileUserInfo is true in the request. Default: false.
basicUserAgentInfoList array of BasicUserAgentInfo Will be returned only if getBasicUserAgentInfo is true in the request. Default: false.
userAgentInfoList array of UserAgentInfo Will be returned only if both getMobileUserInfo = false and getBasicUserAgentInfo = false in the request.
Code Number
codeMessage String
pagingInfo PagingInfo
LoginResponse
Name Data Type Remarks
applicationCodesEnabled array of string
loggedUserInfo LoggedUserInfo
ucceVersion String
schedulesNotificationEnabled Boolean
deploymentType String
loginExpiryMessage String
userDomain String
accessRolesMap map of boolean
emailEnabled Boolean
adReadOnlyEnabled Boolean
feedbackFeaturesEnabledMap map of boolean
accessibleTenantsList array of BasicTenantInfo
-
Cisco Webex CCE Administration Portal API Guide 35
Name Data Type Remarks
iptEnabled boolean
userToken string
loginExpiring boolean
idProgram number
maxAllowedConnectionsToTenant number
ssoEnabled boolean
icmUserNmFormat number
programUserRolesMap map of boolean
enableUsage boolean
programPrefix string
icmSSOMode number
sacNotificationsEnabled boolean
ssoType number
loginExpiryDays number
idProgramUser number
deploymentType String
errorMessage String
codeMessage String
Code Int
freeTextResponse String
LoginResponse - Example { "applicationCodesEnabled" : [ "...", "..." ], "loggedUserInfo" : { "userEmail" : "...", "firstName" : "...", "firstPartOfUserName" : "...", "userTypeLevel" : "...", "internalUser" : true, "userTypeCode" : "...", "programPrefix" : "...", "lastName" : "...", "username" : "..." }, "ucceVersion" : "...", "schedulesNotificationEnabled" : true, "deploymentType" : "...", "loginExpiryMessage" : "...", "userDomain" : "...", "accessRolesMap" : { "property1" : true, "property2" : true }, "emailEnabled" : true,
-
36 Cisco Webex CCE Administration Portal API Guide
"adReadOnlyEnabled" : true, "feedbackFeaturesEnabledMap" : { "property1" : true, "property2" : true }, "accessibleTenantsList" : [ { "programPrefix" : "...", "programNm" : "...", "idProgram" : 12345 }, { "programPrefix" : "...", "programNm" : "...", "idProgram" : 12345 } ], "iptEnabled" : true, "userToken" : "...", "loginExpiring" : true, "idProgram" : 12345, "maxAllowedConnectionsToTenant" : 12345, "ssoEnabled" : true, "icmUserNmFormat" : 12345, "programUserRolesMap" : { "property1" : true, "property2" : true }, "enableUsage" : true, "programPrefix" : "...", "icmSSOMode" : 12345, "sacNotificationsEnabled" : true, "ssoType" : 12345, "loginExpiryDays" : 12345, "idProgramUser" : 12345, "errorMessage" : "...", "codeMessage" : "...", "code" : 12345, "freeTextResponse" : "..." }
LogoutResponse LogoutResponse – Example
{ "codeMessage" : "...", "code" : 12345 }
SaveAgentsToSkillResponse Name Data Type Remarks basicSkillGroupInfo BasicSkillGroupInfo codeMessage string Code number
-
Cisco Webex CCE Administration Portal API Guide 37
SaveSkillGroupResponse Name Data Type Remarks Properties inherited from BaseResponse errorMessage string codeMessage string Code number freeTextResponse string skillGroupInfo SkillGroupInfo
SaveSkillsToAgentResponse Name Data Type Remarks Properties inherited from BaseResponse errorMessage string codeMessage string Code number freeTextResponse string
ResetPasswordResponse Name Data Type Remarks codeMessage string Code number
UpdateUserInfoResponse Name Data Type Remarks basicUserInfo BasicUserInfo Properties inherited from BaseResponse errorMessage string codeMessage string Code number freeTextResponse string
-
38 Cisco Webex CCE Administration Portal API Guide
Data Types • AccessCollectionsInfo on page 38. • AccessGroupSummary on page 39. • AgentAttributes on page 39. • AgentInfo on page 39. • AgentSkillInfo on page 39. • AttributeInfo on page 39. • BasicAgentDeskSettingsInfo on page 40. • BasicAgentSkillInfo on page 40. • BasicPrecisionQueueInfo on page 40. • BasicProfileInfo on page 40. • BasicRefInfo on page 41. • BasicSkillGroupInfo on page 41. • BasicUserAgentInfoMobile on page 41. • BasicUserAgentInfo on page 41. • BasicUserInfo on page 42. • CollectionInfo on page 43. • LoggedUserInfo on page 43. • UserAgentInfo on page 43. • PagingInfo on page 44. • PrecisionQueueInfo on page 45. • PrecisionQueueSteps on page 45. • ProgramGroupInfo on page 45. • ProgramObjectBasicInfo on page 45. • ReferenceBean on page 45. • SitesUserInfo on page 45. • SimpleSkillGroupInfo on page 46. • SkillGroupInfo on page 46. • Term on page 46.
AccessCollectionsInfo
Name Data Type Remarks idObjectType number objectTypeNm string idProgramCollection number programCollectionNm string programCollectionDesc string idProgram number idProgramUser number idCollectionType number
C H A P T E R 6
-
Cisco Webex CCE Administration Portal API Guide 39
collectionTypeNm string collectionTypeDesc string Selected boolean manageAccessCollection boolean systemManaged boolean totalAssignedObjects number totalAssignedUsers number totalAssignedGroups number
AccessGroupSummary Name Data Type Remarks listCollectionInfo array of CollectionInfo accessGroupName String
AgentAttributes Name Data Type Remarks description String attributeValue String Attribute ReferenceBean
AgentInfo Name Data Type Remarks attributes array of AgentAttributes
AgentSkillInfo Name Data Type Remarks idRow Long primaryFlag Boolean personId int supervisorAgent char agentDesc String idProgram Int idSourceSystem long agentEnterpriseNm String skillTargetId Integer Skill group Skill Target ID skillGroupName String skillGroupDesc String transferNumber Integer idProfile Integer phone String idUserType Integer userTypeNm String userTypeLevel Short userTypeCode String originalId Integer intUIAgentID Long Peripheral Number Properties inherited from BasicAgentSkillInfo
AttributeInfo
-
40 Cisco Webex CCE Administration Portal API Guide
Name Data Type Remarks Id Int Name string Description String datatype String defaultValue String changeStamp Integer refURL String allowedToEdit boolean
BasicAgentDeskSettingsInfo Name Data Type Remarks agentDeskSettingsId number enterpriseName string
BasicAgentSkillInfo Name Data Type Remarks agentId int platformId Integer idProgramUser Integer status boolean idUser Integer firstNm String lastNm String username String uiAgentId String isAllowedToEdit boolean platformName String totalAssignedSkills Int
BasicPrecisionQueueInfo Name Data Type Remarks Id Integer changeStamp Integer Description string Name String agentCount Int agentOrdering Int callOrdering Int serviceLevelThreshold Long serviceLevelType Int agentOrderingString String serviceLevelTypeString String allowedToEdit boolean
BasicProfileInfo Name Data Type Remarks idProfile number profileNm string profileDesc string
-
Cisco Webex CCE Administration Portal API Guide 41
allowedToEdit boolean systemManaged boolean totalAssignedUsers number
BasicRefInfo Name Data Type Remarks Code string Id number Name string allowedToEdit boolean Description string
BasicSkillGroupInfo Name Data Type Remarks skillTargetId Int peripheralId Int platformName String peripheralName String isAllowedToEdit boolean enterpriseName String totalAssignedUsers Int Selected boolean mediaRoutingDomainName String skillName String
BasicUserAgentInfoMobile Name Data Type Remarks idUcmEndUser number loginNm string uiAgentID string contactCenterUserStatusNm string agentTeamNm string idProgramUser number internalUser boolean platformId number lastStatusChangedDateTime number lastNm string sourceIdProgramUser number ssoEnabledUser boolean cmClusterId number Status boolean allowedToEdit boolean firstNm string idContactCenterUserStatus number
BasicUserAgentInfo Name Data Type Remarks idProgramBillUnit number firstNm string
-
42 Cisco Webex CCE Administration Portal API Guide
idProgramGroup number cmClusterId number idProgramUser number primaryIdPhone number unityPhoneLine string Phone string idUser number Email string sourceIdProgramUser number loginNm string lastNm string totalAssignedSkills number platformId number idUcmEndUser number ssoEnabledUser boolean allowedToEdit boolean agentDeskSettingsID number idProfile number idProgramUnityUser number manager boolean internalUser boolean contactCenterUserStatusNm string icmStatus boolean uiAgentID string agentTeamId number idProgramSite number userTypeLevel number lastStatusChangedDateTime number peripheralNumber string Status boolean agentId number idProgramDepartment number createDateStr string allowedToManageObjectsInCollection
boolean
allowedToEdit boolean totalElements number totalPages number allowedToEditCollection boolean accessTypeNm string allowedToAssignUsersOrGroupsToCollection
boolean
accessTypeCode string
BasicUserInfo Name Data Type Remarks agentDeskSettingsID number Phone string idProgramDepartment number agentDescription string ssoEnabledUser boolean platformId number supervisorAgent string Y or N. agentEnterpriseName string
-
Cisco Webex CCE Administration Portal API Guide 43
idProgramSite number agentTeamId number idProgramBillUnit number idUser number loginNm string firstNm string idProgramUser number userTypeCode string manager boolean idProgramGroup number lastNm string status boolean idContactCenterUserStatus number idProfile number createDateStr string Email string agentId string agentSkillTargetId number
CollectionInfo Name Data Type Remarks listProgramObjectBasicInfo array of
ProgramObjectBasicInfo
collectionName string
LoggedUserInfo Name Data Type Remarks userEmail string firstName string firstPartOfUserName string userTypeLevel string internalUser boolean userTypeCode string programPrefix string lastName string Username string
UserAgentInfo Name Data Type Remarks idProgram number agentTeamDesc string ssoEnabledUser boolean idUserType number agentDescription string userTypeCode string Platform string supervisorAgent string cmClusterId number personId number agentTeam string
-
44 Cisco Webex CCE Administration Portal API Guide
agentEnterpriseName string agentTeamNm string idContactCenterUserStatus number teamPrimary boolean intUIAgentID number priSupervisorSkillTargetID number userTypeNm string primaryFlag boolean idSourceSystem number idProgramBillUnit number firstNm string idProgramGroup number cmClusterId number idProgramUser number primaryIdPhone number unityPhoneLine string phone string idUser number email string sourceIdProgramUser number loginNm string lastNm string totalAssignedSkills number platformId number idUcmEndUser number ssoEnabledUser boolean allowedToEdit boolean agentDeskSettingsID number idProfile number idProgramUnityUser number manager boolean internalUser boolean contactCenterUserStatusNm string icmStatus boolean uiAgentID string agentTeamId number idProgramSite number userTypeLevel number lastStatusChangedDateTime number peripheralNumber string status boolean agentId number idProgramDepartment number createDateStr string allowedToManageObjectsInCollection boolean allowedToEdit boolean totalElements number totalPages number allowedToEditCollection boolean accessTypeNm string allowedToAssignUsersOrGroupsToCollection boolean accessTypeCode string
PagingInfo
-
Cisco Webex CCE Administration Portal API Guide 45
Name Data Type Remarks totalPages number totalElements number
PrecisionQueueInfo Name Data Type Remarks
Steps Array of PrecisionQueueSteps
PrecisionQueueSteps Name Data Type Remarks terms Array of Term waitTime Int agentCount Int considerIf String
ProgramGroupInfo Name Data Type Remarks idProgramGroup number idProgram number programGroupNm string programGroupDesc string Deleted boolean systemManaged boolean idGroupType number groupTypeCode string totalAssignedUsers number totalAssignedFeatures number
ProgramObjectBasicInfo Name Data Type Remarks objectNm string objectKeyString1 string objectTypeNm string idProgramObject number
ReferenceBean Name Data Type Remarks refURL String Name String
SitesUserInfo Name Data Type Remarks idProgramSite number idProgram number programSiteNm string programSiteDesc string programSiteAddr1 string
-
46 Cisco Webex CCE Administration Portal API Guide
programSiteAddr2 string programSiteCity string programSiteState string programSiteZip string systemManaged boolean isInternal boolean allowedToEdit boolean
SimpleSkillGroupInfo Name Data Type Remarks skillTargetId Integer isAllowedToEdit boolean Selected Boolean skillName String peripheralName String enterpriseName String
SkillGroupInfo Name Data Type Remarks idSourceSysteml long idProgram int peripheralNumber int description String serviceLevelThreshold int originalId int transferNumber String uwfSkillId String skillType String
Term Name Data Type Remarks attribute AttributeInfo attributeRelation Int parenCount Int termRelation Int termRelationString String attributeRelationString String value1 String
-
Cisco Webex CCE Administration Portal API Guide 47
API Response Constants • AuthorizeUserToTenant API Response Constants on page 47. • CloneUser API Response Constants on page 48. • DeleteUser API Response Constants on page 49. • EnableDisableUserInICM API Response Constants on page 49. • EnableDisableUserInPortal API Response Constants on page 49. • GetAccessSummaryByUser API Response Constants on page 49. • GetAgentsForSkill API Response Constants on page 50. • GetAllAgentDeskSettings API Response Constants on page 50. • GetAllAgents API Response Constants on page 50. • GetAllApmProfiles API Response Constants on page 50. • GetAllAttributes API Response Constants on page 50. • GetAllBillingUnits API Response Constants on page 50. • GetAllDepartments API Response Constants on page 50. • GetAllPrecisionQueues API Response Constants on page 50. • GetAllPlatforms API Response Constants on page 50. • GetAllRoles API Response Constants on page 51. • GetAllSites API Response Constants on page 51. • GetPQByID API Response Constants on page 51. • GetSkillGroups API Response Constants on page 51. • GetSkillsForAgent API Response Constants on page 51. • GetUserByIdProgram API Response Constants on page 51. • GetUsers API Response Constants on page 51. • Login API Response Constants on page 51. • Logout API Response Constants on page 52. • SaveAgentsToSkill API Response Constants on page 52. • SaveAttributesToAgent API Response Constants on page 52. • SaveSkillGroup API Response Constants on page 52. • SaveSkillsToAgent API Response Constants on page 53. • SetUserStatus API Response Constants on page 53. • UpdateAgentAttributes API Response Constants on page 53. • UpdatePrecisionQueue API Response Constants on page 53. • UpdateUser API Response Constants on page 53.
AuthorizeUserToTenant API Response Constants Code Message Constants Description AUTHORIZE_USER_TO_TENANT_FAILED Unexpected failure. AUTHORIZE_USER_TO_TENANT_FAILED_REQD_LOGIN_NM_MISSING The username field is missing
in the request.
C H A P T E R 7
-
48 Cisco Webex CCE Administration Portal API Guide
AUTHORIZE_USER_TO_TENANT_FAILED_REQD_ID_PROGRAM_MISSING The idProgram field is missing in the request.
AUTHORIZE_USER_TO_TENANT_FAILED_USER_ALREADY_LOGGED_ON_ANOTHER_SESSION This is applicable when max session limit is defined and if the number of sessions exceeded the count.
AUTHORIZE_USER_TO_TENANT_FAILED_USER_NOT_AUTHORIZED The user is not authorized to access the Portal.
AUTHORIZE_USER_TO_TENANT_FAILED_USER_DATA_PROBLEM_FOUND_DUPLICATE Found some data problem. If this issue persists, please contact support.
AUTHORIZE_USER_TO_TENANT_FAILED_TENANT_NOT_FOUND The passed idProgram does not match in our records.
AUTHORIZE_USER_TO_TENANT_FAILED_USER_TOKEN_DOES_NOT_MATCH The JSESSIONID passed in the cookie doesn’t match.
USER_AUTHENTICATED_SUCCESSFULLY The user was authenticated and authorized successfully.
CloneUser API Response Constants Code Message Constants Description CLONE_USER_SUCCESS On Success. CLONE_USER_FAILED Unexpected failure. CLONE_USER_FAILED_INVALID_ID_USER Passed in srcIdUser is invalid. CLONE_USER_FAILED_INVALID_CLONED_USER_LOGIN_NM Passed in new user’s loginNm is not
valid. CLONE_USER_FAILED_INVALID_CLONED_USER_FIRST_NM Passed in new user’s First Name is not
valid. CLONE_USER_FAILED_INVALID_CLONED_USER_FIRST_NM_LAST_NM Passed in new user’s first name/last
name is not valid. CLONE_USER_FAILED_INVALID_CLONED_USER_LAST_NM Passed in new user’s last name is not
valid. CLONE_USER_FAILED_INVALID_CLONED_USER_PHONE_NUM Passed in new user’s Phone Number is
not valid. CLONE_USER_FAILED_ONLY_NUMBERS_ALLOWED_PHONE_NUM Passed in new user’s Phone Number
contains non-numeric chars. CLONE_USER_FAILED_INVALID_CLONE_USER_EMAIL Passed in new user’s email address is
not valid. CLONE_USER_FAILED_INCORRECT_PROGRAM_ASSOCIATION Unexpected Data Problem with the
Source User. CLONE_USER_FAILED_INCORRECT_AGENT_ASSOCIATION Unexpected Data Problem with the
Source User. CLONE_USER_FAILED_INCORRECT_PLATFORM_ASSOCIATION Unexpected Data Problem with the
Source User. CLONE_USER_FAILED_USER_FIRST_AND_LAST_ALREADY_EXISTS The First Name and Last Name
combination already exists in Portal. CLONE_USER_FAILED_USER_FIRST_AND_LAST_ALREADY_EXISTS_IN_AD The First Name and Last Name
combination already exists in AD. CLONE_USER_FAILED_USER_LOGIN_NM_ALREADY_EXISTS The User already exists in Portal. CLONE_USER_FAILED_USER_LOGIN_NM_ALREADY_EXISTS_IN_AD The User already exists in AD. If this is
intentional, then resend the cloneUser request with the reUseADUser to true.
CLONE_USER_FAILED_TO_CREATE_USER_IN_AD Failed to create user in AD. CLONE_USER_FAILED_AGENT_ID_NOT_PROVIDED Cloning an Agent or Supervisor,
requires AgentID (aka PeripheralNumber).
-
Cisco Webex CCE Administration Portal API Guide 49
CLONE_USER_FAILED_INVALID_CLONED_AGENT_ENTERPRISE_NM Passed in agent Enterprise Name is not valid.
CLONE_USER_FAILED_TO_SETUP_AGENT_OR_SUPERVISOR_IN_ICM Failed to setup the Agent or Supervisor in ICM.
CLONE_USER_FAILED_TO_CLONE_AGENT_TEAM Failed to Add the agent or supervisor to the Agent Team.
CLONE_USER_FAILED_TO_CLONE_AGENT_DESK_SETTINGS Failed to copy the Agent Desk Settings from the source to new user.
CLONE_USER_FAILED_TO_CLONE_AGENT_SKILL_GROUPS Failed to copy the Skill Groups from the source user to new user.
CLONE_USER_FAILED_TO_CLONE_USER_GROUPS Failed to copy the Access Groups from the source user to new user.
CLONE_USER_FAILED_TO_CLONE_USER_COLLECTIONS Not in use. CLONE_USER_FAILED_TO_CLONE_USER_SETTINGS Failed to copy the user Settings (like
LaunchPad settings) from the source user to new user.
CLONE_USER_FAILED_TO_CLONE_PRECISION_QUEUES_ATTRIBUTES Failed to clone the Precision Queue Attributes from the source user to the new user.
CLONE_USER_FAILED_AGENT_ID_ALREADY_IN_USE CLONE_USER_FAILED_INVALID_SOURCE_USER_NAME CLONE_USER_FAILED_USER_TYPE_NOT_FOUND Passed User Type is not valid. CLONE_USER_FAILED_NOT_ALLOWED_TO_CREATE_OWNER Not allowed to create user with OWNER
(aka Partner User Level account).
DeleteUser API Response Constants Code Message Constants Description DELETE_USER_SUCCESS On Success. DELETE_USER_FAILED Unexpected failure.
EnableDisableUserInICM API Response Constants Code Message Constants Description ENABLE_DISABLE_USER_IN_IMC_SUCCESS On Success. ENAB