Sample Code

Performance Stats


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dp:GetPerformanceInformationReply ReturnCode="0" 
<dp:Schema Version="1.0" />
        <dp:Property Value="109441280" Name="Tomcat/Heap 
         Memory Utilized"/>
        <dp:Property Value="50921904" Name="Tomcat/Non Heap 
         Memory Utilized"/>
        <dp:Property Value="0" Name="CTI Statistics/Incoming 
         Responses Queue"/>
        <dp:Property Value="0" Name="CTI Statistics/Outgoing 
         Responses Queue"/>
        <dp:Property Value="0" Name="Tomcat/Average Request 
         Process Time"/>
        <dp:Property Value="0" Name="Tomcat/Longest Request 
         Process Time"/>
        <dp:Property Value="1.47" Name="Average System Load"/>
        <dp:Property Value="183" Name="Tomcat/Thread Count"/>
        <dp:Property Value="183" Name="Tomcat/Peak Thread Count"/>
        <dp:Property Value="0" Name="CTI Statistics/Events In Queue"/>
        <dp:Property Value="0" Name="CTI Statistics/Decoding 
         Responses Queue"/>
        <dp:Property Value="0" Name="Active Totals/Logged In Agents"/>
        <dp:Property Value="0" Name="Active Totals/Current Calls"/>
        <dp:Property Value="0" Name="Running Totals/Calls Received 
         or Initiated"/>
        <dp:Property Value="0" Name="Running Totals/Calls Failed"/>

Load Balancing

Use SystemInfo API (check out



As documented in Finesse Developer Guide, using Firefox plugin Poster is great for testing / developing against Finesse.
There is also a REST Client from

Sample Gadgets from dev net

Sample Workflow URL




Log Gathering

Client Network Connections

show network status nodns search :8445

Or try this

show network status nodns search :7443

On a Browser Refresh - Finesse Retrieves the following

Making REST request: method=GET, url=

HTTP Method Used

  • GET: Retrieve a single object or list of objects (for example, a single user or list of users).
  • PUT: Replace a value in an object (for example, to change the state of a user from NOT_READY to READY).
  • POST: Create a new entry in a collection (for example, to create a new reason code or wrap-up reason).
  • DELETE: Remove an entry from a collection (for example, to delete a reason code or wrap-up reason).

Agent Login/Logout/Ready/NotReady

Reference -!usersign-in-to-finesse/usersign-in-to-finesse

URL: Method: PUT Content Type: Application/XML HTTP Request


Third-party gadgets that are hosted on a separate web server can reference the JavaScript library accordingly: Refernce:

<UserPref name="scheme" display_name="scheme" default_value=""/>
<UserPref name="host" display_name="host" default_value=""/>
<UserPref name="hostPort" display_name="hostPort" default_value=""/>
<!-- jQuery -->
<script type="text/javascript" src="__UP_scheme__://__UP_host__:__UP_hostPort__/desktop/assets/js/jquery.min.js"></script>
<!-- Finesse Library -->
<script type="text/javascript" src="__UP_scheme__://__UP_host__:__UP_hostPort__/desktop/assets/js/finesse.js"></script>

Gadget Caching

Clear Caching by restarting 'Cisco Tomcat ' (Cisco Finesse Tomcat on UCCX)
or pass a “nocache” paramter in the URL to clear the cache.


Example Using cURL to send Finesse Commands (See Finesse Developer Guide)
Download cURL for Windows from here:

curl -X PUT --user "12001:12345" -H "Content-Type:application/xml" --data "<User><state>READY</state></User>"

This will send a HTTP PUT as in the below example:

PUT /finesse/api/User/12001 HTTP/1.1
Authorization: Basic MTIwMDE6MTIzNDU=
User-Agent: curl/7.36.0
Accept: */*
Content-Length: 33


WGET does not support PUT, but its it does support POST.
A HTTP POST is what the JavaScript library uses similar to below using wget
It includes in the POST the full URL which includes the PUT details as in above
Note: It also contains the Baisc Authentication String, which would need to be worked out before hand

wget --header="Content-Type: application/x-www-form-urlencoded; charset=UTF-8" --post-data="url=http%3A%2F%2Flocalhost%3A8080%2Ffinesse%2Fapi%2FUser%2F12001&httpMethod=PUT&headers=Content-Type%3Dapplication%252Fxml%26Authorization%3DBasic%2520MTIwMDE6MTIzNDU%253D&postData=%3CUser%3E%3Cstate%3EREADY%3C%2Fstate%3E%3C%2FUser%3E"

This send the following HTTP POST

POST /gadgets/makeRequest HTTP/1.0
User-Agent: Wget/1.11.4
Accept: */*
Connection: Keep-Alive
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Content-Length: 234



jQUERY & Finesse JavaScript Library Location on Finesse

<!-- jQuery -->          
<script type="text/javascript" src="/desktop/assets/js/jquery.min.js"></script>
<!-- Finesse Library -->
<script type="text/javascript" src="/desktop/assets/js/finesse.js"></script>

Gather Finesse Logs

(Requires an SFTP server)

file get activelog desktop/logs/*

Or this should refine it by date

file get activelog desktop/logs/* recurs reltime days 2

Account Locked After Five Failed Sign In Attempts

If an administrator tries to sign in to the Finesse administrator console (or diagnostic portal) with the wrong password five times in a row, Finesse blocks access to that user account for a period up to 30 minutes. For security reasons, Finesse does not alert the user that their account is locked. They must wait 30 minutes and try again.“

If you do not want to wait - you must set the UI password to a new password via the OS admin access. Then reset the password again back to its original password (so set the password twice!). This will unlock the password and you can log in again with the original password.

admin:utils reset_application_ui_administrator_password
New password:*
Confirm new Password:*

-------------------- utils reset_ui_administrator_password --------------------

Reset user interface password
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies