Sugar Connect User Guide for Google Workspace

SugarOverview

This guide walks through the terminology, features, and functionality enabled by Sugar Connect for Google Workspace (formerly G Suite), a Chrome browser extension that lets you work with your Sugar data without navigating away from Gmail. You can use Sugar Connect to sync your Sugar and Google contacts and calendars, create new Sugar records, utilize your Sugar email templates, and easily archive incoming and outgoing email messages and attachments to Sugar.

Note: This guide is for Google Workspace users only. If you have installed Sugar Connect for Office 365 in Outlook, please refer to the Sugar Connect User Guide for Office 365.

Administrators can find more information on configuring Sugar Connect before users can install it in the Sugar Connect Deployment and Administration Guide. For the steps that users should take to install and activate Sugar Connect, refer to the Sugar Connect User Installation Guide.

Prerequisites

• Sugar Connect for Google Workspace must be installed on a Google Chrome browser. For steps to install Sugar Connect for Google Workspace, please refer to the Sugar Connect User Installation Guide.
• Refer to the installation prerequisites for important information about purchasing, deploying, and installing Sugar Connect.
• This guide applies to Sugar Connect for Google Workspace and is used with your Gmail, Google Contacts, and Google Calendar accounts. If you have installed Sugar Connect for Office 365 (Outlook), please refer to the Sugar Connect User Guide for Office 365 instead. 

For more information, please refer to the Plug-ins Supported Platforms page.

Terminology and Features

The Sugar Connect Portal

Users will primarily engage with Sugar Connect via the Sugar Connect Sidebar, but all Sugar Connect users also have access to a portal website where they can set up and manage certain Sugar Connect features. The portal is also where Sugar Connect administrators can perform administrative functions such as creating and managing user accounts. All Sugar Connect users can access the portal by selecting "Open Sugar Connect Portal" from the Sidebar Settings Menu. 

For complete information on using the Sugar Connect Portal, please refer to the Sugar Connect Portal User Guide.

The Sugar Connect Sidebar

The sidebar is the heart of Sugar Connect. It allows you to view and edit Sugar records in Gmail without opening your Sugar instance. The following sections explain how to access the sidebar, load email senders and recipient details in the sidebar, and how to work with the sidebar's home view, list view, record view, and Sugar Hint view (if available).

Accessing the Sidebar

To access the Sugar Connect sidebar in Gmail, simply click on the Sugar icon on the right side of Gmail:

Note: Some Gmail themes allow you to collapse the panel to the right of the screen. If you do not see any icons there, look for an arrow in the bottom corner of Gmail to expand the side panel icons. 

Loading Senders and Recipients in the Sidebar

Sugar Connect can find the lead or contact record associated with an email address that is included as a sender or recipient on an email message. Simply view any email message and Sugar Connect will load the Sugar details for the first email address it finds a match for in the sidebar's Record View.

Sugar Connect will load the first email address it finds into the dropdown at the top of the sidebar and, if found in Sugar, will display its details in Record View. Click on the dropdown to retrieve additional email addresses found in the To, From, and CC fields of the current message and view their related Sugar lead or contact records in the sidebar. 

If no match is found in Sugar for an email address, then Sugar Connect will give you the option to add a new Sugar record (i.e., a lead or contact) and archive the email if the Quick Archive to Sugar toggle is enabled. 

It is also possible to load Sugar details in the sidebar when creating a new message or meeting. Simply add at least one recipient or guest and Sugar Connect will automatically search for their related email addresses. If you navigate away from the record view, click on the Related Entries button to take you back.

Note: When switching your inbox settings in Google Workspace to enable or disable the reading pane with a split-screen, it is advisable to refresh your browser to ensure Sugar Connect displays the correct information.

Sidebar Home View

The default view for the sidebar is the Home view. Click the Home button at the bottom of the sidebar to access the main Sugar Connect home view.

From the Home view, you can access Sugar data and perform actions enabled by Sugar Connect:

Sidebar Search

Sugar Connect provides simple access to your Sugar records via search directly from the sidebar. 

Note: Users will only be able to see records as allowed by their team membership, user access type, and assigned roles in the Sugar application. For more information on teams and roles, please refer to the Team Management and Role Management documentation in the Sugar Administration Guide.

From the Home view, click inside the "Search Sugar" box, type a query, and press "Enter" on your keyboard to search the Sugar database for records in all of the modules to which you have access. 

To further refine search results, you can limit the search to a particular module using the module selector next to the search box. By default, the selector will be set to "ALL", indicating that all modules are being searched. Click on the word ALL (or on the currently selected module name) to reveal the list of available modules to be searched. You can even select multiple modules to search at once, which will result in the search box containing multiple module badges:

Note: Module filtering is not available when performing searches from a module's Sidebar List View because the module is automatically set by default in the list view.

To view the details of a search result, simply click on the record's name to view it in Sidebar Record View, where you can see its details, related record subpanels, and perform record actions such as editing the record or navigating to the record in your Sugar instance. To return to the list of search results, click on the Back button at the bottom of the sidebar.

Sidebar Settings

The Settings menu is always visible via the gear icon at the bottom of the Sugar Connect sidebar:

The Settings menu contains the following links:

General Options

The General Options section of the Sugar Connect Settings contains the following user-configurable settings:

• Show My Tasks List Dashboard: Enable or disable the My Sugar Tasks dashboard that appears at the top of your Gmail inbox.
• Turn on dark mode: Enable or disable dark mode within the Sugar Connect sidebar to coordinate with your Office 365 style.
• Save attachments by default: Enable or disable saving email attachments by default.
• Auto-Archiving of Outbound Emails: Enable or disable archiving outbound emails automatically. Outbound emails are related to the contacts or leads whose email is in the To, From, CC, or BCC field. Before sending, individual emails can be prevented from archiving by disabling the "Quick Archive to Sugar" menu option. Emails from specific contacts can have different archive behavior based on the record-level auto-archive setting.
  Note: This option may be disabled when your Sugar Connect admin has set the email archival method for your tenant.
• Auto-Archiving of Inbound Emails: Enable or disable archiving inbound emails automatically. Inbound emails are related to the contact or lead whose email is in the From field of the email. Emails from specific contacts can have different archive behavior based on the record-level auto-archive setting.
  Note: This option may be disabled when your Sugar Connect admin has set the email archival method for your tenant.
• Relate emails to contact and account automatically on archive: Enable or disable automatically relating an archived email (incoming or outgoing) to the matching Sugar contact and account record(s), if applicable.
• Populate Sugar Hint Data on Create: Enable or disable the automatic populating of Hint data when you are creating a lead or contact from an email.
• Change language: Select a supported language from the dropdown field to apply to your Sugar Connect sidebar. As best practice and for a seamless experience between Sugar Connect and your Sugar instance, please ensure to set your language preferences in both locations. For more information, please refer to the Getting Started page in the Sugar Application Guide.

Sidebar List View

From the Home view of the Sugar Connect sidebar, click on a module name to view lists of Sugar records in the sidebar. By default, you will see records assigned to you or due today but you can easily apply other filters.

For example, from Sugar Connect's home view, click on "Accounts" to view a list of Sugar accounts.

The sidebar will display a list of records for the selected module. From the list view, you can filter and perform actions on the displayed Sugar records. When you hover over a record, you will see a pop-up that shows additional information about the record. When you click on a record from the list view, you will be shown its record view in the sidebar.

Filtering List View

To filter the list of visible records in a module list view, click on the Filter icon and apply one of the module's available filters. Any custom filters created by the logged-in user will also be available at the top of the filter list.

List View Actions

To perform actions on the list of records in a module list view, click on the Actions menu next to the filter icon:

The following list-view actions are available:

In addition, when viewing task records in list view, you can click on the empty checkbox next to a task to mark it "Completed" in Sugar. For more information, refer to the Working With Tasks section.

Sidebar Record View

From the list view, click on a record's name to view its details from Sugar. The record's fields, panels, and subpanels will be presented as they are configured in your Sugar application by default. Sugar Connect Portal admin users can enable and disable fields from being displayed in the sidebar Record View. For more information, refer to the Customization section in the Sugar Connect Deployment and Administration Guide. From the record view, you can use the Actions Menu to perform actions such as editing the Sugar record and adding related records just as you would in Sugar. Please note, if your organization has SugarPredict enabled, you may see color-coded predictions in your lead or opportunity record view. For more information, please refer to the SugarPredict for Sell User Guide.

Record View Actions

To perform actions on a record from the sidebar, click on the Actions menu:

The following record actions are available: 

Adding Related Records

While in record view, you can relate new or existing Sugar records to the current record you are viewing. 

To create a new record in Sugar related to the current record you are viewing in the sidebar, scroll down to the related record's subpanel and click on the Create button.

Note: Clicking the Create button in the Emails subpanel opens a compose window in Gmail. Sugar Connect will insert the associated record's primary email address (if available) into the new message's To field. When you click the Create button on the Emails subpanel (e.g., an opportunity), your email will be archived to that record. 

To relate an existing Sugar record to another Sugar record, view the primary record via the sidebar, scroll down to the related record's subpanel, and select "Link Existing Record" from the subpanel's Actions menu.

Timeline View

Timeline view is available in the sidebar record view for the Accounts, Cases, Contacts, Escalations, Leads, Opportunities, and Quotes modules. To access Timeline view, click the Timeline button at the bottom right of the record view above the subpanels. Timeline view displays the current record's related activities (e.g., emails) and select field updates (e.g., a change to the Assigned To field) in the form of record cards. Each card is sorted in chronological order based on the date they occur or are due (for tasks), with the most recent at the top. Timeline cards are collapsed by default and you can click the arrow icon to expand the card and view more information. Clicking the record name opens the record view (e.g. the meeting record view) in the sidebar. You can also filter by record type (e.g., calls) by selecting one of the options in the Related dropdown field.

Sidebar Sugar Hint View

The sidebar Sugar Hint view is available only if you have access to Sugar Hint. You can use Hint for the Accounts, Contacts, and Leads modules to enhance your CRM data. To open the Sugar Hint view, click the Sugar Hint tab to the right of the module tab in the sidebar record view. For additional information about Sugar Hint, refer to the Sugar Hint documentation in the Application Guide.

Once you have opened the Hint view, click the module tab (e.g., Account) to return to the record view. In the Hint view, a blue cloud appears next to any data that does not match the data currently in the record. Click the three-dots menu on the top right to save all Hint data to the record or refresh the results. If you want to selectively save data to the record, click the blue cloud icon next to the data so that only that data is saved. At the bottom of the Sugar Hint view is a News panel that will display recent news about the company or person. Note that the News section may take up to an hour to populate once the record is created.

Note: If your record's data is different than the data that Hint found and you choose to ignore the Hint suggestion (i.e., you do not click the blue cloud icon), your record will continue to show the data you have in Sugar. This means that your Sugar data will be displayed by default when you have Sugar Hint.

Working With Your Sugar Data in the Sidebar

From the Sugar Connect sidebar, you can work directly with your Sugar records by creating and editing records, converting leads, and even completing your Sugar tasks without leaving Gmail.

Note: For more information on syncing Sugar data with Google data, refer to the Contact Sync and Calendar Sync sections.

Creating Leads and Contacts

There are several ways to create new Sugar leads and contacts from Gmail via the Sugar Connect sidebar:

• Creating via Related Entries: Open an email sent by a person using an email address that is not found in Sugar. Open the Sugar Connect sidebar, click on the Related Entries icon and the sidebar will give you the option to add the sender as either a contact or lead.
• Creating via Received Mail: Hover over an email address or open an email sent by a person using an email address that is not found in Sugar and the sidebar will give you the option to add the sender as either a contact or lead.
• Creating via Message or Meeting Compose: Enter an email address that is not found in Sugar into the recipient line of a new message or reply message. The sidebar will give you the option to add the sender as either a contact or lead.
• Creating via Sidebar List View: You can also create new leads and contacts from the List View actions Menu when viewing leads or contacts in list view.

Once you have initiated creating a new record, fill out the information in the new lead or contact form. Click the arrows to swap the data in the First Name and Last Name fields. When creating a contact, you will have the option to copy the address information from the related account record. Once you complete the create record form, click the check icon to save the new record in Sugar, click the plus icon to save and create another record, or click the Save and Archive icon to save the record and archive the email you are viewing. You can also click the x icon to cancel.

Note: The plus and the save and archive icons are only available when adding a record from the List View Actions menu.

Creating Leads and Contacts with Sugar Hint

If you have Sugar Hint, you can use Hint data to create your leads and contacts. Open or compose an email that contains an email address that is not found in Sugar. You will see the data that Hint has found for the email address along with options to create a lead or contact. Click the "Reload" text to reload the Sugar and Hint data. Clicking "Add to Sugar as a Contact" or "Add to Sugar as a Lead" brings the email address and, optionally, Hint data into the create record form.

Enable or disable the Use Hint Data setting to populate or remove the information found via Sugar Hint. You can edit or delete any of the data before saving the contact or lead. Please note, you can set the default behavior of the Use Sugar Hint Data setting under the General Options by enabling or disabling "Populate Sugar Hint Data on Create".

Creating Other Sugar Records

You can easily create Sugar records in the sidebar via the "Create Record" option in the List View actions menu. 

After completing the record's details, click the check icon to save the new record in Sugar, click the plus icon to save and create another record, or click the Save and Archive icon to save the record and archive the email you are viewing. 

The new record will be saved in Sugar, and you can navigate to the record in Sugar via the "View in Sugar" option in the Record View actions menu.

Editing Sugar Records

You can easily edit Sugar records in the sidebar via the "Edit Entry" option in the Record View actions menu. 

After editing the record click the check icon to save your changes or click the x to cancel. Please note, for contact and lead records, you have the option to swap the data in the First Name and Last Name fields while creating a new record or editing an existing record.

The changes you save will be synced to and reflected in Sugar.

Note: Attempting to navigate away from the record before saving or canceling will prompt a warning letting you know you have unsaved changes and giving you the option to continue editing or discard changes.

Converting Leads

Sugar Connect lets you convert leads into contacts, accounts, and opportunities from the sidebar in Gmail.

1. When viewing a lead in the sidebar, open the Record View Actions menu and select "Convert Lead".
   
   Note: If the lead's status is already "Converted", the Convert Lead option will be grayed out.
2. Next, you will be prompted to associate a contact, account, and optionally, an opportunity.
   • If the record(s) you want to associate with the lead is already in Sugar, then you can start typing in the given field or click "Search and Select" to find a match from Sugar.
   • To create a new record in Sugar to associate with the lead, click on the Create (+) icon next to the field.
     
3. Once you have finished finding and creating the records you want to associate with the lead, select "Save and Convert" from the Actions menu.
   

The sidebar will display a success message and you can find and navigate to the converted contact and related records below the lead's details in the sidebar.

Working With Tasks

When viewing task records from Sugar in the Sugar Connect sidebar's list view, an additional option is available to quickly mark your tasks as complete. Click inside the task's adjacent checkbox to update its status to "Completed" and sync the change with Sugar.

For more information on working with tasks using Sugar Connect in Gmail, refer to the My SugarCRM Tasks List section.

Google Groups

For users working in shared inboxes, Sugar Connect can be used with Google Groups. If you are a member of a Google Group with emails distributed to each member, you may use Sugar Connect while viewing these emails and logged into your email address associated with your Sugar instance and Sugar Connect tenant. For example, your organization may have a Google Group with an email alias of "sales@yourcompany.com" of which you are a member. You, and all other group members, will receive emails sent to that email alias and may choose to view or create Sugar records and archive emails as you would normally. The created records and archived emails will be assigned to you in Sugar. Please note, because Sugar Connect checks for existing emails when archiving, if a person using the shared mailbox has auto-archive enabled or manually archives an email, you may receive a notification that the email already exists in Sugar.

For information and steps to implement Google Groups in your organization, refer to Google Groups Help.

Note: Sugar Connect is not supported with Google's Collaborative Inbox or delegated accounts.

Emails

When working with email messages in Gmail, Sugar Connect lets you easily archive emails and attachments, use your Sugar email templates, set a delay on emails that you want to write now but send later, and track if and when your emails were opened, links were clicked, and replies sent.

Email Archiving

When an email is sent to or received from an email address that is associated with a Sugar contact or lead, Sugar Connect can archive the message to the contact or lead and its parent account. Emails will be archived to any Sugar contacts, lead, or account that matches the email addresses in the message's To, From, CC, and BCC fields. Emails can also be archived to other record types in Sugar. Once archived, Sugar Connect will provide an alert in the sidebar if a user attempts to archive the email again. To archive an email to a custom module, there must be an existing relationship to the Activities. For more information, refer to the Creating Relationships documentation in the SugarCRM Administration Guide.

Note: It may take as long as 30 minutes to see the archived email in your Sugar instance.

There are several ways you can archive emails in Gmail.

• Quick Archive to Sugar: Archive and relate the email to the Sugar record with a matching email address.
• Archive With Options: Select which attachments to archive and select the Sugar record(s) that you want to relate to the archived email.
• "Copy to CRM" Mailbox Label: Apply the "Copy to CRM" Gmail label to quick-archive one or more email messages on the next Sugar sync.
• Auto-Archiving: Set the auto-archive behavior for a specific lead or contact.
• Save and Archive: When creating a new record (e.g., opportunity) in the sidebar, you can archive the email currently being viewed to the record you are creating.

Please click on the archiving options above to read more information about each method.

Note: Digitally signed emails will only archive correctly if they were sent from an Office 365 account where the "Send digitally signed messages as clear text" setting is enabled.

Quick Archive to Sugar

When you are viewing a message in Gmail, click on "Quick Archive to Sugar" to save the email to Sugar and relate it to the Sugar records (i.e., accounts, contacts, leads) that match the email addresses in the message's To, From, CC, and BCC fields. You can use quick-archive for existing email messages (e.g., sent messages, messages in your inbox) and messages you are sending from Gmail. When the option to "Save attachments by default" is enabled, the email attachments will be archived as well. The Teams field on the archived email will be set to the user's default team.

Note: Emails archived using Quick Archive to Sugar will be flagged with the "Copied to CRM" label as it is using the "Copy to CRM" Mailbox Label.

Quick Archive for Existing Messages

When you are viewing a message in your Gmail inbox, click on the message's Sugar icon and select "Quick Archive to Sugar" to archive the email to Sugar and relate it to the Sugar records (e.g., accounts, contacts, leads) that match the email addresses in the message's To, From, CC, and BCC fields.

Quick Archive for New Messages

Similarly, you can use Quick Archive to Sugar when you are composing an outgoing message. Make sure to add the subject, body, and message recipient(s) first and then click on the Sugar icon and select "Quick Archive to Sugar". When you send the message, the email will be archived to Sugar and related to any Sugar records with matching email addresses. 
Note that you can confirm that an outgoing message is ready to Quick Archive by looking at the Quick Archive to Sugar menu option. The text and icon will have changed to blue text with a checkbox enabled if it has been queued for Quick Archive. You can select it again to reverse the Quick Archive designation if you decide not to archive the email.

Archive With Options

The "Archive With Options" functionality will open the full archive window and let you manually select the Sugar records (e.g., contacts, cases, opportunities) to relate to the email and to select which attachments you want to archive in Sugar. You can use Archive With Options for existing email messages (e.g., sent messages, messages in your inbox) and messages you are sending from Gmail. Your email will be archived with the selected options when your email is sent, whether you click the Send button to send immediately or use the "Send Later" feature to send the email at a future time or date.

Note: Emails archived using Archive with Options will be flagged with the "Copied to CRM" label as it is using the "Copy to CRM" Mailbox Label.

Archive With Options for Existing Messages

Use the following steps to leverage the "Send With Options" functionality when you are viewing a message in Gmail.

1. Click on or open the email that you want to archive to Sugar.
2. Click the message's Sugar icon and select "Archive With Options".
   
3. In the popup window, place a checkmark next to the records that you want to relate the email message to in Sugar.
   
   
   • Use the Search tab to find additional records. You may select any combination of lead, contact, account, opportunity, revenue line item, and case records to relate to the email.
     
   • By default, no message attachments will be selected for archive, but you may select any attachments that you want to upload to Sugar under the Attachments tab. You can also choose to select all or none of the images embedded into the email. When the option to "Save attachments by default" is enabled, the attachments will be automatically selected.
     
     Note: Images embedded using a URL that points to an external source will not be archived.
4. Select the "Related to" module by clicking on the module icon to open the list of modules. Then select the module to use.
   
5. Add the record for the module in the Related To field.
   
6. Select the team and assigned user to save on the Sugar email record and then click on "Archive" to close the window.
   Note: The Teams field is set to the user's default team, but you can change the Teams field on a per-email basis.

On archive, the email message's content will be copied to a record in Sugar's Emails module, any attachments will be archived to the Notes module, and the new email and note records will be related to the records you selected in the dialog.

Archive With Options for New Messages

You may also choose to leverage the Archive With Options functionality when you are composing an email message in Gmail. Sugar Connect lets you send the message to both the chosen recipients and archive to your Sugar instance at once. Use the following steps to archive to Sugar the email you are sending from Gmail.

1. Compose a new message in Gmail or reply to or forward an existing message.
2. Once you have entered the subject, body, and recipients for the email, click on the message's Sugar icon and select "Archive With Options".
   
3. In the popup window, place a checkmark next to the records that you want to relate the email message to in Sugar.
   
   
   • Use the Search tab to find additional records. You may select any combination of lead, contact, account, opportunity, revenue line item, and case records to relate to the email.
     
   • By default, no message attachments will be selected for archive, but you may select any attachments that you want to upload to Sugar under the Attachments tab. You can also choose to select all or none of the images embedded into the email. When the option to "Save attachments by default" is enabled, the attachments will be automatically selected.
     
     Note: Images embedded using a URL that points to an external source will not be archived.
4. Select the "Related to" module by clicking on the module icon to open the list of modules. Then select the module to use.
   
5. Add the record for the module in the Related To field.
   
6. Select the team and assigned user to save on the Sugar email record and then click on "Select Entries" to close the archive window.
   Note: The Teams field is set to the user's default team, but you can change the Teams field on a per-email basis.
7. Finish composing your email including all desired recipients and send your message.

Upon sending, the message will be delivered to the recipients and archived to Sugar. The email message's content will be copied to a record in Sugar's Emails module, any attachments will be archived to the Notes module, and the new email and note records will be related to the records you selected in the dialog.

Note: It may take as long as 30 minutes to see the archived email in your Sugar instance.

You can also choose to use the Send Later function after Archive With Options to send the email at a later time the options you configured.

"Copy to CRM" Mailbox Label

When you installed the Sugar Connect extension, a custom label was created in your Gmail mailbox that you can apply to email messages that you want to archive to Sugar. This makes it easy to select and archive many emails at once to your Sugar instance, set up email rules for handling automatic archive, and to archive emails from your mobile device. When archiving email messages to Sugar using the Copy to CRM mailbox label no email attachments will be included. Navigate to Settings > General Options > enable "Save attachments by default" if you want attachments automatically included.

Note: When using the "Copy to CRM" label, a matching email address must exist in an account, contact,  or lead record for the archive to succeed. Otherwise, the email will not be archived to Sugar.

The label in Gmail is called "Copy to CRM" and is nested under the "Sugar Connect" label:

For more information on using Gmail labels, please refer to Google's help article, Create Labels to Organize Gmail.

Mass Archive via "Copy to CRM"

To archive many emails at once, simply select the messages and drag them to this label; they will archive to Sugar on the next server sync (typically 15- or 30-minute intervals) if matching email addresses are found in Sugar for the To, From, CC, or BCC fields. Sugar Connect will relate the email to the matching records in Sugar and the label will be updated to "Copied to CRM". If a matching email address is not found, the email will not be archived to Sugar.

Note: The first time the sync is processed, it will only include emails that have been received in the last 90 days. Subsequent sync sessions will include all emails regardless of date received. 

Auto-Archive via "Copy to CRM"

Follow these steps to automatically archive email messages received in Gmail: 

1. In the search bar at the top of Gmail, click on the Down arrow.
2. For the "From" criteria, enter an asterisk * character to auto-archive all messages from all senders. Alternatively, you can specify certain senders, domains, or keywords to refine the types of messages you want to auto-archive. For more information on creating filters in Gmail, refer to the Google Help article Create Rules to Filter Your Emails.
3. Do not click Search. Instead, click on the "Create Filter" option next to the Search button.
   
4. From the filter actions, select "Apply the label" and select the "Sugar Connect > Copy to CRM" label.
   
5. Click "Create Filter".

After the filter is created, all incoming messages (or the messages that match your filter criteria) will be automatically put into the "Copy to CRM" folder and archived to Sugar if a matching email address is found. If a matching email address is not found, the email will not be archived to Sugar.

Mobile Archive via "Copy to CRM"

While you cannot use Sugar Connect's sidebar on your mobile device, you can still use the power of Sugar Connect to archive emails using the "Copy to CRM" label from the Gmail app.

As an example, follow these steps to apply the "Copy to CRM" label to a message in Gmail using your mobile device:

1. Tap on the message that you want to archive.
2.  Open the message's options menu and tap on "Change Labels".
   
3. Select the "Sugar Connect/Copy to CRM" label and then tap "OK".
   

The message is now labeled "Copy to CRM" and will archive to Sugar during the next server sync if a matching email address is found. If a matching email address is not found, the email will not be archived to Sugar.

Auto-Archiving

When viewing a contact or lead record in the Sugar Connect sidebar, you can decide whether to enable or disable inbound and/or outbound email auto-archiving for that specific record. 

Note: It may take as long as 30 minutes to see the archived email in your Sugar instance.

To control the auto-archive behavior for a specific lead or contact, open the lead or contact record in the Sugar Connect sidebar. Click the envelope icon that appears to the right of the name to change the auto-archive behavior for that lead or contact.

Icon	Description
	Do not auto-archive any emails for this lead or contact.
	Auto-archive only outbound emails to this lead or contact. The lead or contact's email may appear in the To, From, CC, or BCC field to be related to the archived email.
	Auto-archive only inbound emails from this lead or contact. The lead or contact's email address must be in the From field to be related to the archived email.
	Auto-archive outbound and inbound emails for this lead or contact.

Note: Some or all of these options may be disabled if your Sugar Connect admin has set the email archival method for your tenant.

Save and Archive

When creating a new record (e.g., opportunity) in the Sugar Connect sidebar, you can archive the email currently being viewed to the record you are creating via the Save and Archive icon. The Save and Archive icon is available for all modules that have a relationship with the Emails module. Please note that the option is available while the record is being created and will not be shown after the record is saved 

Follow these steps to archive an email to Sugar using the Save and Archive button in a new opportunity record as an example:

1. Locate the email you want to archive to Sugar and ensure you have it open so that Sugar Connect can process it.
2. If no related entries are found for the email, you can optionally add to Sugar as a contact or lead before proceeding to the next step.
3. Navigate to the Home screen > Opportunities > select "Create Opportunity" from the list view actions menu.
4. Fill out the applicable fields for the new opportunity record.
5. Click the Save and Archive icon.
   

Archiving Attachments to Sugar

When archiving attachments, you have the option to archive the email along with its attachments or as a stand-alone document.

Archiving Emails With Attachments to Sugar

When archiving email messages to Sugar, Sugar Connect will detect any attachments and embedded images included with the message. When archived together, an email and its attachment(s) are archived as an email and related note(s) records, respectively, in Sugar. During quick archive and when using the Sugar Connect mailbox label, if the option to "Save attachments by default" is enabled, the attachments are automatically archived to Sugar with the message.

When using Archive With Options, you can select which attachments to save under the Attachments tab in the archive window. You can also choose to select all or none of the images embedded into the email. Please note, images embedded using a URL that points to an external source will not be archived.

Note: Links to Google Drive files appear as attachments when included in an email. However, they are not able to be archived and will not be listed in the Attachments tab in the archive window.

Archiving Attachments as Documents

Sugar Connect allows you to archive an attachment to records in your Sugar instance without archiving the whole email message. This archives the attachment as a document record in Sugar. To do so, hover over the attachment and select the Sugar Connect - Archive button. 

You will have the option to save the attachment to a related sugar record based on the email address of the sender or to search existing records to save the attachment. You can optionally assign a category and subcategory to the attachments. The values of the Category and Subcategory dropdown fields are inherited from the Documents module in your Sugar instance.

Note: Links to Google Drive files appear as attachments when included in an email. However, they are not able to be archived and will not have the Sugar Connect Archive button available for selection.

Troubleshooting Email Archiving

There are some reasons why email archiving could fail:

• If the message failed to archive and the confirmation message "Email Saved to Sugar" did not appear, then the email was not saved because of a slow internet connection or connection with your Sugar server. If you experience this issue, try archiving the email at a later time.
• Sometimes the email archives to a different Sugar record (e.g., account, contact, opportunity, or case) than the one you expected. Double-check in Sugar that the correct relationship was made by searching for the email in the Emails module list view.
• Errors with the network connection are the most common cause of a failed archive. Check with your company's network administrator to find out if there are network issues.

Archived Emails

Once you have archived your emails using the methods described above, you can check their archive status in the Sugar Connect sidebar by clicking the Archived Emails icon located along the bottom of your sidebar.

The archived emails section contains two lists: 

• Previously Archived: View a list of emails along with their archive status.
• Scheduled for Archive: View a list of emails scheduled for archive on the next sync from Sugar Connect to your Sugar instance. 

As you archive emails either automatically or manually, the previously archived list updates automatically. You can expect the following behavior, based on the archive status, of the messages shown in the previously archived list:

• Archived: The email has successfully archived to Sugar, for the first time.
  • Unread messages shown in the list display a blue dot next to them that disappears after you have viewed the message.
  • The View in Sugar button is available.
  • After viewing, the message for an archived email remains visible in the list for roughly ten minutes, after it is are cleared out.
• Email has been previously archived and already exists in Sugar: The email was successfully archived to Sugar during a prior archive action.
  • A red number is added to the Archived Emails icon at the bottom of your sidebar and stays until you navigate to the list.
  • Unread messages shown in the list display a red dot next to them that disappears after you have viewed the message.
  • The View in Sugar button is available.
  • After viewing, the message for a previously archived email remains visible in the list for roughly twenty-four hours, after which it is cleared out.
• No related entries found. Email was not archived: No matching record was found in Sugar and the email was not archived.  
  • A red number is added to the Archived Emails icon at the bottom of your sidebar and stays until you navigate to the list.
  • Unread messages shown in the list display a red dot next to them that disappears after you have viewed the message.
  • The Retry button is available.
  • After viewing, the message for an unarchived email remains visible in the list for roughly twenty-four hours, after which it is cleared out.
• Failed: An error occurred during the archive process and the email was not archived. 
  • A red number is added to the Archived Emails icon at the bottom of your sidebar and stays until you navigate to the list.
  • Unread messages shown in the list display a red dot next to them that disappears after you have viewed the message.
  • The Retry button is available.
  • After viewing, the message for a failed email remains visible in the list for roughly twenty-four hours, after which it is cleared out.

Email Templates

Sugar Connect communicates with your Sugar instance to retrieve email templates that you have created in your instance. When you use the templates in Sugar Connect, any variables are also detected and filled in automatically.

Note: Users will only be able to see templates as allowed by their team membership, user access type, and assigned roles in the Sugar application. For more information on teams and roles, please refer to the Team Management and Role Management documentation in the Sugar Administration Guide.

Email Templates List and Actions Menu

The Email Templates list and the Actions menu are available after clicking "Insert Template" on an email message. 

Compose a new message in Gmail or reply to or forward an existing message, then click on the message's Sugar icon and select "Insert Template".

Email Templates List

If your Sugar instance is on version 11.0.x or higher, the email templates will be organized by the tags applied to each record, as shown below. For best practices in creating tags for the Email Templates module, please refer to the Optimizing Tag Usage help article. For additional information on email templates and tags, please refer to the Emails and Tags documentation in the Sugar Application Guide. The search bar at the top of the template list allows you to locate a specific template by name.

Email Templates Action Menu

The following options are available in the Actions menu located at the top of the template list:

Using Email Templates in Gmail

To access your Sugar templates in Gmail via Sugar Connect, use the following steps:

1. Compose a new message in Gmail or reply to or forward an existing message.
2. Enter the recipient for the email, then click on the message's Sugar icon and select "Insert Template".
   
3. In the popup window, click on a template or use the search to find the template that you want to use.
4. A preview of the template will load and the name of the lead or contact that matches the recipient's email address in Sugar will appear above the preview.
   
5. Optionally, you may erase the Related To value and start typing a different name or email address to search for leads and contacts from your Sugar database.
   
6. Click on "Use Template" to transfer the content of the template to your email message in Gmail. The field variables will automatically be populated with the data from your selected Sugar lead or contact.

Searching Email Templates

If you have a lot of email templates, the template search can help you refine the list and find what you need. In the Insert Template window, click in the "Search Email Templates" search area. As you begin to type, the list will show relevant results that contain the string you enter. Clicking the "x" will clear the search and reset the template list. If your Sugar instance is on version 11.0 or higher, the email templates will be organized by the tags applied to each record.

Creating Email Templates

The templates you use with Sugar Connect are the templates that you and your fellow Sugar users have created in your Sugar instance. To create a new email template for use with Sugar Connect, simply log into Sugar and create a new template in the Email Templates module. Please note, if your email template in Sugar contains an attachment, the attachment will not be included in the Sugar Connect email template. You can also access the Email Templates module directly from Sugar Connect via the "Create Email Template" option in the Email Templates Actions menu. For more information on creating email templates in Sugar, please refer to the Emails documentation in the Sugar Application Guide.

Note: Because it may take some time for changes in Sugar to sync to Sugar Connect, we recommend using the Refresh option in the Email Templates Actions menu after creating a new template in Sugar. This will retrieve the most up-to-date data and any new templates that have been created.

Editing Email Templates

The templates you use with Sugar Connect are the templates that you and your fellow Sugar users have created in your Sugar instance. You can quickly navigate to and edit an email template from Sugar Connect when you compose a new email message in Gmail. Simply click on the message's Sugar icon and select "Insert Template". Click on the template that you want to edit and an "Edit Template" option will be available at the bottom of the template's preview:

Click on the Edit Template button to navigate to the template record in your Sugar instance where you can edit the email template. For more information on editing email templates in Sugar, please refer to the Emails documentation in the Sugar Application Guide.

Note: Because it may take some time for changes in Sugar to sync to Sugar Connect, we recommend using the Refresh option in the Email Templates Menu after editing a template in Sugar. This will retrieve the most up-to-date data including any changes made to templates.

Template Statistics

When Email Tracking is enabled and email templates are used in combination, Sugar Connect compiles template statistics for each template. The statistics display the number of times: a template has been used in a tracked email, a template has been viewed by the recipient, a link within the email was clicked, and a recipient replied to the tracked email. You can toggle between viewing "All User Stats" or "My Stats" to gain insight into the effectiveness of each email template either across your organization or specific to your tracking history.

Send Later

The "Send Later" feature lets you set a date and time in the future to send an email message from Gmail. Simply compose an email message from scratch or by using a template and then click on the message's Sugar icon and select "Send Later" as the last step once you have finished composing your email.

Select a time to send the message, using the "Your time" and "Their time" prompts as guidance. To update the "Their time" value, select a new value for the Timezone field. Lastly, click "Confirm". The email message will close and be queued to send later. They are stored in your Drafts folder, and can be reviewed by clicking on the "Scheduled Emails" badge on the Sidebar Home view.

Email Tracking

Sugar Connect offers you the ability to track emails sent from Google Workspace to prospects, customers, and anyone with whom you want to track interactions. Email Tracking will show if a recipient has opened your email, clicked any links you provided, and replied. If you have set up any email templates, the same metrics can be tracked and viewed in a summary per template. 

Note: Sugar Connect administrators are able to set the Email Tracking default settings. For more information, please refer to the Tracking Settings section in the Sugar Connect Deployment and Administration Guide.

Enabling and Disabling Email Tracking

The Email Tracking features can be enabled/disabled in the following places:

• Toggle Tracking: Turn tracking on or off while composing an email.
• Email Tracking Options: Set your preferences for enabling/disabling default behaviors in the sidebar.
• Sugar Connect Portal: Set your preferences for enabling/disabling default behaviors in the Email Tracking Settings tab.

Note: The Sugar Connect Portal settings and the sidebar Email Tracking options will mirror each other. Changing a setting in one location will automatically update the other location.

Email Tracking Rules

For Sugar Connect to track emails and display tracking statistics correctly, the following guidelines should be kept in mind:

• Google Permissions: To track email replies, you must give Sugar Connect permission to access your Google data as explained in the Sugar Connect User Installation Guide.
• Links: Sugar Connect supports link tracking for the following link types: HTTP and HTTPS. All other link types (e.g., Mailto, RDP, UDP) are not supported and will not be tracked.
• Recipients With the Same IP Address as Sender: Users may not get any reported event from tracked emails sent to a recipient who is also using Sugar Connect or from users who are using the same IP Address.
• Email Aliases: Reply events will not work when tracked emails are used with an alias address.
• Disabled Images: Sugar Connect uses a tracking image/pixel embedded within your tracked email. If a recipient has disabled the option to automatically display images within their email client, the tracking image will not be loaded and Sugar Connect will not be able to notify the user that the message has been opened.
• Conflicts With Other Email Tracking Providers: Because Sugar Connect uses images embedded in emails to track them, it is important to note that other email-tracking companies will have their own code or images that they may embed on a hyperlink. Sugar Connect cannot track hyperlinks that already have other images/codes embedded on the hyperlink. To avoid conflicts, do not copy/paste hyperlinks from previous emails or from another email. Chances are, those links are already edited or might have its own tracking links from other companies. Instead, use Gmail's "Insert Link" option when adding links in your email.
  • Note: In 2013, Google implemented a change to how linked images are handled in Gmail webmail. These changes affect the way email tracking works. Please refer to this external blog post for more information.
• Tracking Multiple Email Addresses: Tracking an email with multiple email addresses (To, CC, BCC) will show up as one section on the Sugar Connect side panel. It may appear that the emails weren't tracked because an email sent with multiple email addresses will only be under one "tracking file". The side panel tracks all email addresses; however, it is not possible to see which email address it is tracking. Sugar Connect can only record the location where the email was opened but not who opened the email.
• Time to Track: Depending on the action performed and the age of the tracked email, it may take a little time to register in Sugar Connect. The older the tracked email is, the longer it takes to track. Slow or interrupted network connections may cause additional delays on tracked events. The following guidelines are typical for tracked events:
  • Clicks and views will take 1-3 minutes to prevent the side panel from being flooded with new events.
  • Reply events will take up to 15 minutes to appear than the actual time the reply was received.
  • After 24 hours of being sent, the statistics and notifications may take up to 3 hours.
• Opening Your Own Tracked Email: If you, the sender, views the tracked email (e.g., opening it from your Sent folder) it will show as being opened in your tracking statistics.

Toggling Tracking Within Emails

While composing an email, click the Sugar Connect - Toggle Tracking button. The email will be tracked when the target is blue. When it is grey, the email will not be tracked.

Email Tracking Options

From the sidebar, click the Options gear icon, and select "Email Tracking Options". You can toggle the following settings, which are enabled by default, off or on based on your preferences:

• Track clicks on links in tracked emails: When a link is included in either a template or by using the "Insert link" button in your email, you can find out if the recipient clicked it.
• Auto enable email tracking: All emails sent will be tracked by default unless you click the Toggle Tracking button while in the compose message screen.
• Show real-time click notifications: A popup will be shown in the sidebar and the Tracking Activity badge will display a number.
• Enable real-time email view notifications: A popup will be shown in the sidebar and the Tracking Activity badge will display a number.

Note: Some email clients may route tracked emails into a spam folder, thus impacting the delivery/receipt of your emails.

Email Tracking in Sidebar

There are two areas within the sidebar to view the emails you are tracking:

• Tracked Emails: This badge opens a list of individual emails in the order they were sent. Each email displays the total number of opens, link clicks, and replies. Clicking the arrow will open the details of the statistics including time stamps and locations when applicable.
• Tracking Activity: This badge opens a list of all opens, link clicks, and replies in chronological order. A red circle with a number will appear to alert you when you have new tracked activity.
  

Note: Once the tracked email's age reaches 24 hours, there may be a delay in updates of tracking statistics of up to 3 hours.

Email Tracking in Sugar Connect Portal

Within the Sugar Connect Portal, you have the ability to view a much more detailed reporting of all tracked emails. For more information please visit the Sugar Connect Portal User Guide.

Calendar Sync

Sugar Connect will sync meetings between Sugar and your Google Calendar. After the initial sync, events that are assigned to you in Sugar will be synced to Gmail and vice versa. The sync interval between Google Calendar and Sugar occurs once every 15 to 20 minutes.

For steps to sync your calendars, please refer to the Sugar Connect Portal User Guide, which covers the Sync Rules for Calendar and how to use the Sugar Connect Portal to sync calendar events with Google Calendar. The following sections cover how to work with synced events in Google Calendar once you have set up the calendar sync.

Note: Sugar Connect Calendar Sync does not support shared calendars.

Viewing Sugar Calls and Meetings in Google Calendar

The way you will view your Sugar events in Google Calendar depends on the option you selected when you enabled calendar sync. If you selected the default behavior, "Use primary calendar", then you can simply switch to your primary calendar view and find the events that have synced from Sugar among the rest of your meetings and appointments. If you disabled the option to use your primary calendar, then Sugar Connect will add a "Sugar" label in Google Calendar which must be selected as a visible calendar to see your synced Sugar events:

Creating Sugar Meetings From Google Calendar

To create a new meeting in Google Calendar that syncs to Sugar's Meetings module, you must first set up calendar sync. The default setup option "Use primary calendar" lets you simply create meetings in your primary calendar view and they will sync to Sugar as meeting records on the next calendar sync (every 15 - 20 minutes).

If you disabled the "Use primary calendar" behavior during sync setup, then you must select the "Sugar" calendar when creating the event in Google:

On the next sync (every 15 - 20 minutes), any events that have been added to the "Sugar" calendar in Google will copy to Sugar's Meetings module.

Adding Existing Google Calendar Meetings to Sugar

By default, meetings that were set up before Sugar Connect was installed and meetings that are accepted in Gmail will automatically sync with Sugar during the standard sync event. 

Users who disabled the default "Use primary calendar" behavior during calendar sync setup, however, must copy any existing or accepted events from their primary calendar to the calendar labeled "Sugar". As an example, the following steps cover how to copy an event to the "Sugar" Google calendar.

Again, the following steps apply only to users who disabled the option "Use Primary Calendar" when they set up calendar sync.

1. In Google Calendar, double-click on the event that you want to copy to Sugar.
2. Select "Duplicate" from the event's More Actions menu.
   
3. The new copy of the event will open. Use the calendar selector to select the "Sugar" calendar.
4. Save the calendar event.

You will now have duplicate meetings on your calendar and the event that is saved to the Sugar calendar will sync to Sugar during the next sync event. Note that you may choose to hide the Sugar calendar from view in Google Calendar if you prefer not to see duplicate events, but this may prevent you from seeing events that were created in and synced from Sugar.

Deleting Synced Events

Events that you delete from your synced Google Calendar will automatically be deleted from Sugar during the next calendar sync. Please wait for the next sync event (approximately 15 - 20 minutes) for the event to be deleted.

Contact Sync

You can sync your Sugar leads and contacts with Google Contacts via Sugar Connect by following the steps to set up contact sync. Leads and contacts assigned to you will sync by default. To sync additional leads or contacts not currently assigned to you in SugarCRM, navigate to the record in the sidebar > click the actions menu > Select "Mark to Sync".

Once you have your sync enabled for your contact records, you can find the leads and contacts by navigating to Google Contacts via the apps menu at the top of Gmail:

In Google Contacts, the Sugar leads and contacts that are assigned to you will appear under the label "Sugar". Simply click on the "Sugar" label to view your synced contacts:

For steps to sync your leads and contacts, including how to configure two-way contact sync, please refer to the Sugar Connect Portal User Guide. This guide covers the Sync Rules for Leads and Contacts and how to use the Sugar Connect Portal to sync leads and contacts with Google Workspace.

My Sugar Tasks Dashboard

The My Sugar Tasks dashboard appears prominently above your Gmail inbox and provides quick access to your Sugar tasks from Gmail. You can edit, mark complete, and send an email to the task's related entry (Lead, Contact, or Account) directly from Gmail. Only tasks that are assigned to you are shown. The My Sugar Tasks dashboard is enabled by default. It can be disabled from Settings > General Options or minimized using the arrow in the header bar.

• Refresh: Click the Refresh icon to retrieve the most recent updates from Sugar.
• Expand/Collapse: Click the Arrow icon to expand or collapse the Tasks list.
• Email: Click the Email icon to compose a new email to the related entry.
• Edit: Click the Pencil icon to edit the task.
• Complete: Click the checkbox and then "Confirm" to mark the task as complete.

Note: To prevent display issues in Gmail, the My Sugar Tasks dashboard cannot be used when using Gmail's Preview Pane lab feature.

Please note that you can also view and work with your Sugar tasks in the Sugar Connect sidebar. For more information, refer to the Working With Tasks section.

Sugar Connect Meeting Scheduler

The Sugar Connect Meeting Scheduler lets users easily schedule meetings with prospects, partners, customers, and coworkers and sync them to Sugar by just sharing a link. Navigate to your custom meeting types by clicking the Scheduler link in the bottom of your sidebar. Locate the meeting type you want to share and click the Copy Calendar Link button. The link, now copied to your clipboard, can be easily shared via email, Slack, etc. Clicking the Add Event Type button takes you to your Sugar Connect portal where you can create additional options. Clicking Refresh brings any newly added event types into your sidebar. For more information on creating event types, please refer to the Sugar Connect Portal User Guide.

Switching Sugar User Accounts

If you wish to switch to a different Sugar user account or instance in Sugar Connect, open the Sidebar Settings menu and select "Log Out of Sugar". You will then be prompted to re-authenticate with the new user information.