Salesforce installation guide

Salesforce installation guide for Salesforce version 1.40.

Salesforce Professional, Enterprise, Performance, Unlimited, and Developer Editions all integrate with Contact Center AI Platform (CCAI Platform).

Support for Salesforce Classic & Lightning

Installation link: Salesforce Enterprise 1.40

Installation steps

The Agent Adapter installed in Salesforce allows agents to take calls and chats directly in a Salesforce Organization (Org). Versions after 1.17 support both Classic Experience and Lightning Experience.

The installation consists of these steps:

1. Locate Org ID and Org Name and add to the portal

2. Install the app in Salesforce

3. Enter connected app consumer key and secret into the portal

4. Create a connected app

5. Place connected app consumer key and secret in the portal

6. Manage the configuration in Salesforce

7. Manage the call center

Data required to perform installation

Locate Org ID and Org Name and Add to the Portal

In this section, you will set up an initial connection between the CCAI Platform portal and Salesforce by finding the required org information and adding it into the CCAI Platform portal.

Prerequisites

• Access to the Company Informationpage within Salesforce.

• User with Admin role assigned in the Portal to access Developer settings

Installation steps

1. In Salesforce, go to Setup > Settings > Company Settings > Company Information.

2. Locate the Salesforce.com Organization Nameand Organization IDin Company Information.

3. Copy both values.

4. In another browser tab, open the CCAI Platform portal.

5. Go to Settings > Developer Settings > CRM > Agent Platform.

6. Select Salesforce.

7. Locate the Salesforce Organization IDand Salesforce Organization Namefields.

8. Enter the Salesforce Organization ID into the Salesforce Organization IDfield and the Salesforce Organization Name into the Salesforce Organization Namefield.

9. Click Save.

Install the App in Salesforce

In this step we will install the app in Salesforce.

Prerequisite

Salesforce user must have privileges to install packages into an Organization.

1. Retrieve the Package Installation link .

2. Sign in to Salesforce if prompted to do so.

3. Select Install for All Users.

   

4. Select Install(or Upgradeif your Org used a previous version). This may take a few minutes.

5. Once the installation is complete, click Done.

   To verify the package installation in Salesforce, go to Platform Tools > Apps > Packaging > Installed Packages.

Create a custom permission set and apply to all agents

In this section, you will create a custom permission set (with the minimum requirements needed for integration), update it with case and contact permissions, and apply it to all agents who use the CCAI Platform portal.

Prerequisites

• User must be a Salesforce Admin to configure this section.

• A list of agents who will be using the adapter in Salesforce.

Steps

1. In Salesforce, go to Administration > Users > Permission Sets.

2. Locate the CC_AgentPermission Set and click the Clonelink.

3. Rename the cloned Permission Set and click Save. For example Company_Agent_Clone.

4. From the Permission Setsscreen, click the name of the new cloned Permission Set.

5. Click Object Settings, in the Appssection.

6. Configure the Object Settingsfor Accounts, Cases, Contacts, and Leadsusing this table:

1. To configure these settings, click the Object Name. Click Edit(at the top).

2. Use the checkboxes in the Object Permissionssection to enable each of the required permissions (Read, Create, Edit, and View All).

   

3. Click Save.

4. Repeat these steps for each of the four objects (Accounts, Cases, Contacts, and Leads).

5. Configure the tasksobject's Typefield permission.

 ![](images/16306536663c5d.png) 

1. Once all configurations are done, click Manage Assignments.

2. Click the Add Assignmentsbutton.

3. Use the checkboxes to select the users, then click Assign.

   

Create a connected app

Create a connected app in Salesforce, a required step for app version 1.15 and later.

A Connected App is an OAuth application that allows the CCAI Platform portal to communicate with Salesforce.

Prerequisites

• Copy your PortalURL. It should follow this structure:

  https://<tenant&>.<domain>.

Steps

1. In Salesforce, go to Setup > Apps > App Manager.

2. Click the New Connected Appbutton.

3. Update the Basic Informationfields with the contents:

4. Under API (Enable OAuth Settings), select the Enable OAuth Settingscheckbox and update the settings using the table:

   Field Name	Field Value
   Enable OAuth Settings	Selected (TRUE)
   Callback URL	https://<tenant>.<domain>/v1/salesforce/oauth_callback
   Selected OAuth Scopes	Access the identity URL service (id, profile, email, address, phone) Manage user data using APIs (API) Perform requests at any time (refresh_token, offline_access)
   Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows	Unselected (False)
   Required Secret for web flow	Selected (TRUE)
   Require Secret for Refresh Token flow.	Selected (TRUE)

5. Under the Canvas App Settings, update the settings with the following:

   Field Name	Field Value
   Canvas	Selected (TRUE)
   Canvas App URL	https://<tenant>.<domain>/v1/salesforce/start
   Access Method	Signed Request (POST)
   Locations	Console Lightning Component Open CTI Visualforce Page

6. Navigate to the bottom of the page and click Save.

7. Click Continueto dismiss the confirmation message and wait for the Connected App to be created.

8. Go to Setup > Apps > Connected Apps > Manage Connected Apps.

9. Click the name of the app from the Connected Appsscreen.

10. Click Manage.

11. Click the Edit Policiesbutton.

12. Under OAuth policies, select the Admin approved users are pre-authorizedoption from the Permitted Usersdrop-down:

    

13. Click Saveat the bottom of the page to return to the Managescreen for the Connected App.

14. Navigate to the Profilessection and click Manage Profiles.

15. On the Application Assignment Profilescreen, select the profile options your company will use, such as the System Administrator or another profile an agent may use.

    In this example, we are selecting Standard Userand System Administrator:

    

16. Click Saveto return to the manage connected app view.

    A Connected App has been created.To verify the connected app was created, check if the app is listed in Settings > Apps > App Manager.

Enter Connected App Consumer Key and Secret into Admin Portal

Enter client_id key and Secret into the Salesforce Admin Portal.

Prerequisites

• Finish the steps in the Create a connected app previous section.

• User must have access to the email address associated with Salesforce user account to receive an identity verification email.

• Must be a user with the administrator role in the CCAI Platform portal.

Steps

1. Go to Setup > Create > Apps > Connected Appsand find your Connected App.

2. Click the arrow to the far right of the row.

3. Click View.

4. Click Manage consumer details.

   

5. Verify your identity by entering the verification code sent to your email address.

6. Copy the Consumer keyand Consumer secretvalues displayed.

   

7. In the CCAI Platform portal, go to Settings > Developer Settingsand locate the Connected App Consumer Keyand Connected App Secretfields.

8. Paste the Consumer Secretinto the Connected APP Consumer Secretfield.

9. Paste the Consumer Keyfrom Salesforce into the Connected APP Consumer Keyfield.

10. Click Save.

    The Connected App information has been added to the CCAI Platform portal.

Manage the Configuration in Salesforce

Configure App version 1.22 and later.

Prerequisites

• App version for Salesforce 1.22 or later is installed for the Salesforce Org.

• Get your company's Company Key and Company Secret Code in the Admin Portal by going to Settings > Developer Settings.

• Connected App is created (see the Create a connected app section above).

Steps

1. In Salesforce, go to Setup > Apps > Packaging > Installed Packages.

2. Locate the CC_Agent_Appand click Configure.

3. On the new tab that opens, click Add New Configuration.

4. Complete the fields using the following values:

   

   Field Name	Field Value	Location for Field
   Setup Owner	Organization or Profile	If you want to set organizational level settings, select Organization . If you want to add profile level settings, select Profile . If you select Profile you can choose a profile for the settings to be applied to.
   Organization		Your organization name displays here and is read-only.
   Profile		Your profile list displays here and you can choose a Profile if you selected Profile for Setup Owner.
   CompanyKey	Company Key	CCAI Platform portal > Settings > Developer Settings
   CompanySecret	Company Secret	CCAI Platform portal > Settings > Developer Settings
   Tenant	Tenant Name	In CCAI Platform portal: https://<tenant>.<domain> Important: only enter the <tenant> portion of the Portal URL in this field. Note: This field has a 100 char limit.
   ConnectedApp	Connected App API name	Match the name in Create a connected app (such as CCaaS_Platform_Connected_App)

5. If you select Profilefrom the Setup Ownerdrop-down, you can select a profile that will be applied to this new configuration. If Organizationwas selected from Setup Owner, the Profilefield is disabled.

6. Click Save Configurationand you are returned to the list screen

7. Once the configuration is completed, close the browser window.

Manage the Call Center

Configure a Call Center in Salesforce to give agents access to the adapter.

Prerequisites

• Package has been installed (see section 2. Install the App in Salesforce above)

Steps

1. In Salesforce go to Setup > Feature Settings > Service > Call Center > Call Centers.

2. Locate and click the Call Center titled Softphone_v2.

3. Click Manage Call Center Users.

4. Click Add More Users.

5. Use the filter fields to search for specific users and then click Find. To view all users, click Find.

6. Use the checkboxes in the search results to select the users that will use the Portal.

7. Click Add to Call Center.

   To verify the result, go to Call Center and see that the users are listed.

After Installation

Set up the console for Salesforce Classic or Salesforce Lightning:

Console setup for Salesforce Classic

Console setup for Salesforce Lighting

Console setup for Salesforce Classic

Configure the Console App to use the adapter in the Salesforce Classic Experience.

Prerequisites

• Complete Salesforce installation

• Organization is configured to use Salesforce Classic experience.

Steps

1. In Salesforce, go to Setup > Build > Create > Apps.

2. On the Appsscreen, locate the Sample Consoleand click Edit.

3. To edit the Sample Console, go to the Choose Console Componentsfield and select the UJET_Chatcomponent from the Available Items list.

4. Click Addto move the component to the Selected Items list.

5. Go to the Assign to Profilessection and select the checkboxes for the profiles with the permission set that you configured in the previous section .

   

6. Click Save.

7. Verify the adapter is shown in the Console as expected:

   Use the app selector in the Salesmenu at the top right corner of the screen to select Sample Console:

   

Result

Salesforce is set up in Salesforce Classic Console.

Console setup for Salesforce Lightning

Configure the Console App to use the adapter in the Salesforce Lightning Experience.

Prerequisites

• Organization uses the Lightning Experience.

• Must have System Administrator profile or be a user who can manage Apps.

• Domain deployment for user with Salesforce is completed.

Steps

1. In Salesforce go to Setup > Apps > App Manager.

2. Locate the Sales and/or Service Consoleapp that has Lightningin the App Type column.

3. Click the arrow drop-down at the far right and select Edit.

4. Click Utility Itemsfrom the App Settings menu on the left.

   

5. Click Add Utility Itemand select the Open CTI Softphoneoption.

6. Configure the Labelfield.

   

7. Click Add Utility Itemagain and select Chat Componentin the Custom- Managed section.

8. Update the Labelas needed.

9. Configure the Iconas needed.

10. Click Save.

11. Repeat Steps 2-10 if installing additional Lightning console apps.

The utility bar has been configured with the components. To confirm that Salesforce is set up with the Lightning Experience, check the utility bar in the console.