McDewey

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

Page 190

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

For more information on preventing non-voice task RONAs during CTI reconnect, see CTI Failover section in Cisco Finesse Administration Guide at https://www.cisco.com/c/en/us/support/customer-collaboration/ finesse/products-maintenance-guides-list.html. https://<FQDN>/finesse/api/User/<id>/Media/<mrdId> URI: https://finesse1.xyz.com/finesse/api/User/1234/Media/5001 Example URI: Agents and supervisors can use this API. Security Constraints: PUT HTTP Method: Application/XML Content Type: XML Input/Output Format: <Media> <mediaConnected>true</mediaConnected> </Media> HTTP Request: id (required): The ID of the user mrdId (required): The ID of the MRD mediaConnected (required): Indicates media connection to Finesse server. The mediaConnected value can only be set to true and is only intended to be used post initialization of the non-voice channel if the agent is found to be in WORK mode. Note Request Parameters: requestId: User provides a unique string that is used to correlate the originating request with the resulting HTTP response or asynchronous error. This parameter is not part of the resulting event or the events. Header Parameters: 202: Successfully Accepted The requestId is included in the response header, if provided. This response only indicates the successful completion of the request. The request is processed and the actual response is sent as part of a media notification. Note 400: Bad Request (for example, malformed or incomplete request) 401: Unauthorized (for example, the user is not authenticated in the Web Session) 404: Not Found (for example, the user ID or mrdId is not known) 503: Service Unavailable (for example, the Notification Service is not running) HTTP Response: <ApiErrors> <ApiError> <ErrorType>finesse.api.media.not_configured</ErrorType> <ErrorData>finesse.api.not_found</ErrorData> <ErrorMessage>MediaDomain Information Does Not Exists in Finesse for Id: 500</ErrorMessage> </ApiError> </ApiErrors> Example Failure Response: Cisco Finesse Web Services Developer and JavaScript Guide, Release 12.5(1) 174 Cisco Finesse Desktop APIs Media—Change Agent from Work State to Active