Skip to content

How to Install and Run the Solution (all MS Exchange / Office 365 configurations)

 

4 min read

 

Tip

Also see this Revenue Grid blog article for an overview of solution installation procedures

 

Note

If you are a local administrator rolling out RG Email Sidebar for multiple users in your organization, you can make use of Add-In mass deployment procedures

 

   

I. RG Email Sidebar Add-In Installation

 

1. Installing RG Email Sidebar Outlook Add-In (standard web/cloud installation)

RGES Outlook Add-In follows a standard pattern for MS Outlook cloud addins installation:

  • Open your MS Outlook for Desktop, go to Home tab, and click Get Add-ins in MS Outlook ribbon

 

  • MS Outlook Add-In management window will be opened. In the Search add-ins box on the right-hand side, type “Revenue Grid” and select Revenue Grid for Salesforce

 

  • In the next window that appears, click Add

 

You will see RG Email Sidebar icons added to MS Outlook ribbon.

 

 

Alternatively, install the Add-In via Outlook on the Web:

1. Log in to http://outlook.com or Outlook on the Web with your credentials
2. Select any email in MS Outlook’s and click the β€’β€’β€’ (More actions) icon in the upper right corner above viewed email’s body, as shown in the steps 1-4 of this Microsoft article
3. In the menu that appears, scroll down and click Get Add-ins

>>> Click to see an animation <<<

 

4. Enter RG Email Sidebar in the Search add-ins input box on the upper right corner of the “Add-Ins for Outlook” dialog window and click Add under RG Email Sidebar for Salesforce in search results
5. Next, you need to confirm installation by clicking Continue in the following dialog

 

Tip

Also note that RG Email Sidebar for Salesforce (the Web (Cloud) implementation) can also be installed from an .XML Outlook Add-In manifest file or URL provided by your local RGES Admin or RevenueGrid.com, refer to this article for more information

 

Note

After you install the Add-In for an email account, it becomes available in MS Outlook running on other configurations and devices compatible with Outlook on the Web, Outlook for Mac, iOS, or Android with the same account logged in

 

Important

Before using RG Email Sidebar in MS Outlook Desktop on Windows, please make sure that you have the latest version of MS Edge installed, since it is used to render RG Email Sidebar in MS Outlook

 

 

Installing the Desktop (.MSI) Implementation

Enterprises with special requirements may opt for the custom RG Email Sidebar Add-In Desktop implementation, which is installed from an .MSI file and runs only on Windows OS.

Refer to this article for more information on Installing the Desktop (.MSI) Implementation.

 


 

II. RG Email Sidebar Logon

Note

RGES logging on is not instant: depending on the number of email messages in your mailbox and items in your calendar it may take several minutes to log on, since on logging on RGES needs to match all your existing correspondence and calendar items with your Salesforce records. That is only performed once per account

After the RG Email Sidebar Add-In was installed in your MS Outlook Desktop or On the Web, you need to open the Sidebar and log on to the Add-In.

Before you start, please make sure that you have your login credentials for your Salesforce and MS Exchange or Office 365 services at hand.

 

1. Open the Sidebar

  • click the Open RG Email Sidebar button in MS Outlook Desktop ribbon

 

  • or, if you are using Outlook on the Web (outlook.com, outlook.office.com, outlook.live.com), refer to this article to learn how to open the Sidebar.

 

2. Logging on to RG Email Sidebar

Note

Note that your data transferred via RG Email Sidebar as well as your service access credentials are secured and are never shared or stored anywhere, according to Revenue Grid Privacy and Security principles.

Next, log on to RG Email Sidebar using ordinary Salesforce logon, Salesforce Sandbox logon, or My Customer/Partner Community logon.

Tip

In the latest product updates, for Enterprise RGES customers this step can also be performed for multiple end users in bulk, by the local RGES Admin. See this article for more information.

      2.1. Ordinary Salesforce account logon:

            2.1.1. Click the Connect to Salesforce button. A browser window with Salesforce OAuth page will be opened.

>>> Click to see a screenshot <<<

 

            2.1.2. Enter your Salesforce credentials on the page or select a previously saved account’s username and click Log In.

>>> Click to see a screenshot <<<

 

In the screenshot above, a standard Salesforce login window is shown. Note that this OAuth window may look slightly differently, according to your Salesforce customization.

Note

At this point you may also need to confirm this access via Salesforce 2-factor authentication.

      2.2. To log on with Salesforce Sandbox (an isolated environment with Salesforce data used for CRM system tests, learning how to use Salesforce, or experimenting with its features):

            2.2.1. Click the Connect to Salesforce Sandbox button. A browser window with Salesforce OAuth page will be opened:

>>> Click to see a screenshot <<<

 

            2.2.2. Enter your Salesforce Sandbox credentials on the page or select a previously saved account’s username and click Log In to Sandbox.

>>> Click to see a screenshot <<<

 

      2.3. To log on with your Salesforce Customer/Partner Community (under More options v):

Note

This logon method is also used to log on with Single Sign-On (SSO) (the recommended method), if it is configured in your Org. Besides, in some configurations OAuth 2.0 and SSO authentication methods are combined; OAuth 1.0 protocol is not supported by RG Email Sidebar.

 

            2.3.1. Click My Customer/Partner Community.

>>> Click to see a screenshot <<<

 

            2.3.2. Enter your community access URL or your special access link in the box and click the button My Customer/Partner Community below the box.

>>> Click to see a screenshot <<<

 

            2.3.3. Enter your community logon credentials or select a previously saved account’s username and click Log In on the community OAuth page that opens in your web browser or perform a Single Sign-On logon according to your SSO provider’s procedure.

>>> Click to see a screenshot <<<

 

In the screenshot above, a standard Salesforce login window is shown. Note that this OAuth window may look differently, depending on your Salesforce configuration.

            2.3.4. Next, you need to accept granting RG Email Sidebar permissions to work with Salesforce data by clicking Allow in the following dialog window:

>>> Click to see a screenshot <<<

 

Tip

in addition, from this logon page you can access a test RG Email Sidebar environment prefilled with sample data. Refer to this article for more information.

In the latest RG Email Sidebar updates logging on will be followed by a dialog window for authorizing RGES Add-In’s access to MS Exchange data, this way allowing to skip setup stage III: Authorizing Mailbox Access for RG Email Sidebar Add-In (see below).

 

3. Activate Revenue Grid synchronization

Set up Revenue Grid synchronization by authorizing it to access your MS Exchange / Office 365 data. Follow the steps described in this article to do that.

Important

If you are using several different email boxes for your correspondence (not aliases), make sure to authorize RGES Sync for the same email box as one for which you installed the Add-In, otherwise the Sync engine functions will work incorrectly even though RGES Sync will appear to be running.

Tip

Refer to this article to learn what emails and calendar items you have in MS Exchange / Office 365 will be auto-saved in Salesforce if you enable the corresponding settings (calendar items auto-saving, emails auto-saving) after setting up Revenue Grid synchronization.

Important

Please note that if step ( 3 ) is skipped, you will be able to run and use RG Email Sidebar, except for the key functions carried out by RGES Sync.

 


 

III. (Admins only) Install the Managed package in Salesforce

To enable the full scope of features offered by RG Email Sidebar several minor adjustments must be made in your Salesforce Org’s configuration; installing the Revenue Grid managed package allows to accomplish that quickly and effortlessly. Follow the above link for complete information about the package.

 

Note

RG Email Sidebar is based on the following fundamental principle: one email account is connected to a single Salesforce account. Therefore, no more than one business email account can be connected to a Salesforce account; for the same reason, several Salesforce accounts cannot be connected to a single email account via RGES.
However, if such scenario is required, as a workaround you can set up your email accounts each connected to a separate Salesforce account within the same Org.
Also note that RGES can automatically recognize and match different MS Exchange / Office 365 aliases used for the same email account

   


Get back to us
We would love to hear from you

Name:

E-mail:

Question or comment: