McDewey

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

Page 123

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

https://finesse1.xyz.com/finesse/api/Dialog/54321 Example URI: Agents and supervisors can use this API. A user must be a participant in the call to perform this action. An agent cannot record the call of another agent. A supervisor cannot record an agent's call if the supervisor is not a participant in the call. If a supervisor wants to record an agent's call, the supervisor must first start a silent monitoring session on the call. A supervisor can only silently monitor (and therefore record) agents who belong to teams assigned to that supervisor. Security Constraints: PUT HTTP Method: Application/XML Content Type: XML Input/Output Format: <Dialog> <requestedAction>START_RECORDING</requestedAction> <targetMediaAddress>1001001</targetMediaAddress> </Dialog> HTTP Request: requestedAction (required): The way in which to create the dialog (START_RECORDING) targetMediaAddress (required): The extension of the agent whose call to record Request Parameters: 202: Successfully Accepted This response only indicates a successful completion of the request. The request is processed and the actual response is sent as part of a dialog notification. Note 400: Parameter Missing 400: Invalid Input 401: Authorization Failure 401: Invalid Authorization User Specified 401: Invalid State (the targetMediaAddress specifies an extension of a participant in HELD state) 500: Internal Server Error 501: Not Implemented (a recording attempt was made in a Unified CCE deployment) HTTP Response: <ApiErrors> <ApiError> <ErrorType>Authorization Failure</ErrorType> <ErrorMessage>UNAUTHORIZED</ErrorMessage> <ErrorData>jsmith</ErrorData> </ApiError> </ApiErrors> Example Failure Response: Dialog notification Notifications Triggered: Cisco Finesse Web Services Developer and JavaScript Guide, Release 12.5(1) 107 Cisco Finesse Desktop APIs Dialog—Start Recording