Before you integrate Webex Contact Center with Salesforce console, ensure you have the following:

To integrate Webex Contact Center with the Salesforce console, complete the following tasks:

Install Webex Contact Center for Salesforce

Before you begin

This connector is available exclusively for customers using Development, Enterprise, and Ultimate editions of Salesforce only. It is not available in Group and Professional editions of Salesforce.

1

Install the CRM connector from this link — https://login.salesforce.com/?ec=302&startURL=%2Fpackaging%2FinstallPackage.apexp%3Fp0%3D04tUl000000PZVdIAO

2

Enter your username and password for the Salesforce organization in which you want to install the package, and click Log In.

3

Choose one of the following options:

  1. Install in Production—Choose this option if you have tested the application and are ready to go public.

  2. Install in Sandbox—Choose this option if you want to test the application against a copy of the production environment.

The login URL is different for a sandbox environment. After you test the application in the sandbox, you must install the application in a production environment using the Install in Production option.

4

Confirm installation details and click Confirm and Install.

5

Log into Salesforce with your instance credentials when prompted.

6

On the Install screen, choose Install for Admins Only and click Install.

7

After the installation is complete, click Done.

Create a Softphone Layout

1

In Salesforce, click the gear icon in the upper-right corner and choose Setup.

2

Go to Feature Settings > Service > Call Center > Softphone Layouts.

3

Click New.

4

In the Name field, enter a name for the layout and check Is Default Layout.

5

In the Display these salesforce.com objects section, choose your items. These will be the objects searched to trigger the lookup and screen pop on an inbound call.

6

Set Screen Pop Settings according to desired behavior for matching records. 

7

Click the Save button at the top when finished.

  • Screen Pop is only available for inbound calls. For internal and outbound calls, a search is executed and the resultant data is displayed in the connector.
  • In order to display the name of a resultant record in the connector, the Softphone Layout for the given record has to contain the Name field. Otherwise, unknown error is displayed.

Import the Call Center file

1

Go to Setup > Call Center > Call Centers.

2

Click Import.  Choose the call center .xml file and click Import again.

Set Call Center Settings

Users will not see the Phone in their utility bar until this step is completed.

1

Go to Setup > Call Center > Call Centers.

2

Click Edit on the Call Center.

3

Set the WxCC Region at a minimum and Save.  For more information on settings, see Customize tab.

Add users to Call Center

Users will not see the Phone in their utility bar until this step is completed.

1

Go to Setup > Call Center > Call Centers.

2

Click the name of the Cisco Call Center.

3

Click Manage Call Center Users at the bottom of the page.

4

Click Add More Users.

5

Define the parameters for your search and click Find or just click Find to list all users. Check the box next to the desired names and click Add to Call Center.

What to do next

Add Open CTI Softphone to App

1

Go to Setup > Apps > App Manager.

2

Click Edit on the Lightning App you will be working in.

3

Click Utility Items (Desktop Only) > Add Utility Item > Open CTI Softphone.

4

Click Save.

Add Agent Permission Set

1

Click Setup > Users > Permission Sets.

2

Click the name of the Webex Contact Center Agent permission set.

3

Click Manage Assignments.

4

Click Add Assignment to add users.

5

Check the users you want to add and then click Assign.

The following sections describe the configuration and customization of Webex Contact Center Salesforce Agent Desktop application. You can customize and automate different workflows for the agents while they handle both inbound and outbound calls through the Webex Contact Center Agent Desktop application.

Call Center configuration customizations

The following section describes the customization of each property of the Call Center configuration file. You can customize the behavior of Salesforce as per the required business use case.

Table 1. WxCC Settings

Call Center property

Description

Values

WxCC SettingsWxcc Region used by agent
  • North America: us1
  • Canada: ca1
  • UK: eu1
  • EU: eu2
  • APJC: anz1
  • Japan: jp1
  • Singapore: sg1
Table 2. General Information

Call Center property

Description

Values

Internal NameUnique name to reference the Call Center[Default: WxCcCallCenter] Any unique name
Display NameUnique display name for the Call Center[Default: WxCC Call Center] Any unique name
DescriptionDescription of the Call Center[Default: Webex Contact Center Salesforce Integration] Any description
CTI Adapter URLCDN path to the adapter[Default: https://wxcc-crmconnectors.ciscoccservice.com/salesforce/connector/v1/index.html]
Use CTI APIRepresents that the call center is using Open CTI[Default: true] true or false
Softphone HeightHeight of the adapter in pixels[Default: 550] Any height
Softphone WidthWidth of the adapter in pixels[Default: 400] Any width
Salesforce Compatibility ModeDetermines where the softphone is visible (Do not change)[Default: Lightning]
Table 3. Call Activity Record Creation

Call Center property

Description

Values

Date Format In SubjectFormatting of Date/Time in Task subject line[Default: MM-DD-YYYY hh:mm a]
Subject Template

This field can include a mix of variables and static text.

Example:{direction} Call {activityDatetime} {queueName}

In this example, "Call" is static plain text, while {direction},{activityDatetime} and {queueName} are variables. All variables must be enclosed in {} brackets.

[Default: {direction} Call {activityDatetime}]
Record Call Live NotesThis feature flag enables the Write a note option from Log tab in the Connector.[Default: true] true or false
Live Call Notes Field MappingSalesforce Field Name on the Task record to write notes.[Default: Description]
Change Activity Record Ownership For Transferred CallsThis feature flag enables changing the ownership of the activity task record when an agent transfers a call to another agent. It ensures that only one activity record is created for each interaction.[Default: true] true or false
CAD Variable Name That Holds Activity IdName of the CAD variable that holds the activity ID and is used to change the ownership of the activity record for transferred calls.
Object Field Mappings

This feature uses a string of comma separated key value pairs to map the WebexCC CAD variables and SFDC Field Names.

Format:

Field_Name1={CADVariable1},Field_Name2= {CADVariable2}

Example:

Category__c={Category},C Cisco_Queue__c={queueName},Language__c={Language}

Table 4. Outdial Configuration

Call Center property

Description

Values

Remove Phone Number Prefix Strings

Specify the country codes as a comma-separated list. These codes will be removed from the phone number field in SFDC on the outbound dial.

Example: +1,+41,+49

Any country code
Table 5. Advanced Screen Pop Search Configuration

Call Center property

Description

Values

Advanced Screen Pop Enabled

Feature flag to enable Advanced Screen Pop Configurations

[Default: false] true or false
CAD Variable NameName of the CAD Variable that holds the ID to be searched in Softphone Layout.Any CAD Variable
Remove ANI Prefix Strings

Specify the country codes as a comma-separated list. These codes will be removed from the phone number ANI on the inbound call.

Example: +1,+41,+49

Any country code
Table 6. Case Management

Call Center property

Description

Values

Auto Case Creation For Inbound Calls

Option to create new case for every inbound call

[Default: false] true or false
Auto Case Creation For Outbound callsOption to create new case for every outbound call[Default: false] true or false
Open Case Object In Edit Mode

Option to open newly created case in edit mode

[Default: false] true or false
Object Field Mappings

This field uses a string of comma separated key value pairs to map the WebexCC CAD variables and SFDC Field Names.

Format:

Field_Name1={CADVariable1},Field_Name2= {CADVariable2}

Example:

Languages__c={Language},Subject=New case created,SuppliedCompany={Category},SuppliedName={Product},SuppliedPhone={ANI}

Table 7. Screen Pop Settings For No Record Match

Call Center property

Description

Values

Object Field Mappings

In the Softphone Layout, you can choose to create a new record for No matching record calls (Pop to new <Object type>). This field uses a string of comma separated key value pairs to map the WebexCC CAD variables and SFDC Field Names on this new object.

Format:

Field_Name1={CADVariable1},Field_Name2= {CADVariable2}

Example:

Languages__c={Language},Phone={ANI}

Table 8. Omni-Channel State Sync Configuration

Call Center property

Description

Values

Enable Omni-Channel Sync

The feature flag enables Voice/Omni state change based on incoming interactions.

For more information about enabling Omni-Channel routing in Salesforce and setup instructions, please see: https://help.salesforce.com/s/articleView?id=sf.omnichannel_intro.htm

[Default: false] true or false
Omni-Channel Not Ready Reason

Name of the SFDC Omni-Channel "Busy" reason status used when the agent receives inbound call.

Example: Busy_Phone_Call

Any Presence Status Developer Name
WxCC Idle Reason Code

Name of the WxCC Idle Auxiliary code used when the agent receives inbound chat.

Example: Not Ready

Any WxCC Idle Auxiliary Code
Table 9. Widget Settings

Call Center property

Description

Values

Send Browser Notifications

This feature flag enables browser-based pop-up notifications.

[Default: false] true or false