How can we help?

Enabling and Configuring Salesforce Relate To


Salesforce “Relate To” allows agents to relate calls to standard objects. This article explains how to enable the “Relate To” feature in the Salesforce managed package, how to reveal it to your agents, and the available configurations. 



  • The “Enable Relate To for Salesforce” setting is available on versions 3.12 and later of the Talkdesk for Salesforce managed package.
  • This setting will consume one PushTopic.
  • Your organization must have a custom domain to reveal the “Relate To” widget on Lightning apps. Specifically, it requires the “RelateToLayout” Utility Item, which is available only to accounts with custom domains.
  • The “Relate To” advanced options (i.e., hiding the dismissal button and enabling the pending records list) are available on versions 3.20 and later of the Talkdesk for Salesforce managed package.


Enabling "Relate To"



  1. Navigate to Talkdesk Admin [1] > Settings [2].


  1. Locate “Enable Relate To for Salesforce” and switch the toggle button to “Enabled” [3]
  2. Click Save [4].

Once enabled, the “Relate To” feature offers two other settings: 


  • The “Hide Relate To dismiss button” toggle [5] controls whether the Dismiss button shows up on the “Relate To” widget.


      • If you disable the “Hide Relate To dismiss button” setting, the Dismiss button will always show up, and the agent will be able to dismiss unrelated calls.
      • If you enable the “Hide Relate To dismiss button” setting, the Dismiss button will never show up, and any unrelated calls will need to be related to a standard object. Since it’s not possible to dismiss a relation in this case, if the call is not related to any object, it will be part of a “Pending Relate To’s” list, and the relation can be addressed later on.

Note: When the agents dismiss a relation, they are proactively saying that they don’t want that call to be related to any object.

  • The “Relate To pending records” toggle [6] gives agents the ability to relate previously unrelated calls to standard objects.

Note: In order to be able to see and resolve unrelated call records, the “Relate To pending records” toggle must be enabled.


Revealing the Widget in Lightning Apps


1. Navigate to Lightning Setup [1] > App Manager [2].



2. Locate the app in which you want to enable Salesforce “Relate To” and click Edit [3]. We’ll use “Sales Console” for this example.


3. Navigate to Utility Items [4] and click Add Utility Item [5].

4. Select RelateToLayout [6].

5. Check "Start automatically" [7].

6. Click Save once complete.

"Relate to" Settings

Once “Relate to” is enabled, you’ll see its corresponding tab within Talkdesk Admin. There, the following settings are available to be configured:



“Relate to” Objects


Defines which objects can be selected for "Relate to" a call.

  • Available. Lists all available objects for “Relate to”.
  • Selected. Lists all objects currently enabled for “Relate to”.
  • Relate to opportunity/case through. Defines which objects can relate to opportunities and cases, respectively.

Select field to display

Defines the field that is the value shown on the “Relate to” widget for each record type. The default pre-configured fields are the following:

  • Account: Name.
  • Case: Subject.
  • Contact: Name.
  • Lead: Name.
  • Opportunity: Name.

To change the fields that are displayed, there is a drop-down for each enabled object on the “Relate to” configuration. The drop-down values contain all the object fields of the following types: Text, Picklist, and Address.

In case any relatable record has an empty value for the selected field to display, the default field will be shown on the widget.

Widget Interaction

Defines how the “Relate to” widget will appear, either as a pop-up or with a notification in the utility bar.

  • Pop-up. Allows the widget to open automatically each time the execution of the feature is carried out. 
  • Notification. Allows the widget to display a notification badge in the utility bar. 

Relationship Cardinality

Defines whether agents can relate one or more calls per record.

  • Single. Allows agents to relate only one record per call.
  • Multiple. Allows agents to relate multiple records per call.

Last Viewed Records

Defines how far back previously viewed records will be eligible to "Relate to".

  • Nothing. Prevents previously viewed records from being related.
  • Last Viewed Record. Allows the last record you viewed to be related.
  • Extended Last Viewed Records. Allows you to relate up to eight of the last viewed records within three minutes prior to the call start time.

Note: If you choose Nothing, the last viewed records list will not show any record, but you can still relate to the last viewed records by searching them in other parts of the widget.

Log on task

Defines whether calls will be automatically logged as tasks per related record.

  • Enabled. Calls will be logged as tasks on related records automatically.
  • Disabled. Calls undergo no automatic logging.

Note: Salesforce tasks do not relate to Contacts or Leads. Consequently, no task is created when related to Contacts or Leads. 'Related to' field.


Defines whether Relate To will automatically relate an object to a call, regardless of any user interaction, if it finds only one possible record to relate based on the phone number.

  • Enabled. Objects are automatically related if they’re the only eligible record.
  • Disabled. Objects undergo no automatic relation.

Show search bar

Defines whether the search bar will appear in the widget. We recommend enabling this feature.

  • Enabled. Reveals the search bar.
  • Disabled. Hides the search bar.

Lead conversion options

Defines whether a corresponding Account, Contact, or Opportunity will automatically adopt related calls when converted from a Lead.

For example, if you convert a Lead while Account and Contact are checked, calls related to the Lead will migrate to its corresponding Account and Contact.

Relate To logs retention period

Defines how long "Relate to" logs will be preserved for troubleshooting and related research by Talkdesk support. The option to Delete all history now is also available.


Once "Relate To" is enabled and configured according to your needs, your team can start using Salesforce Relate To.

All Articles ""
Please sign in to submit a request.