Skip to content

How to Configure Salesforce Lightning Scheduler Integration with Revenue Grid

 

4 min read

 

Tip

See this article for more information on using Salesforce Lightning Scheduler and this article to learn how the underlying API endpoints work. Also see this video https://youtu.be/D6betOrxAwo to learn how to work with Salesforce Lightning Scheduler via RG Email Sidebar

 

This article provides the steps how to configure Salesforce Lightning Scheduler integration with RG Email Sidebar.

 

Step 1: Dedicated Salesforce Managed Package Installation

This is a bulk action performed by the Admin for all end users.

Note

The prerequisite for Managed package installation is to set up Salesforce Lightning Scheduler, as described in this Salesforce article

 

To run Salesforce Lightning Scheduler integration requires a set of special Salesforce objects and classes. Revenue Grid created a special Salesforce Managed Package that includes all required assets to facilitate integration setup process.

The integration package RG Lightning Scheduler Adapter should be installed by the local Salesforce Admin as described in this Salesforce article; follow the steps below:

      1.1. Make sure that you have set up My Domain name for your Salesforce Org and deployed it for the users. Please follow the instructions in this Revenue Grid article this Salesforce Help video (00:55 - 02:05) to learn how to do that

Another prerequisite for Managed package installation is to enable the setting Publish Appointments as Platform Events in Salesforce Sheduler Settings. To do this, switch to Lightning Experience. Click the Gear (Setup Menu) icon in the upper right corner of the page to open Salesforce Setup menu. In the Quick Search field in the upper left corner, type “Scheduler Settings” to quickly find the necessary tab. On the newly opened Salesforce Sheduler Settings page, enable the setting Publish Appointments as Platform Events

 

      1.2. Open package installation link:

You can get the latest version of the managed package here:
https://login.salesforce.com/packaging/installPackage.apexp?p0=04t090000003nmZ

      1.3. Log in to your Salesforce account (it must have Admin permissions in your Org)

 

      1.4. Select the checkbox I acknowledge that I’m installing a Non-Salesforce Application that is not authorized for distribution as part of Salesforce’s AppExchange Partner Program to permit installation

>>> Click to see a screenshot <<<

 

      1.5. Indicate if you want to install the package for:

  • All users in your Org
  • (recommended) Only for specific users which will be using Lightning Scheduler integration
  • Only for the Admins

 

      1.6. Click the Install button in the lower right corner of the page

You’ll see a notification “Installing and Granting Access to Specific Users…”, then receive an email message that the package has been installed successfully.

 

Note

The managed package is guaranteed to be secure, confidential, and free of any malicious content, under Revenue Grid Privacy & Security policies

 

      1.7. Next, after the managed package is installed, log in to Salesforce with Admin credentials

      1.8. Switch to Lightning Experience as described in this Salesforce article

      1.9. Click the Gear (Setup Menu) icon in the upper right corner of the page to open Salesforce Setup menu

      1.10. In the Quick Search field in the upper left corner, type “Custom Settings” to quickly find the necessary setting

      1.11. On the Custom Settings page, click Manage button next to Scheduler Setting label

 

      1.12. Next, on the Scheduler Setting page, click Edit action next to Scheduler name

      1.13. On the Scheduler Setting Edit page, paste the Clientid you received from our Support team in the relevant field and click Save

 

Step 2: Set the Custom Apex Class

This is a bulk action performed by the Admin for all end users.

In order to accurately retrieve occupied Lightning Scheduler hours spans from Salesforce, a custom Apex Class included in the managed package must be set in Salesforce Scheduling policy settings. Follow the steps below to do that:

2.1. Open Salesforce Setup Menu

2.2. In the Quick Find field in the upper left corner of Salesforce Setup page, enter “Scheduling policies’‘

2.3. Click on Scheduling policies in the navigation pane on the left; you will see the list of policies in the main pane

>>> Click to see a screenshot <<<

 

2.4. In the Scheduling Policies dialog, Click Edit next to Default Appointment Scheduling Policy

2.5. In the field Check External Systems for Resource Availability, enter the value ServiceResourceScheduleHandlerImpl; it is a dedicated Apex class included in the managed package

>>> Click to see a screenshot <<<

 

2.6. Click Save at the bottom of the dialog

Now Lightning Scheduler integration is connected and ready to be used. See this video to learn how to use the feature.

 

 

Step 3: Connect Lightning Scheduler Integration

This action is performed in every user’s Salesforce setup individually.

Next, you need to connect integration via the installed managed package. Perform the following steps:

3.1 Open Salesforce Setup Menu

3.2. In the Quick Find field in the upper left corner of Salesforce Setup page, enter “Installed packages’‘

Tip

Alternatively, you may enter “Config” in the Quick Find field, select Config in the picklist and get directly to the setting

 

>>> Click to see a screenshot <<<

 

3.3. Click on Installed packages in the navigation pane on the left; you will see the list of Managed packages installed in your Org in the main pane

 

3.4. Click on Configure next to RG Lightning Scheduler Adapter package

3.5. In the dialog that appears, enter the specific Sync URL provided by Revenue Grid support team for your Org, e.g. https://sample-sync.revenuegrid.com into the designated field

>>> Click to see a screenshot <<<

 

3.6. Click the button Connect next to the field

3.7. You will see a standard Salesforce OAuth window. Log in to it with Salesforce credentials to authorize data access for integration

>>> Click to see a screenshot <<<

 

Note

It may require several attempts to authorize it due to the technical peculiarities of Salesforce API authorization functioning; you may sometimes see an error “OAuth Error: We can’t authorize you … OAUTH_APPROVAL_ERROR_GENERIC”, please disregard it and continue login attempts

 

As soon as Salesforce access gets authorized, you will see a notification “Signed in successfully”.

However, after that you should additionally check for a green “Connected” notification in Managed package Configuration to make sure that RG Lightning Scheduler integration was successfully connected. If no notification is displayed or the text reads “Disconnected”, please return to the Step 3.6. and keep retrying until you succeed.

>>> Click to see a screenshot <<<

 

 


Get back to us
We would love to hear from you

Name:

E-mail:

Question or comment: