SugarCRM SupportProduct GuidesPlug-insSugar ConnectSugar Connect Portal User Guide

Sugar Connect Portal User Guide

Overview

The Sugar Connect Portal is a website that is available to all Sugar Connect users as a supplement to the sidebar and is used to set up key features for the sidebar and access the online meeting scheduler.

This guide will cover the following Sugar Connect functionality for Office 365 and Google Workspace (formerly G Suite) users:

In addition, administrators can manage Sugar Connect users in the portal. For more information on user management, refer to the Sugar Connect Administration and Deployment Guide.

Logging In

The section below outlines the steps to log in to your Sugar Connect Portal.

  1. You can open the Sugar Connect Portal from the Sidebar or navigate directly to the Sugar Connect Portal.
  2. In order to log into the correct tenant, ask your administrator in which region your Sugar Connect tenant is hosted:
  3. If your email address is associated with multiple organizations, you may be prompted to select one prior to logging in.
  4. If using the G-suite extension, you must Sign in with Google and if you are using the Office 365 Add-in, you must sign in with Microsoft, and continue following the instructions in the window. You must click "Allow" to grant permission for the connector to access your data when prompted. If your email address is associated with multiple organizations (tenants), you may be prompted to select one prior to logging in.
    portalloginupdate
    portalloginupdate2

Accessing the Sugar Connect Portal

After you have installed Sugar Connect in your email client, the Sugar Connect Portal can be accessed by clicking "Open Sugar Connect Portal" from the sidebar's lower Settings menu. The portal will open in your default web browser.
sidebarsettings

Alternatively, admins and users may navigate directly to the Sugar Connect Portal following the steps in Logging In. If your email address is associated with multiple organizations, you may be prompted to select one prior to logging in.

Sugar Credentials

The first place that you should visit upon your first login to the portal is the Sugar Credentials to ensure that your Sugar Instance and username are properly configured. If not, you must contact your Sugar Portal Admin user to set up the Server URL before you can authenticate your username and password. 
portalupdate

Contact Sync

If you want to use Sugar Connect to push your leads and contacts from Sugar to your Outlook or Google address book, you must first set up Contact Sync in the Sugar Connect Portal. The next two sections explain important rules for syncing your leads and contacts and how to set up the sync once you are ready.

Sync Rules for Leads and Contacts

Take note of the following requirements before pushing contacts from Sugar to your Outlook or Google address book via Sugar Connect.

  • You must have access to the Leads module in Sugar for your leads to sync to your external address book.
  • You must have access to the Contacts module in Sugar for your contacts to sync to your external address book.

The following rules apply to the sync process for leads and contacts to your external address book:

  • Syncing Records
    • Sugar Connect's Contact Sync is a one-way push from Sugar to your external address book. 
    • Only leads and contacts that are assigned to you will sync to your external address book by default.
    • Leads and contacts that are not assigned to you can be marked to sync to your external address book within the sidebar after the sync is enabled.
    • Contacts that exist in your address book but not in Sugar will not sync to Sugar during the sync process.
    • The Contact Sync time interval is set to once every 15-20 minutes.
  • Editing Records
    • The changes made to leads and contacts in your Sugar instance will sync over to your external address book.
    • Any changes made to a contact in your Outlook or Google address book will not sync back to Sugar and will instead be overwritten on the next automatic sync update.
  • Creating Records
    • Creating new Sugar contacts can only be done via the Sugar Connect sidebar or directly in Sugar. 
  • Deleting Records
    • If you delete a synced contact from your address book but not from Sugar, the contact will not re-appear in your address book after the next automatic sync update. To restore deleted contacts, pause the current sync and then resume, which is considered a new sync session, allowing deleted records to sync again.

Enabling Contact Sync

Sugar Connect's Contact Sync feature syncs leads and contacts that are assigned to you from Sugar to your external address book using Sugar Connect's server-side sync capabilities. Leads and contacts not assigned to you can be marked to sync from within the Sugar Connect sidebar. You must set up Contact Sync using your Sugar credentials in the Sugar Connect Portal.

Note: Please be sure to read the Sync Rules for Leads and Contacts to fully understand the sync behavior.

Follow these steps to enable Contact Sync:

  1. Open the Sugar Connect sidebar in Gmail or Outlook and launch the Sugar Connect Portal.
  2. Click on "Synchronization":
    sync
  3. Under "Setup Credentials" ensure that your email address, SugarCRM username, and SugarCRM URL is correct or click "Configure" if they have not been set up.
    syncstepone
  4. Under "Contacts Synchronization", click on "Start" to begin the one-way sync of your leads and contacts from Sugar to your external address book.
    contactsync2

Once the sync has completed, the time of the last and next sync occurrences are shown. You have the option to pause upcoming syncs at any time via the Pause button. Simply click on "Resume" when you are ready to start syncing contacts again.
contactsync

Working With Your Synced Records

For information on how to view leads and contacts synced from Sugar to your address book and how to sync a lead or contact record not assigned to you, please refer to the appropriate user guide for your installation:

Calendar Sync

If you want to use Sugar Connect to sync events between your Outlook or Google calendar and Sugar, you must first set up Calendar Sync in the Sugar Connect Portal. The next two sections explain important rules for syncing your calendars and how to set up the sync once you are ready.

Note: Sugar Connect administrators are able to set the calendar sync settings for their tenant. For more information, please refer to the Calendar Sync Settings section in the Sugar Connect Deployment and Administration Guide.

Sync Rules for Calendar Events

The sections below outline the rules that apply to the sync process for calendar events (i.e. meetings, calls, and tasks).

Initial Sync Rules

The initial sync for calendar events is a one-way sync from SugarCRM to your external calendar (i.e. Outlook or Google Workspace).

  • Only the calendar events that are assigned to you in Sugar will be synced to your external calendar.
  • It includes all events whose start date is less than 7 days back and not more than 365 days in advance. Please note, if the event has no start date set it will not sync.

General Sync Rules

Subsequent calendar sync is a two-way sync between SugarCRM and your external calendar (i.e. Outlook or Google Workspace) and occurs once every 15-20 minutes.

  • The following describes what events will or will not sync:
    • Only the calendar events that are assigned to you in Sugar will be synced to your external calendar.
    • All calendar events that were created by you in the external calendar you select (e.g. Primary Calendar), will be synced to Sugar.
    • Calendar events for which you are a guest but are not the assigned user or owner will not sync to Sugar or your external calendar.
    • Recurring calendar events will not sync to Sugar or your external calendar.
  • The following describes what event details will or will not sync:
    • Calendar events created by you in the external calendar will sync meeting participants into Sugar only if the guest exists as a contact, lead, or user.
    • Acceptance statuses will not sync to Sugar or your external calendar.
    • In the case of a conflict between corresponding synced events:
      • When the events are modified separately in the Sugar calendar and the external calendar, all details from the event that was modified more recently will be synced.
      • When events were modified at the same time, the external calendar event's changes will win over changes made in Sugar.
    • In the case of all-day events created in the external calendar:
      • The all-day event status can only be added/removed in the external calendar.
      • All-day events are synced to Sugar beginning with a start time of 12:00 AM UTC and ending at 11:59 PM UTC but will display in the user's preferred timezone.
      • If the event's start or end time is modified in Sugar by either making the event start earlier or end later than the external calendar event, especially when taking into account translated timezones, the change in Sugar may cause the external calendar event to take place a day earlier or span multiple days.

Google Workspace Sync Rules

If you are syncing with Google Workspace, take note of the following rules:

  • Sugar calls, meetings, and tasks will become calendar events in Google Calendar.
  • The guests associated with Sugar meetings and calls will sync to Google Calendar.

Office 365 Sync Rules

If you are syncing with Office 365, take note of the following rules:

  • Sugar calls and tasks will become appointments in Outlook, and Sugar meetings will be meetings in Outlook.
  • The guests associated with Sugar meetings and calls will not sync to Outlook.
  • Private events in your outlook calendar can be synced optionally.

Enabling Calendar Sync

Follow these steps to enable calendar sync via Sugar Connect:

  1. Open the Sugar Connect sidebar in Gmail or Outlook and launch the Sugar Connect Portal.
  2. Click on "Synchronization":
    sync
  3. Under "Setup Credentials" ensure that your email address, SugarCRM username, and SugarCRM URL is correct or click "Configure" if they have not been set up.
    syncstepone
  4. Under "Calendar Synchronization" you may choose to adjust the following settings:
    calsync
    • Two-way synchronization: When two-way sync is enabled, events will sync both to and from your Google or Outlook calendar and your Sugar calendar. When disabled, events will only sync one-way, from your Google or Outlook calendar to your Sugar calendar.
      Note: This option may be disabled when your Portal admin has set the sync method for your tenant.
    • Use Primary Calendar: By default, "Use primary calendar" is selected so the connector will sync events to and from your main Google or Outlook calendar. You can disable this option if you want Sugar Connect to create a new custom calendar in your client labeled "Sugar" and only events in the "Sugar" calendar will sync with your Sugar instance.
      Note: Overriding the default (selected) behavior will result in the need to create duplicates of calendar events that are created from or accepted in your external calendar in order for them to sync with Sugar.
    • Sync private events: Select this option to sync meetings marked as private from your calendar to Sugar.
    • Meetings: For two-way sync, select which Sugar meetings you want to sync based on the meeting status.
      Note: In order to enable sync, meetings must be enabled with at least one status set to sync.
    • Calls: For two-way sync, select which Sugar calls you want to sync based on the call status.
    • Tasks: For two-way sync, select which Sugar tasks you want to sync based on the task status.
      Note: Custom statuses added in Studio for meetings, calls, or tasks may take up to 60 minutes to appear in the list of available statuses under "Calendar Synchronization".
  5. Click on "Start" to begin your calendar sync.

Note: The above options will be hidden once you start your sync. To update these options you must pause and then re-start your calendar sync.

Working With Your Synced Events

For information on how to work with synced events once you have completed the calendar sync, please refer to the appropriate user guide for your installation:

Sugar Connect Meeting Scheduler

Sugar Connect's built-in scheduling system gives you a professional and convenient way to schedule meetings with prospects, customers, and anyone with whom you want to set up a meeting. Simply provide the meeting invitee with a custom link to your scheduling page, which syncs with your primary or Sugar calendar and preferred business hours, and the invitee can choose a time slot that works for them.

Note: For the best user experience, please enable calendar sync before using the Sugar Connect Meeting Scheduler.

To access the scheduler, navigate to the Sugar Connect Portal and click on "Scheduler" in the sidebar. You will see your list of standard events and any custom event types you may have created. Refer to the following sections for steps to create, share, and book new meetings using the Sugar Connect Scheduler.

Scheduler Event Types

The scheduler comes pre-loaded with three default event types, which represent standard 15-, 30-, and 60-minute meetings. You may also choose to create new event types for common meeting durations or for a specific date/time/duration use case. The available event types are displayed in the Sugar Connect Portal's Scheduler list view. At any time, you can share and re-share the scheduler links for the enabled events in your scheduler account. 
schedulereventtypes

Please refer to the Event Type Actions section for information on the actions available from the Scheduler list view.

Adding Event Types

If there is a specific meeting window or duration that you would like to set up, simply create a new event type by clicking on "Add Event Type". For example, if you want to meet with John for 30 minutes on Monday or Tuesday morning, you can create a new 30-minute event type called "Meet with John" and set your availability for that event to only the morning hours of Monday and Tuesday. For more information on configuring the event type's settings, refer to the Event Type Fields section below.
configureevent

When you share the scheduler link with John, he will be able to select a 30-minute time slot from these available times, minus any times that are already blocked off from your synced calendar.
john-schedule2

Event Type Fields

When creating a new Event Type, the Event Type form contains the following fields:

Field Description
Event Name A short name that will help you recognize the event in list view, is displayed when you share the scheduler link, and serves as the event subject.
Event Description

A longer explanation that displays under the name in list view and serves as the body of the meeting invitation.

Note: Because the person scheduling the event with you will see the event description after the meeting has been confirmed, it could contain a video conferencing link (e.g., Zoom) if desired.

Duration (minutes) The length of time in minutes to be reserved
Minimum Schedule Notice (hours) The number of hours in advance that the meeting must be booked
Create Leads in CRM Enable this option to have Sugar Connect create a new lead record in Sugar when a meeting invitee books with an email address that is not already found in Sugar

Note: You must have access to Sugar's Leads module and role permission to create leads in Sugar for this option to work as expected.
Use primary calendar

Enable or disable the option to have the meeting appear in your primary calendar instead of your Sugar calendar.

Note: The Sugar calendar, created by Sugar Connect, exists in your external email client (i.e., Outlook or Gmail). Enabling/disabling the use of primary calendar for meeting scheduler is controlled seperately from the configuration options you have selected for your Calendar Sync.

Availability

Set the available days and hours of the day for the invitee to choose from. Any existing events on your synced calendar will be automatically deducted from the available hours. Additional options are available per day:

  • Enable/Disable: Toggle availability for the day
  • Edit: For enabled days, edit the hours of the day to be available
  • Add interval: Set one or more windows of time to be available within a day

Event Type Actions

The Event Types list view allows the following actions for each event type:
event-actions

Action Icon Description
Open Scheduler Link icon-open-calendarlink Open the custom scheduler page for this event type.
Copy Scheduler Link icon-copy-calendarlink Copy the shareable scheduler page link to share with an invitee.
Edit icon-edit-event Edit the event type's settings (see Event Type Fields).
Delete icon-delete-event Delete this event type and disable its scheduler page.
Toggle Status icon-event-status Disable the scheduler page for this event type without deleting the event type. When enabled, the event type's status indicator is green; when disabled, the status indicator is gray.

When you are ready to set up a meeting with someone, simply click on the Copy Scheduler Link icon next to the relevant event type in Sugar Connect Portal:
schedulereventtypes2

The URL for the scheduler page will be stored into your clipboard and you can paste it into an email message, chat client, or any other messaging service that you prefer to use.
send-scheduler

When the recipient clicks on your link, they will see your availability according to your synced calendar and preferred meeting times for the selected event type. The options available to the invitee are explained in the Booking a Meeting section of this page.

Booking a Meeting

After you have shared a scheduler link, the invitee will click on the link and book the meeting time and date that works best for them. The following image shows an example of the page they see:
scheduler-page

The timezone option at the top of the page lets the invitee convert the available times to their own locale. The arrows on either side of the page can be used to scroll from one week to the next or previous week.

The invitee should click on the time they prefer and will then be prompted to enter their name, email address, and phone number.
bookmeeting

On save, the invitee will see a screen with the meeting's details and will receive an email with the subject "Sugar Connect: Confirm Booking Schedule". The invitee must click the link in the confirmation email in order to successfully schedule the meeting.
scheduler
confirm

Note: The meeting will only be scheduled when the link is clicked and the below screen is shown, confirming success.

success

The meeting details will then be sent to you in an automated email notification from sugar-connect-noreply@cloud.sugarcrm.com with a subject line starting with "Booked meeting:".
confirmation-email

In addition, Sugar Connect will add the meeting to your calendar with a status of "Busy" and will send a formal calendar invitation to the invitee who can then accept the meeting request to add it to their own calendar.
calendar-item

Email Tracking

Sugar Connect offers you the ability to track emails sent from your Office 365 or Google Workspace account to prospects, customers, and anyone with whom you want to track interactions. Email Tracking will show if and when 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. 

To enable or disable email tracking for Sugar Connect, please refer to the instructions in the Sugar Connect User Guide for Office 365 or the Sugar Connect User Guide for Google Workspace as appropriate for your installation.

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.

To access Email Tracking, navigate to the Sugar Connect Portal and click on "Email Tracking". You will see your list of emails you have opted to track as well as additional tabs related to email tracking. Refer to the following sections for additional information on utilizing these features.
portalemailtracktabs2

Tracked Emails Tab

Clicking on "Email Tracking" in the left will take you to the Tracked Emails page where you can view the following:

  • A list of the recipients of tracked emails, subject, status, date sent, and the number of opens, clicks, and replies. The last column allows you to pause and resume tracking the email.
  • A set of filters for the list view: Opened, Clicked, Replied, Template, Subject, and Recipients. You can also filter the list to show emails sent within the last 7, 15, 30, or 90 days.
  • The Export button that allows the user to download a csv file of the information contained in the list view.
  • A Details panel that displays the email you are viewing at the top followed by a timeline of each instance when the email was opened, a link was clicked, and any replies sent. Clicking anywhere on the email line in the list view, with the exception of the pause or resume button, will open the Details.

portaltrackedemails

Dashboard Tab

The Dashboard tab within the Email Tracking section contains a number of reports, which are able to be filtered by the Reporting Period dropdown, that will show you the following information:

  • A total number of emails tracked, opened, clicked, and replied.
  • A graph showing the total number of emails tracked, viewed, clicked, and replied.
  • A total number of contacts reached.
  • A list of the top contacts.
  • The top email templates.
  • The top links.

dashboard

Email Templates Tab

The Email Templates tab within the Email Tracking section shows a list of templates and the number of opens, clicks, and replies for each. You can filter the list by category and search by template name or owner.

Settings Tab

The Settings tab within the Email Tracking section allows the user to:

  • Track clicks on links in tracked emails
  • Auto enable email tracking
  • Show real-time click notifications
  • Enable real-time email view notifications

Note: Auto enable email tracking is not currently available for Outlook.

Last modified: 2021-10-11 19:17:29