With Groove's server side (background) email and calendar sync, you can ensure that all of your reps activity is being logged back to Salesforce, no matter where they're sending emails or creating events from. That means reps can send and receive emails from their cell phone and still have everything automatically logged back to Salesforce.

We highly recommend you enable our background email and calendar sync and in this guide we'll walk through configuring it.

Note: All of the following settings can be configured by Salesforce/Groove admins on this page.

When Groove syncs emails/calendar events from Google to Salesforce it tries to find related Leads, Contacts and Users in Salesforce by looking at the recipient's or invitee's email address(s).

By default, Groove will sync emails and events to the relevant Lead/Contact using the recipient email address. 

Groove can also sync emails/events to Opportunities and Cases and you can customize how it syncs according to your business process by choosing any of the following options:

Restricted means that Groove will only find opportunities directly associated with a contact via an opportunity contact role. Otherwise, Groove will only extend the search by looking at opportunities that exist under the contact's account.

This option Email Domain Blocklist allows you to specify a list of email domains that are "blocklisted". This means:

You must comma separate the list of domains in this field.

The option Best Match Email Logging controls whether Groove logs the email (if activated) only under the Contacts + Opportunity/Case pair with the highest score or (if deactivated) under every found Contacts + Opportunity/Case pair.

Activating this option will lead to less Email (Task) records being created in Salesforce and possibly more accurate activity reporting. Deactivating this option will lead to a more comprehensive activity history under all possible records but more Email (Task) records will be created.

Note: If shared activities are not activated in your Salesforce org, this option is disregarded and Groove will log and sync emails under every found Contacts + Opportunity/Case pair. This is why we recommend activating shared activities.

It’s very frustrating when reps get those pesky “Message delivery failed” prompts letting them know they sent an email to a bad email address. Now you and your team can keep track of which emails bounced back by having them logged to Salesforce in real time! 

This is an optional setting. If you’d like us to enable “Log Bounced Emails,” please email support@groove.co to get this enabled!
​

If you only want events that are related to a Salesforce contact/record, then you'll want to enable Only sync CRM related events. With this enabled, only events with an invitee that is a contact/lead in SFDC will be synced.

When Groove logs or syncs a calendar event from Google to Salesforce it analyzes the list of invitees in order to find which Leads, Contacts and Users should be added to the event in Salesforce.

This option controls what happens if one of the found Users doesn't have a Groove license assigned to. If this option is activated, all users that don't have a Groove license assigned to won't be added to the list of invitees on the Salesforce event record. Otherwise, all found users will be added.

In order to have all events created in SFDC synced back to Google Calendar, you can follow the process below, which includes one setting from Groove, and one from Salesforce:

If you'd like your users to have the option to only sync certain events back to Google Calendar, you can leave 'Always Mirror Events in Google Calendar' disabled in Groove, and add the field  Mirror in Owner's Calendar  to the event page layout in Salesforce.

By default, only the standard email field on the Lead, Contact and User object are considered when Groove syncs an email/event to SFDC. 

In order to consider support for more than one email, Groove added  a field "Email 2" to the contact and to the lead object (API names are Lead.DaScoopComposer__Email_2__c  and Contact.DaScoopComposer__Email_2__c ).

The option Alternative Email Matching controls whether you want Groove to consider the field Email 2 when trying to find related Leads or Contacts. The lookup logic is using the OR operator (email address is found in the standard Email field OR the Email 2 field).

If you have already added an alternative email field and wish this field to be considered by Groove, you should set up a workflow/field update that populates Groove's Email 2 field with the value of your alternative email field. For all existing records, you should also retroactively copy the value of your alternative email field to Groove's Email 2 field. Salesforce has various different methods for mass updating records, and you can find the details of those here.
​
​Note: Activating Alternative Email Matching will have performance implications if you have more than 300,000 lead or contact records.

We do not recommend to activate Alternative Email Matching if you have more than 500,000 lead or contact records in your org.

The option Best Match Email Logging controls whether Groove logs the email (if activated) only under the Contacts + Opportunity/Case pair with the highest score or (if deactivated) under every found Contacts + Opportunity/Case pair.

Activating this option will lead to less Email (Task) records being created in Salesforce and possibly more accurate activity reporting. Deactivating this option will lead to a more comprehensive activity history under all possible records but more Email (Task) records will be created.

Note: If shared activities are not activated in your Salesforce org, this option is disregarded and Groove will log and sync emails under every found Contacts + Opportunity/Case pair. This is why we recommend activating shared activities.

When Groove logs or syncs emails, it tries to find related Leads and Contacts by matching the email address of the sender or the recipients with Salesforce records.

The option Create Unresolved Items allows you to control what happens if no related record was found. Groove will either (if deactivated) disregard the email or (if activated) create an unresolved item.

Note: that Groove will create a different type of "unresolved item" than what Salesforce calls Unresolved Item. Groove will still create an actual Task record but the fields "Name" and "Related to" will be blank on that record - thus the Task record is not added to any activity history. Users can view all their "Groove Unresolved Items" in a dedicated Visualforce page.

Note: This is only relevant if a users email address they are sending/receiving emails from is different then their email address in SFDC.

When Groove's background sync tries to log an email/event into Salesforce, the user the activity is 'Assigned To' get's determined by the following logic:

If a users email address in SFDC does not match the email address they are sending/receiving emails from, we recommend you configure the following fields on their user record in SFDC (note, these fields were added by the Groove managed package and may need to be added to the page layout):

Once these fields are configured, Groove will also take them into consideration when determining who to assign the activity to.

Activity type- Emails are logged with the type of 'Email', and calendar events are logged as whatever the default value for Event type (Setup | Customize | Activities | Event Fields) is in SFDC

Task subtype- 'Email'

Event subtype - 'Event'

1. Google events that last longer than 14 days cannot be synced to Salesforce. This is a Salesforce limitation of the event object.

2. After a Google event was synced to Salesforce, any updates on the Salesforce event within the next 30 seconds are not synced back from Google to Salesforce.

3. If a Google event is created where the time zone of the start-time and end-time are not equal (rare), the event in Salesforce will have set the start-date and and end-date in the same timezone.

4. Note that recurring events in Salesforce have several limitations that affect how Groove is able to sync recurring events: 

Now all of your users data will be synced to Salesforce correctly!