Skip to content

The Updated Save Email/Save Event Dialogs

The latest SmartCloud Connect updates feature a new Save Email in Salesforce / Save Event as an Activity in Salesforce dialog.

The dialog appears when you select an email or calendar item in MS Outlook/Outlook.com or Gmail and click the Save button in SCC Sidebar in order to get the item shared in Salesforce. Refer to the articles on sharing emails and syncing calendar items for more details.

Save Email dialog

Via this dialog you can:

  • search in Salesforce and manage people and business object(s) you want to link to the matching Task or Email message object in Salesforce
  • set the resulting Salesforce Task‘s Priority and Status and modify its Subject, if necessary. Or, if Salesforce Enhanced email is enabled in your Org, the resulting EmailMessage object‘s Subject
  • mark the attached file(s) you want to share in Salesforce along with the email, if any; modify the files’ names, if necessary
  • define if you want to auto-share in Salesforce future emails in the same correspondence thread (the Auto-save messages in this thread? checkbox). See this article for more information.

 

 

To proceed with saving, you need to select People Objects (WhoId) and Business Objects (WhatId) to be linked to the shared email in Salesforce under Linked records – unless the relevant objects have already been retrieved and added by SCC initial search. Use the Search Salesforce records field to find these objects in Salesforce and select them; to remove an object from the list, click the x icon on the right-hand side.

Note that this field is now unified, used for both these object classes. To ensure proper linking according to your SmartCloud Connect settings and Salesforce configuration, the dialog indicates it if there are conflicts in linking of selected objects.

Next, under Attachments, you can select files attached to the email to be shared in Salesforce along with it, including an exact copy of the message in .eml format. Refer to this article for more information. Note that you can also change the files’ names on sharing, by clicking the pencil (Edit) icon next to their names.

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 SCC Admin.

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.

 

Finally, you can edit the values in Other fields, these are some of the key fields of the corresponding Task or EmailMessage objects created in Salesforce.
By default, for Task objects you can edit the Subject, Priority, Status (set to Completed if you do not prefer to set another value), and for EmailMessage objects you can edit the Subject field.

Tip

You can add some more editable fields to the dialog via SmartCloud Connect customization settings. There you need to select the Task or EmailMessage object type respectively, and then in the object’s Detailed view mark the fields you want to edit via the dialog as Important.

 

In addition, if Automatic Sharing of Email Threads is enabled in your SCC Sync settings, you can select the Auto-save new emails within this thread checkbox at the bottom of the dialog to get all future emails from/to this correspondent shared in Salesforce automatically, without your involvement.

After populating all necessary fields, click the Save button in the bottom right corner of the dialog to share the email in Salesforce.

When the email is successfully shared in Salesforce, a success toast notification pops up, signalling 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 SCC synchronization is active, the user-side 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 following sync session (within 1-30 minutes), unlike messages opened in Read mode, which are saved immediately.

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.

 

Special considerations: what combinations of objects can be linked to shared emails

Case 1. If Allow creating duplicated emails is enabled in SmartCloud Connect sync settings, up to 16 objects of different types can be linked via the dialog, the extra objects actually being linked to the clones of the email created in Salesforce by SmartCloud Connect.

 

Case 2. Allow creating duplicated emails is disabled, Salesforce Enhanced email is not enabled, and a Lead is selected to be linked. In this case no other objects can be linked, according to the general Leads processing logics in Salesforce. Similarly, if any other object type was selected, no Lead can be added for linking.

And if a Contact was selected to be linked, no other People objects (WhoId) can be added but Business object can.

 

Case 3. If Salesforce Enhanced email is used in your Org and EmailMessages type was enabled in SCC Customization settings, and therefore your emails are saved in Salesforce as EmailMessage objects instead of Tasks. Plus Allow creating duplicated emails (see Case 2) is disabled.

In this scenario, your shared emails can be linked to a single People object (WhoId) only (a Lead or Contact) and also to multiple Business objects (WhatId).

   

Save Event Dialog

The Save this event to Salesforce dialog appears when you open a sent calendar item in MS Outlook (or Gmail) calendar and click the Save button in SCC Sidebar. It is used to initiate the item’s synchronization in Salesforce, linked to relevant People and Business objects.

Important

Note that calendar items can only be synced with Salesforce after they are sent.

To proceed with saving, you need to select People objects (WhoId) and Business objects (WhatId) to be linked to the synced calendar item in Salesforce under Linked records – unless the relevant objects have already been retrieved and added by SCC initial search. Use the Search Salesforce records field to find these objects in Salesforce and select them; to remove an object from the list, click the x icon on the right-hand side.

Note that this field is now unified, used for linking objects from both these categories. Since, unlike a Task or EmailMessage, a Salesforce Event can be linked to a number of Business and People objects, there are no linking conflicts/limitations applicable for this field.