How to Install and Run SmartCloud Connect (all configurations for MS Exchange or Office 365)¶
If you are a local administrator rolling out SmartCloud Connect for multiple users in your organization, you can make use of Add-In mass deployment procedures.
Refer to this article for quick steps on a typical SmartCloud Connect installation Office 365; to learn how to run SmartCloud Connect with Classic interface view refer to this article. If you want to use SmartCloud Connect with Gmail, refer to this guide.
I. SmartCloud Connect Add-In Installation¶
1. Installing SmartCloud Connect Outlook Add-In (standard web/cloud installation)¶
SCC Outlook Add-In follows a standard pattern for MS Outlook cloud addins installation:
● In MS Outlook Desktop, click the File tab in the ribbon and then click Manage Add-ins at the bottom of the tab. On the outlook.office.com add-in management page that will be opened in your browser, click Find more add-ins for Outlook at the Office Store…, enter SmartCloud Connect in the Search the Office Store search box and select SmartCloud Connect for Salesforce.
● 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
3. In the menu that appears, scroll down and click Get Add-ins
>>> Click to see an animation <<<
4. Enter SmartCloud Connect in the Search add-ins input box on the upper right corner of the “Add-Ins for Outlook” dialog window and click Add under SmartCloud Connect for Salesforce in search results
5. Next, you need to confirm installation by clicking Continue in the following dialog
Also note that SmartCloud Connect for Salesforce (web/cloud implementation) can also be installed from an .XML Outlook Add-In manifest file or URL provided by your local SCC Admin or Invisible.io, refer to this article for more information.
After you install the Add-In in either one of these ways, it will also be added to your MS Outlook (Desktop) with the corresponding MS Exchange user account logged in.
Before using SmartCloud Connect in MS Outlook Desktop on Windows, please make sure that you have Internet Explorer 11 installed, since it renders SmartCloud Connect Sidebar in MS Outlook Desktop.
The other option is installing SmartCloud Connect Add-In Desktop implementation from an .MSI File (Windows OS only)¶
Alternatively, you can install the Desktop (MSI) version of the Add-In.
This Add-In installation method is only available for MS Outlook 2010, 2013, 2016, 2019 (Desktop) for Windows.
Only this Add-In implementation is compatible with MS Outlook 2010. Please refer to this article for a detailed comparison of the two implementations of SmartCloud Connect Add-In.
SmartCloud Connect for Salesforce can also be installed from an .MSI file instead of standard web installation – as a custom Enterprise edition installation package tailored for your company’s needs by Invisible.io or as a regular or trial installation package.
You can download the regular .MSI package here by selecting Download for Outlook.
This way you will get the 32-bit installation package by default; if you run it and you are using the 64-bit version of MS Outlook, you will be provided with the link to 64-bit SmartCloud Connect installation package.
To install the Add-In, run the downloaded.MSI package and complete the simple three-step installation procedure. SmartCloud Connect will be installed in the ‘%systemdisk%\Users\%username%\AppData\Roaming\Invisible.io\SmartCloud Connect Add-In‘ folder, taking around 28-40 Mb of HDD space.
Preconditions for installing the .MSI package:
- having admin permissions on your workstation including system disk write permissions
- MS Outlook 2010-2016 installed on your system
The essential differences between the web/cloud and .MSI versions installation are summarized in the below table:
||Web/cloud Add-In Installation||
MSI Add-In Installation
||Can be installed in different systems and configurations: MS Outlook for Windows, MS Office 365 in a browser, Outlook.com in a browser, MS Outlook for Mac, MS Outlook for iOS, MS Outlook for Android.||Can only be installed in MS Outlook Desktop running on MS Windows.|
||Is rolled out via MS Exchange / Office 365 add-ins management panels.||Is installed using mass-deployment tools by the local administrator with a single customization set for all users.|
Instant version updates from the cloud.
Centralized updates rollout by the local administrator.
Before using SmartCloud Connect in MS Outlook Desktop on Windows, please also make sure that you have Internet Explorer 11 installed, since it renders SmartCloud Connect Sidebar in MS Outlook Desktop.
II. SmartCloud Connect Logon¶
SCC logging on is not instant: depending on the number of email messages in your mailbox and items in your calendar it make take several minutes to log on, since on logging on SCC needs to match all your existing correspondence and calendar items with your Salesforce records. That is only performed once per account.
After the SmartCloud Connect Add-In was installed in your MS Outlook Desktop/Web or Office 365, 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 SmartCloud Connect button in MS Outlook Desktop ribbon
- or, if you are using Outlook.com or Office.com, refer to this article to learn how to open the Sidebar.
2. Logging on to SmartCloud Connect¶
Note that your data transferred via SmartCloud Connect and or your service access credentials are secured and are never shared or stored anywhere, according to Invisible.io Privacy and Security principles.
Next, log on to SmartCloud Connect using ordinary Salesforce logon, Salesforce Sandbox logon, or My Customer/Partner Community logon.
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.
2.1.2. Enter your Salesforce credentials on the page or select a previously saved account’s username and click Log In.
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.
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 open
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.
2.3. To log on with your Salesforce Customer/Partner Community (under More options v):
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 SmartCloud Connect.
2.3.1. Click My Customer/Partner Community.
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.
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.
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 SmartCloud Connect permissions to work with Salesforce data by clicking Allow in the following dialog window:
in addition, from this logon page you can access a test SmartCloud Connect environment prefilled with sample data. Refer to this article for more information.
In the latest SmartCloud Connect updates logging on will be followed by a dialog window for authorizing SCC Add-In’s access to MS Exchange data, this way allowing to skip setup stage III: Authorizing Mailbox Access for SmartCloud Connect Add-In (see below).
3. Activate SmartCloud Connect synchronization¶
Set up SmartCloud Connect synchronization by authorizing it to access your MS Exchange / Office 365 data. Follow the steps described in this article to do that.
Refer to this article to learn what emails and calendar items you have in MS Exchange/Office 365 will be auto-shared in Salesforce if you enable the corresponding settings (calendar items auto-sharing, emails auto-sharing) after setting up SmartCloud Connect synchronization.
Please note that if step ( 3 ) is skipped, you will be able to run and use SmartCloud Connect, except for the key functions carried out by SCC Sync.
III. (Admins only) Install the Invisible Suite package in Salesforce¶
To get enabled the full scope of features offered by SmartCloud Connect several minor adjustments must be made in your Salesforce configuration; the Invisible Suite installation package allows to accomplish that quickly and effortlessly. Please follow the above link for complete information about the package.
SmartCloud Connect 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 SCC.
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 SCC can automatically recognize and match different MS Exchange/Office 365 alliases used for the same email account.