McDewey

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

Page 107

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

The request payload contained a mix of valid and invalid ECC or call variables. The client does not receive an UPDATE_CALL_DATA event. The CTI server does not send an UPDATE_CALL_DATA event to Finesse (that is, the CTI server fails the entire request). Finesse does not respond. The CTI server does not respond. 1. A request was sent that does not generate an error from the CTI server to Finesse. 2. The request payload contained no valid ECC or call variables. 1. Finesse does not forward an error to the client. 1. The CTI server does not send an error to Finesse. 1. A request was sent that does not generate an error from the CTI serverto Finesse. 2. 2. Finesse forwards the UPDATE_CALL_DATA event to the client. The CTI server sends an UPDATE_CALL_DATA event to Finesse for the valid ECC and call variables. 2. The request payload contained a mix of valid and invalid ECC or call variables. When the size of the value of an ECC variable name exceeds its maximum length, the CTI server silently truncates the value and updates the variable. As a result, Finesse does not receive a maximum length error. Note Users of this API must ensure that the variables they are trying to update exist. Users must follow the exact format of each variable and ensure that the maximum size is not exceeded. Dialog—Send DTMF String This API allows a user to send a dual-tone multifrequency (DTMF) string during a call. CTI communication architecture has been optimized in Cisco Finesse Release 12.5(1), which has introduced changes in the Finesse API behavior. As a result of this change, it is suggested that call control requests for the same device should not be sent to the Finesse server until the response to a previous call control request has been received. Multiple DTMF requests can however be send one after another, and the server queues them up for you without any error. To prevent CTI errors, the Finesse desktop disables Wrap-Up button and call control buttons Hold, Transfer, Consult, and End across all calls when the DTMF Keypad is opened until the responses to all of the DTMF requests have been completed or timed out. It is suggested that third-party clients follow the same design. The number of outstanding DTMF requests and the timeout duration can be configured using the Finesse CLI. For more information on CLIs, see the Desktop Properties 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/Dialog/<dialogId> URI: https://finesse1.xyz.com/finesse/api/Dialog/54321 Example URI: Agents can use this API. An agent must be a participant in the dialog to perform this action. Security Constraints: PUT HTTP Method: Cisco Finesse Web Services Developer and JavaScript Guide, Release 12.5(1) 91 Cisco Finesse Desktop APIs Dialog—Send DTMF String