SugarCRM SupportDocumentationInstallable ConnectorsHintHint User Guide

Hint User Guide

Overview

Hint is a relationship intelligence service that makes external information available for your contacts, leads, and accounts in Sugar. Data such as social media accounts, work information, and company details are visible for contacts and leads based on their email address and for accounts based on their websites and company names. Users can then quickly import the enhanced data into the Sugar database with a single click.

Hint includes details about the individual (for the contacts and leads modules), the company, a history of your interactions with the individual or company in the Activity History section, and company news in the News section. Hint can also be configured to notify you of news on specific companies using a variety of communication channels including the Hint Insights dashlet, push notifications, and email.

Prerequisites

The following prerequisites must be met before Hint can be used:

  • Before you can use Hint to retrieve information, the package must be installed to your instance. Please refer to the Hint Installation and Administration Guide for more details.
  • Hint retrieves data based on specific fields, so contacts and leads will need an email address while accounts will need a name or website.

Understanding Hint Data

Hint retrieves data from a third-party provider rather than directly from sources such as social media and news sites. Therefore, Hint's enriched data may not exactly reflect information available by direct navigation to these sources; recent changes may not yet be available in the data set. Currently, Hint's data is strongest and most complete for individuals and companies based in the United States.

Hint Panel

The Hint panel is composed of four sections outlining details on an account, contact, or lead. It displays information on a company or individual such as company size or contact information and allows you to import this enriched data into your Sugar instance. In addition, it displays relevant information such as recent news stories and a history of recent activity related to the record in Sugar. The panel is available in the dashboard panel on list view, record view, and Global Search; refer to the Accessing the Hint Panel section of this page for more information.

Enriched Data Section

The top section of the Hint panel contains enriched data retrieved by Hint on a company or individual. If the enriched data has not already been imported into Sugar, download buttons are displayed next to each piece of information, allowing the data to be imported. To download all of the information at once, there is also a global download button in the top right corner. See the Importing Hint Data section for more information on importing this enriched data.

EnrichedDataSection

If accessing the Hint panel via the Accounts list view, the Related Contacts section is displayed below the company information. This section lists the three most recently updated contact records related to the account, showing their name, title, and contact information. If there are more than three contacts, a Show More link is displayed at the bottom which opens a Search and Select drawer containing the full list of contacts.
RelatedContacts

News Section

The News section on the Hint panel automatically shows five recent news stories about the account or about the lead or contact's company. Click any headline to open the full article in a new window or scroll down to load additional stories. To see news stories that were released after you opened the Hint panel, refresh the page.
NewsSection

The news stories can be filtered or searched using the dropdown menu in the top right corner. You can either filter by a category (e.g. Financial or Personnel), or perform a search by entering a keyword into the text field and pressing Return. The search will be applied to all news stories retrieved for the account or company. To clear a keyword search, select the All News category.

The cog button navigates to the Hint Insights Preference Center where you can configure your notification preferences for news stories. Note that this does not have any impact on the News section of the Hint panel, which only displays news stories related to the current account. For more information on the Hint Insights Preference Center, refer to the Hint Insights section of this page.
NewsSectionFilter

Activity History Section

The Activity History section appears at the bottom of the Hint panel. This section shows a history of interactions with the lead, contact, or account, ordered with the most recent on top, in order to give users a quick overview of the past interactions your organization has had with the individual. You can see more details about any of the activity records by clicking the record name, opening it in record view.
ActivityHistory

Hint will display up to 50 of the most-recent activity records that match the following criteria:

  • Calls : Related calls in a status of "Held" or "Cancelled"
  • Meetings : Related meetings in a status of "Held" or "Cancelled"
  • Emails : Related emails from the Sugar database
    • Note: Emails that are visible in the Emails module but have not been imported to Sugar will not appear in Hint's Activity History.

Accessing the Hint Panel

The Hint panel is available in the dashboard panel when performing the following actions in Sugar:

  • By clicking the Preview button on a contact, lead, or account record via the modules' list views, subpanels, and Global Search
  • By selecting the Hint panel on Contacts, Leads, or Accounts record view
  • When creating a new contact or lead record and providing an email address then moving focus away from the field
  • When creating a new account and providing a company name or website then moving focus away from the field

Accessing via Previews

Once Hint is installed to your instance, using the stock Preview button for contacts, leads, and accounts will display the Hint panel in Sugar's list-view or record-view dashboard panel.

From the Contacts, Leads, or Accounts list view, clicking a record's Preview button will open the Hint panel on the right-hand side.
PreviewFromLV

You can also click the Preview button from any Contacts, Leads, or Accounts subpanel to view the Hint panel. For example, while viewing an account record, you can scroll down to the Leads subpanel and preview a lead.
PreviewFromSP

Finally, clicking the Preview button to the right of a contact, lead, or account in Global Search will also open the Hint panel.
PreviewFromGS

Accessing via Record View

The Hint panel is also available when viewing a contact, lead, or account in record view. The Hint panel is automatically added to Contacts, Leads, and Accounts record views; it can be accessed by selecting it from the dashboards dropdown menu. To close the Hint panel and return to the dashboard that was previously displayed, click the X button in the upper right corner.
Hint Dashboard

Importing Hint Data

Hint imports external values into several stock Sugar fields as well as to custom fields added by Hint. Please note that the available fields may have been modified by your administrator to suit your organization's needs. For more information on configuring Hint's fields and layouts, please refer to the Hint Installation and Administration Guide.

The following fields in the Contacts, Leads, and Accounts modules are available to import data from Hint:

Field Name  Field Origin Import for Accounts Import for Contacts Import for Leads
Account Name Stock Sugar    
Annual Rev Hint  
Annual Revenue Stock Sugar    
Company Description Hint  
Company Facebook Hint
Company Location Hint
Company Size Hint
Company Twitter Hint  
Company Website Hint    
Description Stock Sugar    
Education Hint  
Education Additional Hint  
Facebook Link Hint  
FY End Hint
Industry Hint
Industry Tags Hint
NAICS Code Hint
Office Phone Stock Sugar  
Previous Jobs Hint  
SIC Code Hint  
SIC Code Stock Sugar    
Title Stock Sugar  
Twitter Account Stock Sugar    
Twitter Link Hint  
Website Stock Sugar  
Year Founded Hint

The custom fields added by Hint are appended to the bottom of the Contacts, Leads, and Accounts record views in a new panel named "Hint". These fields can be manually populated or downloaded from the Hint panel. Please note that the available fields may be have been modified by your administrator to suit your organization's needs. For more information on configuring Hint's fields and layouts, please refer to the Hint Installation and Administration Guide.
RecordViewHintPanel

Importing During Record Creation

Hint data can be retrieved and imported when creating a new lead, contact, or account. For contacts and leads, type the individual's email address in the Email Address field and click or tab out of the field or hit the Enter key. For accounts, populate the Name or Website field. Any enhanced data that Hint retrieves will be displayed in the Hint panel to the right. You can download individual field values using the download button adjacent to that field. You can also download all available field values using the download button on the top right corner of the Hint panel. Add or change any field values as desired, then click "Save" to create the new record.

Note: Any values you have typed into Hint's import fields after the Hint data was retrieved will be overridden by values from Hint upon import.
CreateHint

Importing to Existing Records

In addition to displaying enhanced information about existing contacts, leads, and accounts, Hint allows you to import the information into Sugar. Doing so saves the found values to the record in your Sugar database. You can download individual field values using the download button to the right of that field. You can also download all available field values using the download button on the top right corner of the Hint panel.
DownloadHint

When you click a Download button, a green checkmark will briefly display. Once you or another user have imported a field's data from Hint, the Download button will disappear for that field and Hint will no longer attempt to find an external value.

When a field has a value on an existing record in Sugar, whether due to a Hint import or because of existing data in Sugar, the Sugar value will be displayed in the Hint panel, and no download button will appear for that field in Hint. If no download button appears next to a field, that means the value displayed is coming from the Sugar record rather than from Hint. No download button will appear at the top of the Hint panel if all of the values displayed are already saved in Sugar and are not being provided by Hint.

Hint Insights

Hint Insights is a service that delivers news relevant to your key accounts using the communication channels that you prefer. Depending on how you configure it, Hint can notify you of newly released news stories for your chosen accounts through the Hint Insights dashlet, pop-up desktop notifications, and emails sent either instantly, once a day, or once a week.

Navigate to the Hint Insights Preference Center by opening the cog menu in the top right corner of the Hint Insights dashlet and clicking "Edit". From here, you can set up which companies' news stories you are notified of and how you receive the notification.

It is also possible to access the preference center via the News section of the Hint panel by clicking the cog button in the top right corner. Note that although you can access the preference center from here, it does not affect what is displayed in the News section, which only displays stories related to the current account, contact, or lead.

Both of these options direct you to the same location where you can configure your notification preferences.

Accessing the preference center via the dashlet:
HintInsightsDashletCog

Accessing the preference center via the News section of the Hint panel:
NewsSectionCog

The Hint Insights Preference Center lets you set up one or more rules that specify your notification preferences for different groups of accounts.
HintInsightsPreferenceCenter

Use the plus and minus buttons to add and remove rows; note that at least one row is required even if it is inactive. For new rows, select which accounts the rule should apply to in the first dropdown menu. If choosing accounts with one or more specific tags, a text field will appear where you can start typing to find the desired tag(s). For example, you may wish to apply the rule to only a select few accounts by adding a specific tag to them. Next, select the type of news you want to see for these accounts, then choose your preferred notification type(s). The options are outlined below:

Icon Notification Type  Description
IconDashlet Hint Insights Dashlet News stories are displayed in the Hint Insights dashlet.
IconDesktop

Pop-up Desktop Notification

News stories are displayed to the user as a desktop notification.

Note: The first time you enable desktop notifications, a pop-up will appear asking you to confirm that you want to proceed. Subsequently, your browser will ask for permission to allow notifications from your Sugar instance. You must allow notifications to receive desktop notifications from Hint.

IconInstantEmail Instant Email Alert News stories are sent as an email to the user's primary email address.
IconDailyEmail Daily Email Digest  All news stories from the last day are sent in a single daily email to the user's primary email address at 6:00 AM in the user's time zone.
IconWeeklyEmail Weekly Email Digest All news stories from the last week are sent in a single weekly email to the user's primary email address on Sunday at 5:00 PM in the user's time zone.

Note: Emails alerts and digests are sent from SugarCRM and do not use the System Email Settings configured in your instance.

If you wish to turn off all notifications for a group of accounts, please disable all of the notification types that are displayed next to it. Because at least one row is required, it is not possible to delete all of the rules. However, you can still ensure that you do not receive any notifications by leaving only one row and disabling all of its notification types.

Once you have finished updating your preferences, click "Save" to preserve the changes. Note that it may take a few minutes for the changes to take effect. In addition, if you disable daily or weekly email digests, any news stories that have already been queued up will still be sent out at the appropriate times, but no new stories will be added to the queue.

Hint Insights Dashlet

The Hint Insights dashlet displays breaking news for accounts as configured in the Hint Insights Preference Center and can be added to any list view, record view, or Home dashboard. When adding the dashlet, you can update your Hint Insights preferences before saving. Once the dashlet is added and new stories are displayed in it, click any headline to open the full article in a new window or scroll down to load additional stories.

The dashlet is one of several ways in which Hint Insights can notify you of breaking news; other options include desktop notifications and email. Once you have configured your Hint Insights preferences to show stories in the dashlet, they will begin to appear as they are released. This means that the dashlet only shows stories starting from the moment you turn on the setting. While the setting is enabled, the dashlet is continuously refreshed.

Note that the dashlet is not context-sensitive and always shows the same content regardless of where it is located. In addition, the content may not match that of the News section of the Hint panel because the Hint Insights service only includes breaking stories released after setup.
Hint Insights Dashlet

If a new story is released while you are scrolled down in the list, a notification will appear in the dashlet briefly. Clicking the notification returns you to the top of the list where the new story has been added.

The stories can be searched by entering a keyword into the text field in the top right corner and pressing Return or clicking the Search button. The stories with headlines containing the keyword you searched will be displayed, including those not currently loaded in the dashlet. However, note that the dashlet only displays stories that were released after you enabled dashlet notifications for the relevant accounts. To clear a keyword search, click the X button that appears.

The cog button to the right of the search field opens a dropdown menu with options for managing the dashlet. Choosing "Edit" navigates to the Hint Insights Preference Center where you can configure your notification preferences for news stories related to accounts, including what you see in the Hint Insights dashlet. For more information, refer to the Hint Insights section of this page.

When using a shared dashboard with the Hint Insights dashlet on it, the cog button is not displayed. However, you can access the Hint Insights Preference Center from the cog button on the Hint panel's News section instead. Using a shared dashboard containing the dashlet does not affect your preferences.

Last modified: 2019-04-18 17:00:53