Skip to content

Ways to Save an Email in Salesforce via SmartCloud Connect

Office 365

Tip

Refer to the first part of this article for an overview of SmartCloud Connect’s save email function that explains the internal mechanisms involved.

Also refer to this article for detailed information on how fields are matched between MS Outlook/Exchange and Salesforce objects.

The pattern of email saving in Salesforce depends on how the message is opened MS Outlook: in Read mode (an email opened for viewing from Inbox, Sent or any other Outlook folder) or in Compose mode (an email opened in a separate window for composing – as a New email created, a Reply/Reply all email, or a Forwarded message) and on whether SmartCloud Connect synchronization is active or suspended for any reason.

Important

Please note that SmartCloud Connect synchronization handles emails only from the Inbox, Sent, and the custom Salesforce Emails folders of your email client.

 

1. Saving an Email When SmartCloud Connect Synchronization is Active

After you click the Save button (manual or direct email saving) in the Sidebar in Compose mode and synchronization is active, the following actions are performed by SmartCloud Connect:

Tip

In the latest SmartCloud Connect updates, after you save an email in Salesforce using the Save button or in any other way, you can quickly open the email’s detailed card as it is saved in Salesforce by selecting the message in MS Outlook and clicking View It in SCC Sidebar’s header.

>>> Click to expand <<<

Depending on related records search results described in the function overview article:

      1.1. If related objects are found:

• If your Org has the Enhanced email Salesforce feature enabled, the message will be saved in Salesforce as an Email message Salesforce object instead of a Task; its special formatting as well as other html-encoded elements like inline pictures, tables, or diagrams will be saved. Refer to this article for information about matching patterns applied on saving.

• Or, if your Org does not have the Enhanced email feature feature enabled, the message will be saved as a completed Salesforce task record in which the main message elements (the sender’s / recipients’ email addresses, sending date and time, subject, the message body, the sender’s signature) are stored as values in its corresponding fields; the special formatting of message body and its signature is not saved, except for the contained links. The task’s Due date field is set to the date when the email was sent or received.

In either case the created email or task object is then linked to related Salesforce records found.

Note

In the updated SmartCloud Connect Adaptive view, there is no drop-down list accessed by clicking ˅ next to Email/Event is not saved at the top of the Sidebar. Instead, relevant records should be selected using the checkboxes put next to records in the Sidebar, or entered in the Save Email/Event as an Activity in Salesforce dialog’s Name and Related To fields.

      1.2. If no corresponding Task or Email message object exists, you will need to create one:
The dialog window Record email as Activity to Salesforce will appear.

To proceed with saving, you need to populate the key record fields in the dialog. These fields are prefilled with data retrieved from the message and related objects search, however you can modify their values according to your preferences. Message Subject, Priority, Status (property of the Task or Email message object being created in Salesforce; it is set to Completed if you do not select another value) and the Name of the primary Contact or Lead record to be associated with the email are mandatory fields; the field Related To (in this field you can specify an additional object to be associated with the email, e.g. an Account or Opportunity) is optional. In addition, please note that you can define the set of editable key (Important or Required) fields included in this dialog in SmartCloud Connect customization settings.

Note

Presently, if Salesforce Enhanced Email is enabled in your Org, emails saved in Salesforce using the Save button in the Sidebar cannot be linked to Lead and Contact objects. However, when an email is shared by SmartCloud Connect synchronization, it will be linked to the relevant Lead or Contact.

Note

In the latest SmartCloud Connect updates the value of the resulting Salesforce Task object’s Status field can also be set in this dialog, provided it was marked as important/required in Customization settings. If the field is included in the dialog and you skip it, the default value will be set (Status: Completed).

Next step, choose which message attachments will be saved along with the record in Salesforce by selecting the checkboxes next to them. Additionally, if Salesforce Enhanced email is not enabled in your Salesforce org and you need to save the special HTML formatting in the email (e.g. tables, diagrams, and so on), or the email’s body exceeds the 32,000 characters limit for a Salesforce object’s comments field, select the checkbox next to {email subject line}.eml to attach the message to created Salesforce task in .eml format - that is an exact copy of the email including technical data and headers; note that you may also rename the file according to your preferences. And the final step, click Save to share this task or email activity object in Salesforce.

Note

An email attachment cannot be saved in Salesforce in the following cases: 1. if it exceeds the file size limit in Salesforce – 25 Mb per file; 2. if the file’s extension was not whitelisted by your local administrator.

Important

Please note that with Salesforce Enhanced email enabled, due to a technical limitation, when you save an email along with its attachments in Salesforce via the Add-In, the created Email Message object’s *HasAttachment” field will not convey accurate status regarding the presence of attachments, so this field/flag should be disregarded.

After the email has been successfully saved in Salesforce, there will appear a success toast notification that the email was saved in Salesforce and (linked to) {number of related records} other objects. Besides, after the email is saved, it will be assigned the blue Salesforce category in MS Outlook.

If synchronization is active, the major differences between saving messages in Read mode and Compose mode is the kind of notification you will get (see the screenshots above) and the fact that messages opened in Compose mode will be saved in Salesforce on the next sync session (within 1-30 minutes), not immediately like messages opened in Read mode.

The Salesforce object created when saving an email is logged in SmartCloud Connect Past activities under Activity Timeline and can be opened in Salesforce directly by clicking the blue Expand icon next to it.

Auto-sharing All New Email Messages in a Thread

Finally, there is an option that allows saving all new messages in a correspondence thread in Salesforce automatically; please refer to this article to learn how to use it.

 

2. When SmartCloud Connect Sync is not Active

If the Save button is clicked and SmartCloud Connect synchronization is not active for any reason:

  • If the message is opened in Read mode (from the Inbox or Sent folder), it will be saved in Salesforce directly following the regular pattern described earlier. However, note that the blue Salesforce category will not be automatically assigned to the email saved this way in MS Outlook if sync is disabled.
  • If the message is opened in Compose mode (that is, it is a new message created by clicking New email, Reply, or Forward in MS Outlook), saving it in Salesforce is not possible until you enable synchronization, or, as a workaround, you could save the message and move it to the Sent MS Outlook folder and then open it in Read mode and save it.
  • Please also note that if you need to save a new calendar entry to Salesforce and sync is not active, saving it is not possible until you enable it. However, if the corresponding Salesforce event record was created earlier, updating it is made directly and does not require synchronization to be running.

 

3. Besides using the Save button, sharing emails in Salesforce can be done in 3 other quick ways

Please note that when you use these quick ways to save an email, the email is saved in Salesforce associated with all related Contact, Lead, Account, or Opportunity (if enabled in sync settings) objects found following the default pattern, you will not be able to choose which specific Salesforce records to link it to.

      3.1. By assigning the Salesforce email category (only messages opened in Read mode; requires sync to be active):

            3.1.1. In MS Outlook, find the email message you want to save in Salesforce.

            3.1.2. Right-click the message and select Categorize > Salesforce. This message category is marked with blue color.

      3.2. By moving the message to the Salesforce Emails custom folder created by the Add-In (only messages opened in Read mode; requires sync to be active):

            3.2.1. In MS Outlook, find the email message you want to save in Salesforce.

            3.2.2. Drag-and-drop the message to your “Salesforce Emails” folder. On the next sync session emails from this folder will be saved in Salesforce and moved to the Sent folder with the Salesforce category assigned.

Note

After an email is saved in Salesforce by SmartCloud Connect synchronization via the Salesforce Emails folder (3.2), it is assigned the blue Salesforce category and moved back to the Inbox or Sent folder respectively.

      3.3. Using the “Quick Save to Salesforce” Button

There is also a single-click way to save a message in Salesforce using the Quick Save to Salesforce button in MS Outlook ribbon.

When you use the Quick save to Salesforce button to save messages opened in Read mode and related records (accounts, contacts, leads, and opportunities (if enabled in sync settings)) are found in Salesforce, saving is performed directly and immediately; its status is shown as notification lines under message subject:

SmartCloud Connect synchronization should be active since such messages are saved in Salesforce on synchronization sessions; it may take up to 10-20 minutes for a message to be saved in Salesforce this way, depending on actual sync interval, connection speed, the number of related objects found.

The following notification line is displayed when the message opened in Compose mode is marked to be saved on the next sync session; the line also lists Salesforce records it will be associated with:

In case related records are not found after Quick save to Salesforce is clicked, there will appear a notification line suggesting to create a corresponding Salesforce record first:

If you click Quick save to Salesforce for a message opened in Compose mode and synchronization is not active, the message will not be saved and there will appear the following error notification line:

In addition, in this case a suggestion to enable synchronization will appear in SmartCloud Connect Sidebar in Smart Actions > More… > Observations:

>>> Click to expand <<<