Salesforce Lightning Integration - User Guide - English

This Guide will lead you through the process of Salesforce Lightning integration usage, starting from a Softphone installation and activation, and ending with practical examples for call receiving. 

Blog covering available Salesforce integrations: Optimizing Your Salesforce Integration Experience.

Created: June 2019

Updated: May 2024

Permalinkhttps://wildix.atlassian.net/wiki/x/VgvOAQ

Requirements

  • Salesforce license with access to the Lightning Platform
  • Your Salesforce domain should be whitelisted on the PBX
  • Activated Salesforce Payment Plan to set up Call Center, check the prices here

Features

  • Click-to-call
  • Incoming call popup
  • Outgoing call popup

  • Call history
  • Dialpad
  • Search Bar for contacts
  • Auto-detect existing contacts and redirect to their page

Link to the application

The integration is available for the installation through the Salesforce AppExchange:

Important: Record types (used for Contacts) should be set up in Salesforce to be able to install Wildix Integration. See How to set up Record Types in Salesforce.

In case record types are not set, you may face the following issue when installing Wildix Integration:

Setup Call Сenter

Setup

Step 1

  1. Click on your profile
  2. Go to the Settings page

Step 2

  1. Choose Advanced User Details subcategory
  2. Press the Edit button
  3. Scroll down to Call Center field and press the Magnifier button 

Step 3 

You see a popup with two options:

  • Wildix Classic Call Center - will work only for Classic interface
  • Wildix Lightning Call Center - will work only for Lightning version

Choose Wildix Lightning Call Center and click Save.


 

Switch

In order to switch for Salesforce Classic, you also need to choose Classic Call Center.  

Step 1 

  1. Click on your profile
  2. Go to the Settings page

Step 2 

  1. Choose Advanced User Details subcategory
  2. Press the Edit button
  3. Scroll down to Call Center field and press the Magnifier button 


Step 3 

You see a popup with only one option. Click on Clear Search Results for:

  • Wildix Classic Call Center - will work only for Classic interface
  • Wildix Lightning Call Center - will work only for Lightning version

Choose Classic Call Center and click Save.



Enable Salesforce Telephony in WMS

To be able to log in to the integration and performs calls, make sure to install Salesforce Telephony in WMS:

  1. Go to PBX -> Integrations -> Cloud integrations
  2. Click on Salesforce Telephony:

  3. Click Install:

  4. The integration gets installed:

Note: When Salesforce Telephony is installed, the relevant salesforce_telephony app is added to OAuth 2.0 applications in WMS -> Integrations -> Applications. Please do not delete it, otherwise the integration will not work.

Application Usage 

It is not necessary to keep x-bees / Collaboration open if you have a connected WP phone. You can select a device to place calls if there are several connected devices.

Once you choose the Phone Center you can access the application via App Launcher.


The main page of the application contains Settings, Dial pad, History menus and search.

Call management 

Call management is available starting from Salesforce app v. 1.21.0. 

Make a Call

It is not necessary to keep x-bees / Collaboration open if you have a connected WP phone. You can select a device to place calls if there are several connected devices.

Making a Call by Dialing a Number Manually

To make a call with integration by manually dialing a number:

  1. In the Application, click on the Phone button on the left-bottom corner
  2. Click on the dial-pad button on the right of the search bar
  3. Enter the phone number that you want to dial by clicking the number buttons on the dial-pad, or by typing numbers in the search field with your keyboard
  4. Click Dial or press the Enter key on your keyboard 

Making a Call Using Click-to-Dial

  1. Locate the number that you want to dial in a Сontacts, Accounts or Leads.
  2. Click the  button or the number. The number is automatically dialed in the softphone (x-bees / Collaboration application).
    • A number that has already been clicked cannot be clicked again for five seconds.
    • The  button does not appear next to fax numbers.
    • icon displays if you have trouble with connection to x-bees / Collaboration

Answer a Call

It is not necessary to keep x-bees / Collaboration open if you have a connected WP phone. You can select a device to place calls if there are several connected devices.

You can tell that you have an incoming call if you see a flashing red button near your tab name on the browser. It also plays the ringtone.

Details about the call, if any, are displayed just above the Answer button, and typically include the phone number of the caller and the number that the caller dialed to reach you. When the caller's phone number can be matched with a number in an existing Salesforce record, that record is also displayed in a new tab.

To answer an incoming call, just press the green Handset button: 


Transfer a Call 

  1. During a call, click on the Transfer icon

  2. Enter the contact name/ number 

  3. Select the contact from the list and click on the Arrow to transfer it

Put a Call on Hold

  1. Click on the Hold icon during a call to put it on hold/ to resume it:


Start a Call Recording

  1. During a call, click on the Recording icon to start/ stop the recording 

End a Call 

  1. To end a call, press the red Handset button 

Add a new contact 

  1. To add a new contact, click Create contact:



  2. Add Contact screen shows up, where you need to fill out the following data:
    • First Name: enter the contact’s first name
    • Last Name: type in the contact’s last name
    • Email: fill out email address 
    • Phone: enter phone number  
    • Account: start typing and select account the contact belongs to
    • Record type: choose type of the record in the drop down list


  3. Click Add contact

History


List of previous calls with:

  • Phone number
  • Name of contact
  • Data of call
  • Duration of a call

Dialer settings



  • Enable auto-opening of found contacts
  • Enable auto-opening of found contacts when receiving an incoming call

By default, Google Chrome does not allow pop-ups. Click on the icon in the browser bar and change it.

How to set up Record Types in Salesforce

  1. Go to Setup -> Object Manager - > Contact -> Record Types and click New:


  2. Select Master from the Existing Record Type dropdown list and fill out the below fields:
    • Record Type Label: enter name that is unique within the object
      Note: Don’t name your record type "Master"
    • Record Type Name
    • Description (optional)
  3. Make sure Active checkbox is ticked off to activate the record type.



  4. Select Make Available checkbox in the header row of the table with profile names to make the record type available to users with that profile. 
    To make the new record type the default for a profile, select Make Default in front of the selected profiles. Or, to make it default for all profiles, select the checkbox in the header row.
  5. Click Next at the bottom of the page. 
  6. Choose a page layout that users with this profile see for records with this record type: 
    1. Apply one layout to all profiles: select page layout to be displayed for all profiles
    2. Apply a different layout for each profile: in case of choosing this option, choose a page layout for each profile separately.



  7. Click Save to edit the values of the standard and custom picklists available for the record type, or click Save & New to create another record type.

Note: If there is just one record type, it is assigned to contacts by default. In case there are more than one record type, when creating a new contact, user needs to select type of record for the contact.

For example, when clicking New on the Contacts tab: