Revenue Inbox for Salesforce Frequently Asked Questions (FAQs)¶
1. What is Revenue Inbox for Salesforce?¶
Revenue Inbox is an app for MS Outlook App or Web and Gmail that brings the power of Salesforce right into your mailbox. It is a smart portal embedded into your personal email program, available from inside your email box, calendar, contacts and tasks tabs.
Note that RI is not a standalone application: it is installed in MS Outlook Desktop, Web, or Mobile implementation, or in the Chrome browser. Revenue Inbox provides access to Salesforce from MS Outlook, Office.com, and Gmail/Google Workspace (G Suite), conveying all required details about to an email, task, or calendar item in real time. It allows to complete typical business communication and CRM tasks with maximum effectiveness without ever leaving your email box to navigate to Salesforce.com.
Hosted on secure Microsoft Azure cloud infrastructure, Revenue Inbox automatically synchronizes contacts, tasks, calendar events, etc. with Salesforce, also applying customized filters (views), user data access permissions, custom objects, and other peculiarities of your Org’s configuration. Owing to 24/7 server-side data synchronization, all your devices connected to your mail sever can share data in Salesforce via RI Sync, and you can view, manage, and update this data via RI Sidebar installed on a supported platform.
After you install the Add-In and activate the Sync Engine for an email account, they become 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.
Revenue Inbox is a combination of two independent yet complementary components – a server-side synchronization engine and a client-side MS Outlook Add-In / Chrome Extension for Salesforce data displaying and conveying user input. The first part provides smart synchronization tools which allows business data to stay up-to-date across all devices capable to connect to a user’s MS Exchange, Office 365, or Gmail account; whereas the mail app allows you to process all Salesforce object types including custom ones, regulated by a set of customizable parameters.
Being a cloud based application, Revenue Inbox does not require any special security roles or authorizations to be configured in your company’s IT infrastructure. Any user in an Org who has an active Salesforce user license and an MS Exchange, Office 365, or Gmail account can set up Revenue Inbox without involvement of Salesforce and Exchange Admins, using OAuth and Single Sign-On mechanisms.
However, if a customer requires that, Revenue Inbox can be mass-deployed for multiple end users by the local Admin.
2. On what platforms can I run Revenue Inbox for Salesforce?¶
Revenue Inbox is a multiplatform cloud solution, you can run it in MS Outlook App or Web on Windows, MacOS, iOS, Android, or in a supported web browser on any platform. The full scope of Revenue Inbox features unfolds when it is used with MS Outlook 2013, 2016, 2019 on Windows or MacOS and in Office 365 running in a browser, however the product also provides solid and convenient Salesforce interaction when used on mobile platforms.
In addition, it is fully compatible with Gmail mailboxes via Revenue Inbox Chrome Extension, which you can use in Google Chrome browser or a Chromium based browser running on any supported platform on different kinds of devices.
Note that RI user interface (Sidebar) is rendered identically in all its implementations: the “cloud” implementation in MS Outlook Desktop, Outlook.com and Office 365 as well as in the “desktop” implementation. The Gmail implementation (Chrome browser Extension) is also mostly identical.
Essential system requirements for running Revenue Inbox¶
|Operating system(s) with version number||Windows XP Service Pack 3 or above
Mac OS X 10.5 or above
Mac OS X Catalina
|Hard drive free space||1 Gb||5 Gb|
|RAM||256 Mb||2 Gb|
|Processor and speed||500 MHz||2 GHz|
|LAN speed||1 Mb/s||5 Mb/s|
|Other software||Microsoft Outlook 2013 and later
or a supported browser (see below)
|MS Office 365
MS Outlook 2019
or a supported browser (see below)
|Server-side||MS Exchange 2016 or 2019 or Office 365 (with Exchange Online)
MS Exchange 2013 has less stability for Revenue Inbox use with Outlook on the Web, but works fine with Outlook Desktop/Mobile implementations
MS Exchange 2010 is no longer officially supported
|MS Exchange 2019 or Office 365 (with Exchange Online)|
Supported browsers (with Outlook on the Web)¶
|MS Edge (current and prior versions)||Compatible
See this article for MS Edge Chromium specifics
|Google Chrome (current and prior versions)
and Chromium-based browsers
|Opera (current and prior versions)||Compatible|
|Safari (current and prior versions)||Full Support|
|MS Internet Explorer||v. 10 – Compatible
v. 11 – Full support
3. How can I install the product? Is there a trial version to try out?¶
Refer to the following articles to learn how to install and run Revenue Inbox:
RI Setup by individual end users¶
- In Office 365
- All configurations on MS Outlook for Windows
- The special “desktop” (.msi) implementation
- The Chrome Extension to work with Gmail or Google Workspace (G Suite)
- In MS Outlook for iOS and Android
Bulk RI Setup by local email/Salesforce Admins¶
- All available deployment scenarios
- Mass RI Add-In deployment in Office 365 in your Org
- Mass RI Add-In deployment in MS Exchange in your Org
- Mass RI Sync authorization in your Org
- Mass RI Chrome Extension (Gmail / Google Workspace (G Suite)) deployment your Org
Revenue Inbox Trial version¶
There is a trial .MSI (Desktop) version of the product available for download; the trial’s limitations: this version is identical to the full one but it is limited to 14 days of use (extendable by request sent to our Sales team). If you don’t want to use an actual Salesforce account or Salesforce sandbox to try out Revenue Inbox features, you can run it with sample data.
The free version of Revenue Inbox Add-In¶
Besides the trial version which you can download via the above link, there is the free version. This version is activated in one of the following cases: if Revenue Inbox is installed for an email account without purchasing a license or if the license of an installed Revenue Inbox copy expires. This version has no access to RI Customization and Synchronization settings and its synchronization is suspended.
I’ve installed Revenue Inbox Add-In and I’m prompted to log in into it. What login and password should I enter? I wasn’t provided with any special login credentials for RI.¶
Revenue Inbox login is based on Salesforce Single Sign-On authentication, the credentials to be used is your Salesforce login and password; they are entered into the Salesforce SSO window which is opened in your browser.
4. Is data processed via Revenue Inbox transferred and stored securely? What servers and protocols are used by the product?¶
Revenue Inbox does not store any correspondence or CRM data processed over it, it solely transfers data between your email server and Salesforce over secure Microsoft Azure protocols with TLS 1.2 encryption; your email service and Salesforce access credentials are not kept in Revenue Inbox, the product’s interactions with your email server and Salesforce are authorized via OAuth 2.0 protocol on Revenue Inbox setup. Refer to this article for more information on our Privacy and Security standards. Microsoft Azure Datacenters involved in data transfer over RI are located in Southeastern USA. Note that Revenue Inbox servers’ location does not noticeably affect processed email and CRM data transfer speed regardless of the end users’ location, since their mail servers belong to Microsoft Exchange/Office 365 or Gmail infrastructures and all data transfer is carried out on the server side.
5. Does the ongoing Revenue Inbox synchronization consume much Internet traffic?¶
Since data exchange is carried out between your email server and Salesforce server while your local email client and the Add-In / Chrome Extension only serve to display data and convey your choices and actions, synchronization does not consume any noticeable amount of your local internet traffic. See this article for more information on RI Sync engine’s functions.
6. Does the ongoing Revenue Inbox synchronization generate many Salesforce API calls?¶
7. Revenue Inbox creates multiple copies of the same calendar event in on sync sessions, what should I do to fix that?¶
This behavior and other kinds of unexpected sync behavior usually indicate that there is other software transferring data between your email service and Salesforce API, causing data transfer conflicts with Revenue Inbox. When you are using Revenue Inbox there should be no other software running that performs data transfer between your email service and Salesforce API (e.g. Salesforce Lightning sync, Salesforce Inbox, Salesforce for Outlook, etc.) Running different MS Exchange – Salesforce sync applications simultaneously will cause sync conflicts and items duplication. If you encounter this kind of unexpected behavior, please check that with your Salesforce admin or, if you are a Salesforce admin, check for such software in the following places:
After you find apps which cause sync conflicts, please refer to this Salesforce Help article to learn how to disable them. Please also note that apps which use Salesforce API but do not exchange data between Salesforce and MS Exchange/Office 365/Gmail will not cause sync conflicts.
8. How is Revenue Inbox priced? What subscription plans are available? Are there custom tailored solutions available?¶
Please refer to this article for detailed information on product plans and pricing. We also offer custom modifications of Revenue Inbox to suit our Enterprise customers’ preferences.
You can get the Add-In from AppSource or AppSource; don’t hesitate to contact our Sales directly with any specific questions.
9. We installed the MS Outlook Add-In / Chrome Extension and activated the Sync Engine. What is the difference between these two components, what functions do they have?¶
See this article for in-depth information on the two Revenue Inbox components.
10. Can I use the same Salesforce and Revenue Inbox account to process messages from my corporate mail via the MS Outlook App or Web Add-In / Chrome Extension and from my Gmail via the Chrome Extension?¶
No, emails and events processing as well as Revenue Inbox sync are tied to a specific email account, so you would need to create two separate accounts within your Salesforce Org to do that.
11. Things are clear about creating new Salesforce records, updating them, establishing associations among records, and searching among them… how can I delete a Salesforce record via the Outlook Add-In / Chrome Extension?¶
To prevent unintended data deletion, Revenue Inbox does not offer a direct possibility to delete a record from Salesforce, the user-initiated ones (but carried out by RI Sync engine) being
- calendar event deletion syncing
- one-way synchronization
- duplicate records merging via the Add-In/Extension, which is based on Salesforce records merging
As a workaround, to quickly delete an email, event, or another object from the CRM, you can open it in Salesforce by clicking the icon next to a business or person object related to it in RI Sidebar and quickly delete it directly in Salesforce.
12. How does Revenue Inbox match MS Exchange emails, calendar items, tasks, and contacts with Salesforce objects?¶
Please see comprehensive information on objects/fields matching patterns in this article.
13. Dedicated Salesforce Emails, Salesforce Tasks, Salesforce Contacts folders or categories in email client created by RI Sync¶
What are the “Salesforce Emails”, “Salesforce Contacts” folders and the custom “Salesforce” and “Salesforce Unsync” categories created in my MS Outlook or Gmail client after Revenue Inbox synchronization is activated? Why do they appear again if I remove them, even though the RI Sidebar is not opened or the Add-In is disabled?
These dedicated folders and custom categories are created in MS Outlook or Gmail on the very first RI sync session; to get an email, calendar item, contact, or task saved in Salesforce by RI synchronization, you need to move it to the corresponding custom folder or assign it the custom Salesforce category in MS Outlook.
This items handling mechanic is essential for RI synchronization, that’s why these folders and the category are automatically re-created on the following sync session, if they were removed. These folders and the category work completely independently from the Add-In; they also might temporarily disappear after customization reapplying, before synchronization creates them afresh.
14. What onboarding materials / user guides are available for the product?¶
This Knowledge Base is the ultimate source of general information as well as specific guidelines, in-depth explanations, and administration instructions for Revenue Inbox for Salesforce. A selection of Knowledge Base articles can be exported to .docx or .pdf documents for your specific needs, upon request.
15. Can RevenueGrid.com conduct Revenue Inbox use trainings for our company?¶
Remote trainings as well as onsite trainings (for Enterprise customers) can be arranged. Contact our Support Team to request product training.
16. I’ve added a field to an object in Salesforce and I do not see this field in Revenue Inbox, how to enable it?¶
To include the new added field into Revenue Inbox processing scope, open RI Customization page and enable the added object field via its central pane. Also note that after you add a new object field in Salesforce, it may take up to 4 hours for the new field to be added to RI Customization central pane; if you want to force this update, click Save at the top of Customization page without making any changes - that will initiate refreshing of objects and fields in RI Customization configuration.
17. Our Org uses custom Salesforce object(s) and I do not see these objects in Revenue Inbox, how to enable them?¶
Please refer to this Knowledge Base article for complete information on how to add custom objects to RI handling scope.
18. I have made adjustments in a calendar item in MS Outlook/Gmail calendar (or in Salesforce), but they did not get mirrored on the other end. How to fix that?¶
Calendar items syncing is carried out by RI Sync Engine on sync sessions performed on the server side. The regular sync sessions interval is 30 minutes, however, in the latest RI updates calendar items insta-sync was introduced, so extra sync sessions get triggered on calendar items creation, updating, or deletion (if they are marked with the custom Salesforce category) – therefore these calendar updates will be synchronized in Salesforce within 1-3 minutes.
What to check if calendar item update on either side is not reflected on the other:
- Try forcing RI sync; make sure that RI sync is set up and active (not paused or suspended due to an error)
- Check that the calendar item being synced does not belong to the exceptions which do not get mirror-synced
- Calendar items which RI sync cannot process:
• MS Exchange/Office 365 all-day events which have a duration of over 24 hours (a Salesforce limitation)
• Series of recurring all-day events
• Calendar items set in problematic time zones
- In addition, refer to this article for detailed information on calendars syncing exceptions
- Finally, there are several customer-specific one-way synchronization options – check with your local Salesforce admin whether that might be the case in your Org
19. I use several email accounts for my business correspondence and I want to connect both of them to my Salesforce account? How can I do that?¶
Revenue Inbox is based on the following fundamental principle: one email account is connected to one Salesforce account. Therefore, the above scenario is impossible to implement. For the same reason several Salesforce accounts cannot be connected to a single email account via RI.
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 (requires an additional Salesforce and Revenue Inbox license). The same concerns using RI Chrome Extension for Gmail.
Also note that RI can automatically recognize and match different MS Exchange/Office 365 alliases used for the same email account.
20. Can I use Revenue Inbox if I use MS Outlook Desktop to work with Gmail emails/events?¶
This RI use scenario is no longer officially supported. We recommend you to use Gmail/Google Workspace (G Suite) web interface and RI for Salesforce and Gmail Chrome Extension instead.
21. A Lead/Contact sometimes responds to an email thread using one’s secondary email address (which is also registered in my Salesforce). Is there a way to share these responses in the same thread?¶
22. My mobile device/workstation sometimes loses Internet connection, can I still use Revenue Inbox?¶
Revenue Inbox collects user input (selections, actions, fields entry and so on) via their email clients – using the Add-In or Chrome Extension, and transferring of that data in real time requires availability of Internet connection.
At that, RI Sync engine works on the server side and the mechanisms used for sharing items in Salesforce over RI Sync are more fundamental, based on MS Outlook client ↔ MS Exchange/Office 365 server data transfer. If you share an email or calendar item (also an MS Outlook Task or Contact) from your email client using the custom Salesforce folder or category, the moment your client gets connected to your mail server this item’s syncing in Salesforce will be initiated.
This way, you can mark items to be saved while offline and as soon as connection becomes available, their syncing will start. See the following articles to learn how to save items via the dedicated folder/custom category:
23. Why does Revenue Inbox always link saved Activities (emails and calendar items) to an Account?¶
This mandatory pattern is based on a Salesforce requirement, see Salesforce Help article 1 and article 2 for more information. The exception is Tasks, EmailMessages, or Calendar Events linked to a Lead, since Leads require no Salesforce Account registration.
24. Does Revenue Inbox allow handling items from an Exchange shared mailbox?¶
Yes, most use scenarios are supported for Exchange shared mailboxes. See this article for more information.
25. How to increase the size of Revenue Inbox Sidebar font and controls to make it more accessible for users with lower vision?¶
You can “zoom in” the Sidebar the way you zoom in web pages. To do that, click on the Sidebar, press the Control (Ctrl) button and scroll up the mouse wheel. All Sidebar components will be expanded and slightly re-arranged. To accommodate the expanded controls in the Sidebar’s pane, you can also stretch the Sidebar sideways: hover the cursor over the left-hand edge of the Sidebar so it looks like this ⇼, then hold the left mouse button and stretch the Sidebar to the left. Presently, the zoomed in Sidebar layout is not kept for different selected items.
26. I have activated Revenue Inbox Sync, but Sync engine functions appear not to be working.¶
3. In case Sync has been activated just recently and it appears to be up and running but Sync functions are not carried out, check that it was activated for the same email box as one for which you installed the Add-In
27. Can Salesforce data corruption occur under any circumstances when it’s handled by Revenue Inbox, e.g. when my Internet connection is unstable?¶
Data processing and transfer via Revenue Inbox excludes the possibility of data corruption, the only known case of excessive data creation in Salesforce by RI Sync occurs in the situation described in the entry 7 of this FAQ article.
28. My company purchased several licenses of Revenue Inbox. How can I manage various aspects of the product’s functioning, e.g. the end users’ RI Sync and their access to Customization settings, or adjust the under-the-hood settings?¶
That can be done via Revenue Inbox Admin panel. Admin panel access is available exclusively for Enterprise RI customers. To access the panel, check with your local administrator whether they have the access URL and credentials provided to them on product purchase. Or, if you are the administrator or account owner, send us a corresponding request to gain the access.
29. What Exchange data access permissions (Admin consent) does Revenue Inbox require? Is it possible to limit this App to be used only by specific users or groups of users in our company?¶
Revenue Inbox can be granted permissions to work with your Org’s Exchange data via consent settings applied for:
A. For all users in the Org (Admin consent permissions)
B. For individual users to have a choice (User consent permissions)
C. The Admin sets up RI and enables self-service access or assigns the users directly to the application. The Admin can grant consent on behalf of all users in this directory, ensuring that the end users will not be requested to give consent to run Revenue Inbox
The following mail server data access permissions settings are required:
For EWS mail server connection¶
This mail server connection type is currently the default one for both MS Exchange mail servers. See complete information on this connection type in this article. This connection type’s limitation is that it does not allow to configure data access permissions in a flexible way: it allows either all user Email, Calendar, Tasks, and Contacts data access for RI or none. Therefore, for this connection type no limited data access deployment options are available to meet special security demands which some Enterprise environments may have. The alternative that includes this possibility is MS Graph connection for O365, see the next FAQ section for details.
EWS-specific Admin Consent permissions set (EWS.AccessAsUser.All):
>>> Click to see a screenshot <<<
MS Graph connection type can be configured to provide access to very different end user data types, ensuring maximum flexibility and security; however, presently, it does not support all Revenue Inbox functions.
MS Graph Admin Consent permissions
>>> Click to see a screenshot <<<
MS Graph User Consent permissions
>>> Click to see a screenshot <<<
30. I’ve opened Revenue Inbox Sidebar and cannot see the icons Book Me, Time Slots, Engagement, etc. at the bottom. How to fix that?¶
See this article to learn how to manage the Smart Action icons via RI Customization settings.
Besides that, note that the Book Me and Time Slots actions are not displayed if you select a meeting invite message in Inbox or Sent folders.
31. Does Revenue Inbox allow handling items for an Exchange Delegated Access use?¶
Some use scenarios are supported for MS Exchange Delegate Access configurations. See this article for more information.
32. When I try to authorize Revenue Inbox to access my Office 365 data, I get a “Need Admin Approval” error. How to tackle that?¶
See this article for instructions how to resolve this issue.
33. I synchronized an Outlook calendar Meeting / Appointment in Sales by mistake, how can I delete it via Revenue Inbox?¶
Revenue Inbox can delete Salesforce Events it created to match synced Outlook calendar items. To initiate deletion of a matching Salesforce Event, simple assign the custom Salesforce Unsync category to the item in Outlook calendar. The Salesforce Event will be deleted not immediately but within 1 to 30 minutes on the following Sync session.
34. How does Revenue Inbox convey Events created or modified in Salesforce to MS Outlook or Gmail calendar?¶
Such Events are handled automatically by RI Sync engine. See the following articles for all details:
35. For security considerations our company uses Shield Platform Encryption. Can we still use Revenue Inbox?¶
Revenue Inbox is compatible with some SPE deterministic encryption setups; that depends on what objects get encrypted and what algorithm is applied. Please submit a request with these details to our CSM team to find out if your SPE configuration is supported.
36. Some Revenue Inbox Sidebar elements become completely unclickable in MS Outlook (Desktop) on Windows OS. How to fix that?¶
The issue where important Sidebar elements become unclickable, e.g. the Save or Create button, has a technical cause on Microsoft Outlook side. Specifically, due to the ongoing Microsoft transition from the old MS Edge to Chromium MS Edge some MS Outlook for Windows versions have an Outlook frames rendering issue with MS Edge. Microsoft is planning to roll out a complete solution in a future MS Windows update.
37. What is the purpose of each Salesforce managed package offered by Revenue Grid to support its solutions? Are these mandatory to install?¶
There are 3 free Salesforce managed packages that we developed for our customers and keep improving to ensure full Revenue Grid components compatibility with Salesforce for a seamless integration experience. All managed package updates meet Revenue Grid Data Privacy and Security standards and get reviewed by Salesforce AppExchange specialists. Each package serves to perform Revenue Grid functions and expand Salesforce functions.
A. The Revenue Inbox + Revenue Guide managed package. It is also used to configure Revenue Grid widgets in Salesforce interface. This package is mandatory to install in a Salesforce Org to use the solutions
B. The managed package required for unrolling Revenue Engage functions. This package is mandatory to install in a Salesforce Org to use the solution
We would love to hear from you