McDewey

Multi-vendor documentation library · semantic search · MCP endpoint at /mcp

Page 66

↗ View in doc context
page
66
source
finesse/v12.5/developer-guide/developer-guide.md
chunk_id
finesse::v12.5::developer-guide::developer-guide::50

Response Scenario Stand-alone Finesse with Unified CCE: Agent transitions to NOT_READY state with reason code 2 after the call ends. Coresident Finesse with Unified CCX: Unified CCX allows an agent to set a pending state of NOT_READY only once during a call. Unified CCX does not allow an agent to change from one Not Ready reason code to another. <data> <apiErrors> <apiError> <errorData>265</errorData> <errorMessage>CF_INVALID_AGENT_WORKMODE</errorMessage> <errorType>Invalid State</errorType> </apiError> </apiErrors> </data> While talking on an ICD call, the agent attempts to change from a pending state of NOT_READY with reason code 1 to a pending state of NOT_READY with reason code 2. Stand-alone Finesse with Unified CCE: Finesse sends a hard-coded reason code of 999 to indicate the forced state change. Coresident Finesse with Unified CCX: Finesse sends a hard-coded reason code of 33 to indicate the forced state change. A supervisor changes the state of an agent on that supervisor's team to NOT_READY. Asynchronous Errors When accessing the Finesse REST API through the Finesse JavaScript library, asynchronous errors have a status code of 400. When receiving the asynchronous error directly through XMPP, the error message has the format described in "Dialog CTI Error Notification." Note Deployment Type Reason ErrorType All Invalid state transition requested. For example, attempt to set Wrap-Up state on an agent that is not allowed to go to Wrap-Up, or attempt to change an agent's state from READY state to Wrap-up or WORK state. Invalid State Unified CCX Attempt to change an agent's state from RESERVED_OUTBOUND to any other state. Internal Server Error User—Agent State Change With Reason Code This API allows a user to change the agent state in the CTI server and pass along the code value of a corresponding reason code. Users can use this API only when changing state to NOT_READY or LOGOUT. https://<FQDN>/finesse/api/User/<id> URI: https://finesse1.xyz.com/finesse/api/User/1234 Example URI: Cisco Finesse Web Services Developer and JavaScript Guide, Release 12.5(1) 50 Cisco Finesse Desktop APIs User—Agent State Change With Reason Code