Skip to content

How to Install and Run SmartCloud Connect (all configurations)

Important

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 mechanisms.

Refer to this article for quick typical SmartCloud Connect installation steps in Office 365; to learn how to run SmartCloud Connect with Classic interface view refer to this article.

I. Signing Up for a SmartCloud Connect Account

SmartCloud Connect for Salesforce works with Salesforce CRM and MS Exchange / Office 365 email services, and each of these systems requires access authentication to be set up for the Add-In to work with their data.

To start using SmartCloud Connect, you first need to sign up for a SmartCloud Connect account. To do that, open this link and follow the wizard instructions which will guide you through the registration process. Before you start, please make sure that you have a Salesforce account and a MS Exchange or Office 365 account and you got your login credentials for these services at hand.

Once you are set with a SmartCloud Connect account you may proceed with installing the SmartCloud Connect Add-In in your MS Outlook or Office 365.

Note

If you skip SmartCloud Connect account registration or do not complete the registration wizard, you will not be able to share your emails with Salesforce via the Salesforce Emails folder or by assigning them the Salesforce category.

II. SmartCloud Connect Add-In Installation

1. Installing SmartCloud Connect Outlook Add-In (standard web/cloud installation)

If SmartCloud Connect Outlook Add-In was not installed automatically after you signed up for a SmartCloud Connect account, you can install it manually in one of the following ways:

  • 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.

  • Log in to Outlook.com (Outlook on the Web) with your credentials, click Settings (the gear icon) in the upper right corner of the page, select Manage add-ins in the drop-down menu; enter SmartCloud Connect in the Search add-ins search box on the right and select SmartCloud Connect for Salesforce; click Add on the Add-In’s page.

  • Log in to Office 365 with your credentials; in Outlook, click Settings (the gear icon) and then click Manage add-ins. Enter SmartCloud Connect in the Search add-ins search box on the right-hand side and select SmartCloud Connect for Salesforce; click the Add button under the add-in’s description.

  • Furthermore, SmartCloud Connect for Salesforce (web/cloud installation) can be installed from an .XML manifest file or URL, please refer to this article for more information.

Note

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.

Important

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.

2. Installing SmartCloud Connect Add-In from an .MSI File (SmartCloud Connect custom desktop or trial package)

Note

This Add-In installation method is only available for MS Outlook Desktop for Windows.

SmartCloud Connect for Salesforce can also be installed from an .MSI file instead of standard web installation – as a custom installation package tailored for your company’s needs by Invisible Solutions or as a regular 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 .MSI package downloaded and complete the simple three-step installation procedure. SmartCloud Connect will be installed in the ‘%systemdisk%\Users\%username%\AppData\Roaming\InvisibleSolutions\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-installed and .MSI-installed versions are summarized in the following table:


Web/cloud Add-In Installation MSI Add-In Installation
Supported platforms
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.
Deployment method
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.
Updates installation
Instant version updates from the cloud.
Centralized updates rollout by the local administrator.

Note

please refer to this article for a specific feature comparison of the two versions of SmartCloud Connect.

Important

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.

III. SmartCloud Connect Logon

After the SmartCloud Connect Add-In has been installed in your MS Outlook Desktop/Web or Office 365, you need to open the Sidebar and log on to the Add-In. While on stage ( I ) the Sign-Up wizard authorized the Add-In to work with Salesforce and MS Exchange data, at this final stage similar authentication steps are performed to set up SmartCloud Connect synchronization.

1. To open the Sidebar:

  • click the Open SmartCloud Connect button in MS Outlook Desktop ribbon

  • or click SmartCloud Connect logo next to a message opened in Outlook.com or Office 365 and select Open SmartCloud Connect in the drop-down menu

2. 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 differently, depending on your Salesforce configuration.

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):

Note

this logon method is also used to log on with Single Sign-On (SSO), in case it is used in your configuration. 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 SSO 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:

Important

in addition, from this logon page you can access a test SmartCloud Connect environment prefilled with sample date. Please refer to this article for more information.

3. The final setup step to complete before you can use the Add-In is to set up SmartCloud Connect synchronization by authorizing it to access your MS Exchange or Office 365 data. Please follow the steps described in this article.