Breadcrumbs

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 

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.

      IIS.PNG

    • Add new Site, Site name (javascript_cti).
      IIS add website deployment.png

    • 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.

    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.No

    Property Name

    Value

     Description

    1

    adminUserName

    admin

    The Finesse Admin Username, This username is used to call the different Finesse APIs

    2

    adminPassword

    *******

    The Finesse Admin Password.

    3

    domain

    https://<finesseFQDN>:8445/finesse/api/

    The domain name for finesse with which we are integrating along with port and api endpoint

    4

    subDomain

    https://<subscriberfinesseFQDN>:8445/finesse/api/

    The domain name for subscriber finesse with which we are integrating along with port and api endpoint

    5

    boshURL

    https://<finesseFQDN>:7443/http-bind /

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

    6

    subBoshUrl

    https://<subscriberfinesseFQDN>:7443/http-bind/

    The sub bosh URL variable basically appends the same subscriber Finesse Domain with a predefined URL 

    7

    finesseFqdn

    <finesseFQDN>

    The domain name for finesse 

    8

    subFinesseFqdn

    <subscriberfinesseFQDN>

    The domain name for subscriber finesse

    9

    finesseFlavor

    UCCE/UCCX

    This property can have 2 values 

    • UCCE

    • UCCX

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

    10

    callVariable

    callVariable1

    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

    11

    powered_by

    True

    System variable should always remain True

    12

    disableEndCallBtn

    false

    This should always remain false

    13

    getQueuesDelay

    6000

    This is only applicable for UCCE/PCCE deployment. This is the time by which CTI Toolbar queries the UCCE Database to display the Queue Stats

    14

    logoutFlag

    True

    Used in Team Performance gadget, to get the logout agents' detail as well. 

    15

    ssoBackendURL

    https://192.168.*.*:8084

    Javascript 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 

    16

    isGadget

    False

    A System property should remain false always. 

    17

    makeNotReadyOutboundCall

    false

    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. 

    18

    defaultNotReadyReasonCode

    27

    This 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. 

    19

    callVariablesList

    {"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"}. 


    1. Update the configurations and save the file.

    image2023-5-23_13-8-12.png

  2. image2023-5-23_13-8-37.png


    Browse the configured FQDN and the application should be accessible as shown below.
    2024-02-20_11-07-07.jpg