Versions Compared

Old Version 30

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 3.0

Create a Salesforce Account

...

             Login to Salesforce and copy-paste the installation link given for the package. Select the “Install for all users” option from the installation wizard, it will start installing the package and notify you when it’s done. 

Note: If you have previously installed package delete that first and then install new package to avoid any inconvenience. In order to uninstall the package, go to installed packages from Quick Find and click uninstall for relevant package. In the next page select "" and click the checkbox "Yes, I want to uninstall this package and permanently delete all associated components" and press uninstall.then update the package via below link.


In case of any issues faced during installing a package, you can refer to the relevant documentation at https://help.salesforce.com/articleView?id=distribution_installing_packages.htm&type=5

...

  • /apex/loginUI
  • /apex/namespace__loginUI (when using a managed package. In order to find namespace from quick find enter installed packages then see namespace prefix from the Expertflow package)
  • HTTPS://<myDomain>.my.salesforce.com/apex/loginUI (when using My Domain)
  • HTTPS://<namespace-dev-ed>.my.salesforce.com/apex/namespace_loginUI (when using a managed package and My Domain)

...

From Setup, in the Quick Find box enter App Manager. Open app manager, Click “New Lightning App” from the top right corner. Enter the name of the app and developer, other options are not mandatory but if you want you can choose according to your preferences. Select next, go with the default options and click next. Click “Add Utility Items”, type “Open CTI softphone” add the softphone to your app by clicking it. Set panel height to 500 and width to 400 and click next. On the next screen, add accounts, contacts, leads, tasks, and agents from available items. Last but not least select all profiles and add them. After adding them click “Save & Finish”.


Add

...

configurations in custom settings

Admin Configurations

  1. Select “Manage” from the “admin” setting.
  2. Click “new” and then in the username field provide admin username value  like "admin".
  3. In password field provide admin password value like "password", then save.

Call States Configuration

  • For callStates use, provide call types according to the finesse version.
  • Values for UCCE 12.0 and UCCX 11.6 have been provided below.
  • For outboundType types for UCCE 12.0 should be "OUT,AGENT_INSIDE,OUTBOUND,OUTBOUND_PREVIEW".
  • OutboundType types for UCCX 11.6 should be "OUT,AGENT_INSIDE,OUTBOUND,OUTBOUND_DIRECT_PREVIEW"

      UCCE 12.0


      Image Added

      UCCX 11.6

      Image Added  

URLs Configuration

First of all, we would enter your finesse server url for establishing a connection.

  1. From Setup, in the quick find box, search “Custom settings”. Open custom settings and click “Manage” from “Configuration Url” setting.
  2. At the top of “Default Organization Level Value,” you will find “new”, click it

...

  1. .
  2. On the next page enter your finesse url in “connectionurl” field with port 7443 and protocol http-bind like this “https://uccx116p.ef.com:7443/http-bind/”

...

  2. In the domain field enter your domain for finesse as “uccx116p.ef.com”

...

  2. In the salesforce_domain field provide your salesforce domain for example "expertflow4-dev-ed.lightning.force.com".

  3. In the xmlNamespace field provide xml namespace value to be "http://jabber.org/protocol/pubsub#event".


  4. Once added, click Save

...

  1. .

Reason Code Configuration

  1. Select “Manage” from the "DefaultReasonCode" setting.
  2. Click “new” and then in the notReadyCode field provide one NotReady reason code like "26".

      Explanation

      You can get reason codes as

  • Get NotReady reason codes from API. It can be accessed via https://fdqn:8445/finesse/api/ReasonCodes?category=NOT_READY. Provide credentials for admin to access Reason codes. 
  • From the list of reason codes choose a reason code from uri tag, for example <uri>/finesse/api/ReasonCode/19</uri> then in this case code will be 19.
  • Once you have the reason code, place it in notReadyReasonCode field and save. 

Finesse Type Configuration

  1. Select “Manage” from the "finesseDeploymentMode" setting.
  2. Click “new” and then in the finesseFlavor field provide either "UCCE" or "UCCX" and save.

License Configuration

  1. Select “Manage” from the “License” setting.

  2. Click “new” and then in the key field provide value "RXhwZXJ0ZmxvdyBBcHA" and save.

Screen Pop Configuration

To manage our priority for searching records when a call is ringing/initiated . Move back to you need to provide your preferences here.

  1. From the custom setting page

...

  1. , this time select “Manage” from the

...

  1. “search_records”

...

  1. .
  2. Click “new” and then in the priority field enter the priority for searching Contacts, Accounts, and Leads in your application

...

  1. like “Contacts, Accounts, Leads”.
  2. Then we need to set searchFields property, enter the fields you want to be searched for phone number like "Phone,HomePhone,MobilePhone".
  3. Then we set newRecord field, you need to provide whatever new entity you want to create when there is no matching number in CRM like "Account".
  4. Then we set LeadsCompany field, it is used to populate the Leads entity's company (required field in case of Leads) when creating a new Lead object like "Expertflow"
  5. After that we need to set AniLength field, it is used to trim the AniLength upto x number of digits, for example is populated like "10". 

      Explanation

  • In the priority field if you enter “Contacts, Accounts, Leads” in your field then contacts will be searched first then accounts and lead at the end. If you don’t want to search for any specific object among these, then don’t include it.
  • For searchFields property, you can provide multiple fields for searching phone number. For example, if you want to search

...

  • the phone number in 3 fields Phone, HomePhone and MobilePhone then you need to enter "Phone, HomePhone, and MobilePhone" (field names can be seen from Object manager → Choose Object → Click Fields and Relationships) and it will search these fields while matching the phone number during the call for a popup.
  • For newRecord field for example, In case of no match you want to create a new Account then you provide "Account" as a value. Other options include Contact and Leads.
  • For LeadsCompany field for example, you want the company name to Expertflow when a new lead is created in case of no match, then you enter "Expertflow".

  • For AniLength field, for example, you have a number "0300123456789" and you want the only 10 digits that will be "0123456789", then you enter value "10" in field. The point to note here is that it counts digits from right to left. 

Call Variable Configuration

  1. Select “Manage” from the "Variable" setting.
  2. Click “new” and then in the Call/ECE Varaiable Name field provide the call variable name or ece variable name for example "callVariable5".

      Explanation

  • Provide a variable name that is not already set at the time of landing an inbound call i.e its value should be null beforehand.  

Supervisor Configuration

  1. Select “Manage” from the "Supervisor Configs" setting.
  2. Click “new” and then in the ssoBackendUrl field provide the url link where sso backend api is exposed for example https://192.168.1.104:1123/.
  3. Then in the getQueueDataDelay field provide the number of seconds to be delayed for updating queue stats data for example 15.

      Explanation

  • Please provide data in both fields, the acceptable limit for queue delay is 0 - 10000.


Documentation Reference: https://help.salesforce.com/articleView?id=cs_add_data.htm&type=5

...

From Setup, open “Object Manager” in the top left adjacent to “Home”. Open it and then open search “agent”, once found open that. From the left pane, select “Page Layouts”.  Open agent Layout, there will be multiple sections on the next page, from the top section navigate to the drop-down list provided and select “Related lists”. Select “Notes and Attachments” from the right panel and then drag it to the “Related Lists” panel at the bottom. Once added, click save from the top left.

...

Before using application accept SSL Certificates for Finesse to and ssoBackendUrl to avoid any issue.

Login agent

Open your application from the top left 9-dotted pattern icon, adjacent to “Setup”. If you can’t find it, search using the name you used while creating an application. Once opened, Maximize Softphone by click on “Phone” from the bottom left corner, enter agent credentials, and press login.

CORS Cisco Finesse

To check the status of cors configuration for finesse, access finesse via CLI (SSH) and run the command "utils finesse cors status". By default, It should return that cors is enabled for all origins. However, if it is not enabled, then you can enable it via 2 methods:

  • To enable cors for all origins, run command "utils finesse cors enable_all". After this, you will need to restart two finesse services by "utils service restart Cisco Finesse Tomcat" and "utils service restart Cisco Unified CCX Notification Service"
  • To enable just for some specific origin, run command "utils finesse cors enable" and then "utils finesse cors allowed_origin add https://xyz.com". After this, you will need to restart two finesse services by "utils service restart Cisco Finesse Tomcat" and "utils service restart Cisco Unified CCX Notification Service"

We have experienced that these methods do the job for most finesse versions, however, we came across one specific version (CCX 11.6.2) where cors wasn't enabled for Salesforce CTI even after executing these commands. If you encounter such an issue, please run commands in the following order:

  • - utils finesse cors disable
  • - utils service restart Cisco Finesse Tomcat
  • - utils service restart Cisco Unified CCX Notification Service
  • - utils finesse cors enable
  • - utils service restart Cisco Finesse Tomcat
  • - utils service restart Cisco Unified CCX Notification Service
  • - utils finesse cors allowed_origin add https://xyz.com
  • - utils service restart Cisco Finesse Tomcat
  • - utils service restart Cisco Unified CCX Notification Service
  • - utils finesse cors status