Document toolboxDocument toolbox

(3.0.3) Deployment Guide

Preface

This document provides deployment details of the product as a standalone or when deploying for CRM like (Microsoft, ServiceNow, and SAPC4C)

Prerequisites

Following are the prerequisites for the deployment of the Javascript CTI Toolbar.

  1. The user must have administrative rights 

Installation of  Javascript CTI Toolbar (3.0.3)

This javascript_cti_toolbar can be deployed on any window server in any application server of the user's choice (IIS, Tomcat, etc). The following section lists the steps to deploy the application on an IIS server.

  1. Download the javascript-cti-toolbar and extract. In the extracted folder,  Copy all the files and place them in the (c:\inetpub\wwwroot\JavaScript-CTI) or any desired directory. 
  2. Open IIS. It can be opened by pressing window+R, writing inetmgr, and clicking OK. It will run IIS Manager.

    • Right-click on Sites to Add a new Site.



    • Add new Site, Site name (javascript_cti).
                                     
    • Physical path (cc:\inetpub\wwwroot\JavaScript-CTI).
    • Port, default value is 80 but any other value can be assigned.
    • Please follow this guide to install and configure the SSL certificates on IIS in order to run the cti_toolbar on HTTPS.

Expertflow SSO Server Deployment Guide

    • The Deployment Guide is available here. This is only required if Cisco Finesse is Configured with SSO. If Finesse is running without SSO, then please ignore this.

Configuration for Javascript CTI Toolbar

  1. Open the new_config.js file located on `c:\inetpub\wwwroot\JavaScript-CTI\config.js` path.  Set the properties as per the below table.

    Warning

    Please use these properties for stand-alone and mobile agent deployment. If CTI is being used inside the CRM, please follow the respective CRM Configurations 

    S.NoProperty NameValue Description
    1adminUserNameadminThe Finesse Admin Username, This username is used to call the different Finesse APIs
    2adminPassword*******The Finesse Admin Password. (You'll first need to encrypt the password and then use the encrypted string here as adminPassword)
    3domainhttps://<finesseFQDN>:8445/The domain name for finesse with which we are integrating 
    4subDomainhttps://<subscriberfinesseFQDN>:8445/The domain name for subscriber finesse with which we are integrating 
    5boshURLhttps://<finesseFQDN>:7443/http-bind /

    The boshbaURL variable basically append the same Finesse Domain with a predefined URL 

    6subBoshUrlhttps://<subscriberfinesseFQDN>:7443/http-bind/The sub bosh URL variable basically appends the same subscriber Finesse Domain with a predefined URL 
    7finesseFlavorUCCE/UCCX

    This property can have 2 values 

    • UCCE
    • UCCX

    Note: In the case of PCCE, we need to provide value UCCE.

    8callVariablecallVariable1

    Our Connector required an empty one variable which it needs to use for some internal mechanism.  That variable can be any callVariable like callVariable1,callVariable2, callVariable3....callVariable10, or any ECC variable as well. 

    In the case of the ECC variable, we need to provide names like ECC.variableName

    9powered_byTrueSystem variable should always remain True
    10disableEndCallBtnfalseThis should always remain false
    11getQueuesDelay6000This is only applicable for UCCE/PCCE deployment. This is the time by which CTI Toolbar queries the UCCE Database to display the Queue Stats
    12logoutFlagTrueUsed in Team Performance gadget, to get the logout agents' detail as well. 
    13ssoBackendURLhttps://192.168.*.*:8084Javascript CTI Toolbar supports Finesse SSO login as well, and for that EF has developed its own Utility which needs to be deployed First. The Deployment Guide for SSO is available here. Once you deploy that Utility, you can then provide the link here. If Finesse is not SSO enabled, please ignore this property 
    14isGadgetFalseA System property should remain false always. 
    15makeNotReadyOutboundCallfalse

    This property is used for making outbound calls in a Ready state, for CCE 12.5+ we can make calls in Ready state without any issues, but for below versions we need to set this property to true in order to make calls in ready state.

    Note: The agent will be in Not Ready state after the call ends if the property is set to true. 

    16defaultNotReadyReasonCode27This property is used for changing the agent state to Not ready for the outbound calls if made in Ready state and the makeNotReadyOutboundCall property is set to true. 
    17callVariablesList{"callVariable1": "Language"}The call variables list is the config where you can decide which variables you want to display on the UI and with what name they should appear on the UI. In the list, you mention the call variable name followed by the value that will appear on the UI. So for example, if you want only call variable 1 to be displayed with the key 'language' then your config should be {"callVariable1": "Language"}. 
    18newWindowAutoLogintrueThis property needs to be set true if we want to auto-login on the new tab/window. Else we can keep it to false.
    19tabIconChangetrueThis property needs to be set true if we want to change the tab Icon on login, call ringing, etc. Else we can keep it to false.
    1. Update the configurations and save the file.


    Browse the configured FQDN and the application should be accessible as shown below.