Sync Salesforce Data into Totango (Legacy connector)


Sync data attributes into Totango Accounts directly from their corresponding records on your CRM. This is used to bring critical data into Totango: 

  • Business context: Account status and contract information 
  • Account management: Account ownership and status data
  • 3rd Party data: Any other data-points of relevance to the CS team (example: Executive sponsorship flag, NPS scores) from your CRM

Totango uses this context for customer segmentation and workflow. For example, using customers renewal dates Totango builds a realtime segment of upcoming renewals with low product engagement. Using account ownership, Totango finds and alerts the relevant team-member whenever their accounts reach this stage.


- Make sure you have Totango & Salesforce users with administrative privileges.
- You must have a Salesforce Enterprise or Unlimited edition license.


- A single Totango instance can connect to a single Salesforce instance using the Salesforce App (see Configuring CRM Integrations for how to sync multiple Salesforce instances). Multiple Totango instances cannot be connected to the same Salesforce instance.

Topics covered in this article:

Step-1: Establish secure data connection 

Login to Totango and go to Global Setting | Data Management | Customer Data Hub page (Note: if you cannot access this page, your Totango user may not have admin privileges), click on the Salesforce App and provide the necessary credentials. We recommend creating a dedicated user for API access, but you can use any SFDC user with appropriate privileges for this purpose.

You will need your username, password and security-token. If all goes well you should see the green Authenticated! message as shown in the screen shot below.


Step-2: Identify the SFDC objects you want Totango to sync with

Depending on your business model and what type of business entity you want your customer success team to manage. You might want to pull into Totango several objects from SFDC, Totango can support syncing with the unlimited type of objects from SFDC. All you need to do is click on the add object button, under the object setting tab in the SFDC settings and provide the SFDC API name of the object you want to sync with (see image below)


Step-3: Identify bind fields for accounts & users

Depending on the design pattern your organization has chosen for account-id assignment in Totango, you will need to supply the appropriate field to use as a bind-field to Totango. Read more about binding fields and consult your Totango Customer Success Manager for any question. 

If you plan to use the SFDC ID, it is REQUIRED that your integration uses the 18 character ID.  The 18 character ID is a case safe ID.  To expose this ID within an Object you will need to go into the Object and create a formula field of type text.  The formula to use within that field is CASESAFEID(Id).  You can also follow this guide from Salesforce.

Tip: We highly recommend that you map Totango accounts by mapping the Totango account ID to a Salesforce formula calculated field in Salesforce. Then if this field is not populated, the account will not be brought into Totango. If the field is populated thin it will be brought into Totango. (read more)

Note: If you are bringing from other systems (for example, usage data), be sure that these ID's are common across all systems so that the data is aligned in Totango. 


Step-4: Setup Totango Attributes

The next step is to list the relevant attributes you want Totango to pull and sync from SFDC. Totango will pull the values from Salesforce every hour to keep data fresh.

Note: Account Assignment attributes meet to be set up from the 'Account Assignment' menu (Global Settings --> User Management --> Account Assignment).

Please review Attributes to sync with for more information and recommendations for managing the default Totango attributes.  

Tip: It can take up to 1 hour for new attribute data to sync from SFDC into Totango. If you'd like to see the new values apply, navigate to Settings | and click "Sync Now!"  

Step-5: Import accounts from SFDC (Optional)

One of the benefits of integrating Totango with SFDC is the transparent replication of any accounts that is created in SFDC as part of the Sales cycle into Totango for managing it by the customer success team.

To have this continues replication, you need to turn the create account from SFDC options on as demonstrated in the image below:


If you are using Totango Enterprise edition, and not turning this feature on you will be required to send us the hierarchy meta data using your usage data (Data instrumentation for hierarchies). 

Step-6: Sync Salesforce Contacts

Salesforce Contact Sync Feature Overview

What is the feature:

The ability to sync contact attributes from Salesforce to Totango allows a Totango admin user to configure the salesforce integration to automatically sync useful information from the contact record in Salesforce to the user record in Totango. This feature allows you to add attributes to an existing user in Totango, as well as to create new users in Totango who have not yet had any usage activity.

Why is this feature useful:

The ability to sync users and attributes from Salesforce to Totango allows Totango user to segment customer success communications to the end users more effectively by associating a business function, role, unsubscribe, preferences, and other business attributes with contacts, therefore allowing you to have more targeted customer success communications. This integration allows you to use the information gathered about contacts during the sales process and carry it over to the customer success process after the deal is closed.

Feature overview:

With this integration you are able to:

  • Sync users from Salesforce to Totango
  • Sync users from Totango to Salesforce
  • Determine which contact attributes should sync with each user
  • Use the synced contact attribute in Totango user segmentation, particularly in campaigns
  • The sync is available with any Salesforce object, not limited to a standard contact object

How to configure:

To make this sync work you need to specify the binding fields between  Totango users object and SFDC equivalent object (usually the contact object) by providing:

  1. The object API name in SFDC to sync the Totango users with (usually the contact object but can be any object in SFDC including custom objects)
  2. Account binding field -  The account bind field is the field which contains the unique ID of the account as identified in Totango. Depending on the implementation pattern your organization is using, this can either by the Account ID or a custom field on the Account that contains the tenant id on your application (In most of the cases, use the AccountId field).  
  3. User binding field - The user bind field is the field with the unique id of individual end-users in a Contact record. By default, Totango will use the Email address on the Contact, but if you use different values for the unique user-id on Totango, you can specify a custom field.

Some key users in your account may not come from the app itself, and you may need to get this user information from your SFDC. This becomes specifically useful when you want to address customer success campaigns to users who are not users in your application. We will now allow you to sync SFDC users to Totango. These users are going to appear in Totango with a new user attribute “CRM user”, clearly identified from the other users at that account. to turn this feature on mark the checkbox at the bottom, create contacts from SFDC.

In order to set the contact as a key contact in Totango, you need to sync the value 'yes' (lower case) to the Totango attribute “Key Contact” for the relevant user. 


Step-7: Validation

Congratulations, your Totango incoming connection is setup. We recommend you validate your data to make sure data is flowing correctly with a good match rate.

Once ready, you can proceed to install the Totango application to enable access of Totango from within and the task and touchpoint syncing package 

Need to sync more than one Salesforce instance to your Totango instance? Check out Configuring CRM Integration Connections.


Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request