Salesforce Adapter Addin Guide


  • Access to an Administrator account for Salesforce
  • The Level365 CRM Connect Client (version or higher) installed and started
  • Level365 CRM Connect Client CRM license
  • Only supported in Salesforce Classic Interface


Note: Salesforce Adapter is not supported on Terminal Service environments at present.

Supported Salesforce Editions

Salesforce Adapter uses Open CTI API. Please check with your Salesforce Account Manager or check supported editions at: Please note: Lightening interface is not supported.

Step 1: Download the Adapter's definition

Go to the following link to download and save the adapter's XML definition file: Download Level365 CRM Connect Salesforce Adapter.


Step 2: Import the Adapter definition

Login to Salesforce as an administrator, and click Setup.

This will reveal the setup menus.

Click on Call Centers, which you will find in the Customize section of the Build area of the setup menus.

This will take you to a screen like the one shown here.

Scroll down the screen and click on the Continue button at the bottom. You may also want to check the "Don't show me.." option.

You will then see the "All Call Centers" screen, from where you need to click the Import button.

Browse and locate the Adapter definition .xml file that you downloaded in Step 1, and then click Import.

Step 3: Manage Call Center Users

Once you have completed the import, you will be automatically taken to the Level365 CRM Connect Call Center Adapter screen shown here. Click the Manage Call Center Users button.


In the Manage Users screen, click the Add More Users button to start adding users that you want to have access to the Adapter.


Use the search filters to locate the user(s) that you wish to add, or just leave the filters set to none, and then click the Find button.


This will reveal your filtered list of users. As shown below, tick the user(s) that you want to add, and then click the Add to Call Center button.


When you return to the Manage Users screen, you'll see your selected users listed.

When any of the selected users logs into Salesforce and clicks on the HOME page, the Level365 CRM Connect Softphone panel will appear on the left-hand side of their screen.

Panel Status

If the user has Level365 CRM Connect running and a valid CRM level license, their Softphone State will show as 'Available' and they are ready to work with the Softphone.

If the user is experiencing connection issues, or their Level365 CRM Connect client does not support the Salesforce integration, their state will show as 'Not connected'. See the troubleshooting section for help.

Configuring Multiple Search Results Feature

To allow the multiple searching to work the admin must enable a setting as follows (see screenshot).

  1. Go to Customize-Call Centers-Softphone Layouts
  2. Edit the Standard Softphone Layout
  3. In section CTI 2.0 or Higher Settings
  4. Set "Multiple-matching records" to "Pop to search page" (it defaults to nothing)

Customize "New" Entity

If this setting is not configured, then the "+" button will create a new lead. If not configured it is either "No matching records" is set to "Don't pop any screen" or "Pop to New '--None--'".


Customizing the behavior of the "+" button can be done by selecting another entity in the list.

Note: Different softphone layouts can be created and assigned for each user allowing customizing of the behavior for each user. This is not covered in this guide.


If the status on the Softphone panel shows as "Not Connected", check the following:

  • Check that the user has their Level365 CRM Connect client running and connected to their host account
  • Please check that your client meets the prerequisite version for Salesforce Adapter
  • Check that the user has a valid CRM license assigned to them, and that they have "CRM" selected as the License Type in their client configuration

If the Softphone panel does not appear for a user:

  • Check that the user is assigned to use the Level365 CRM Connect Salesforce Adapter (they should be listed in the Manage Users page shown in Step 3 above)
  • As shown here, check that the user has expanded the "hidden" window, as the Softphone panel might not be visible by default

If multiple contacts found and search button does not work:

  • You should check section "Configuring Multiple Search Results Feature" above

Optional Configuration

Include the Users Time Zone in the Call History Subject

Install this Salesforce Apex class in order to include the users Timezone in the Call History subject, for example:

Inbound Call at 16:11:36 Europe/London from 07814256404 (Fred Bloggs)
Inbound Call at 16:14:28 Asia/Hong Kong from 01202528735 (John Smith)
Inbound Call at 16:14:50 Asia/Hong Kong from 01202528732 (Bournemouth)

Note: If the Apex class is not installed the softphone will work as usual however will not show a Timezone in the subject.

To Install the Salesforce Apex class

  • Go to Setup > Build > Develop > Apex Classes.
  • Select New Apex Class.
  • Paste the below code to the edit box and save.
global class GetCurrentUser{
    webService static String getUserTimeZone() {
        TimeZone tz = UserInfo.getTimeZone();
        return tz.getDisplayName();

    webService static String getUserId() {
        return UserInfo.getUserId();


To Modify the InternalNumbersDigits Length (version 1.0.1+)

In the event that a site has internal extension numbers longer than 5 (default), you should add the method described below to the Apex class.

By adding this method you can override the default value. If the length of the phone number received during a call event is less than or equal to this value, then the call is considered to be an internal call.

  • Internal calls never get assigned a related entity (1.0.1)
  • Internal calls do not cause a contact search in Salesforce softphone

Add the following to the body of the Apex class:

webService static integer getInternalNumbersDigitsLength(){
return 5; // change this value

Setting default entity for new record creation

When the "Pop" button is clicked, by default, a new Salesforce Lead record is created. You can change this default entity in the Salesforce Settings under Call Center / Softphone Layouts.

 Open the Default Softphone Layout, under Screen Pop Settings\No matching record- and select the relevant "Pop to new"

Setting search Entities

When a call is made or received you can customize which entities are searched for a match by configuring the Softphone Layout as below.


There are limitations in searching the Cases by phone number; this is a limitation of Salesforce API at time of writing. Salesforce cannot search the associated contact for a Case.

If multiple matching entities are returned from Salesforce, then the adapter will follow the setting configured under "Multiple Matching records" in the Softphone Layout as shown below.

Have more questions? Submit a request