Overview
In modern technology, there is a clear need to reuse objects and let the user configure each object once and repeatedly use it over and over again.
This is the basic assumption of the “Connection” configuration in Totango Customer Data Hub.
Connection to a data source is usually done by Ops or Data teams, and the main idea is that it will be configured once and you can reuse the same connection for several integrations.
Important note, the CRM integration family is a closed system, therefore, the data source connectors which are created can be re-used for only CRM integrations and not for other integration families.
Topics covered in this article:
- Creating Salesforce Connection
- Configuring Salesforce Connection
- Retrieve the client id and client secret
- Users outbound sync
- Account Assignment Inbound
- Usage Inbound
Creating Salesforce Connection
-
Go to your Totango instance and click on Global Settings > Data Management > Customer Data Hub > Click CRMs and select Salesforce
(note: you will need Totango admin privileges).
- Create a new connection (or review your existing connections)
Configuring Salesforce Connection
Salesforce configuration is based on OAuth credentials and requires a dedicated connected app configured in Salesforce. The dedicated connected app is the authentication endpoint and the OAuth user holds the object permissions to your Salesforce.
Totango Customer Data Hub is using salesforce REST API v47.0 (/services/data/v47.0) to retrieve the data and update your sync-back attributes. Read more about Salesforce Rest API.
First, you will create the connected app in Salesforce, and then create the CRM connector in Totango.
Create A Connected App in Salesforce
Creating a connected app is needed for creating an authentication endpoint within Salesforce. The new connected app informs Salesforce of this new authentication entry point and includes the relevant authentication configuration. Read more about Salesforce connected apps.
Follow these steps to create a new connected app to sync data to Totango:
1. Open SalesForce, using Admin access.
In Lightning View:
- Open App Manager under Platform Tools --> Apps
- Click 'New Connected App' from the header
In Classic View:
- Click Apps under "Build" > "Create" menu
- Scroll the bottom of the page, under the "Connected Apps" section click New to start defining a new connected app.
2. Create a new connected app.
- Enter the name of your application (Totango Connected App or your choice).
- Please note: the name 'TotangoApp' and 'TotangoAppSandbox' are saved for the Totango package. Please do not use those names to prevent duplication.
- Enter the contact email information, as well as any other information appropriate for your application.
- Select Enable OAuth Settings.
- Enter this Callback URL: https://app.totango.com/auth/connector/callback
- OAuth copes are permissions given by the user running the connected app.
Add these scopes to the "Selected OAuth Scopes" and click "Save":- Full access (full)
- Perform requests on your behalf at any time (refresh_token, offline_access) - enable it to allow the integration to ask for a token refresh without user intervention.
- Token validation is usually configured to 120 minutes, you can change it per your company standards.
- Click the "Save" button
- Click "Continue" button
- Note down your Consumer Key and Consumer Secret they are necessary for the next step of instructions
Important note, it will take 30-45 minutes before your new connected app is propagated through Salesforce infrastructure, the below steps will fail if you have not waited for it. If you experience failure with the below after 1 hour has lapsed, please contact our support team (support@totango.com).
Retrieve the client id and client secret
In Classic View:
- Login to Salesforce and open the Setup page.
- Select App Setup and click Create > Apps.
- Scroll down (Connected App section)
- Open the Connected App by clicking on his name.
- retrieve the Consumer Key and Consumer Secret from the API (oAuth) section.
- The Consumer Secret may be protected by a Click to reveal link
On Lightning View:
- Login to Salesforce and open the Setup page.
- Select Apps > App manager.
- Find the connected app and click the View at the right menu
- retrieve the Consumer Key and Consumer Secret from the API (oAuth) section.
- The Consumer Secret may be protected by a Click to reveal link
Create a CRM Connector to Salesforce in Totango
After the Salesforce connected app is created, create the connection in Totango.
Enter the connection name(MyCompanyName SFDC Connector) and description (optional), client id(Consumer Key), client secret(Consumer Secret), and select the Salesforce environment type (production or sandbox), then click the “Test and Save connection” to connect using your OAuth credentials.
You will be asked to enter your Salesforce credentials unless you are already connected in a different tab of the browser. In the later, the oAuth configuration will take the credentials stored in your active browser session.
Important note, the OAuth user holds the object permissions to your Salesforce. We recommend creating a dedicated user for this integration which has the desired object access permissions (for example, the dedicated OAuth user can access Account object but not Contact object).
Users outbound sync
In order to have a better sync of users between Totango and Salesforce, every user in Totango can be synced to Salesforce. Similarly, you can import users from Salesorce to Totango
Step by step
- Connect to Salesforce (see above)
- Select Users Outbound integration job from the Salesforce integration
- Filter the users you want to export to Salesforce and select the object and parent object
- Click 'Connect'
- The mapping page is pre-loaded with a default mapping template
Modify the mapping table if needed - Click 'Validate Mapping' and see the preview of the objects and fields that will be exported to Salesforce
- Complete the Setting and Scheduling and click 'Save and Sync'
- Note that users deleted in Totango will be deleted in Salesforce in the next job sync
Account Assignment Inbound
In Totango each Account Team is made up of a set of users, each with their own Account Assignment Role. Now you can import Account Assignment from Salesforce AccountTeamMember object or your custom object.
Step by step
- Connect to Salesforce (see above)
- Select Account Assignment integration job from the Salesforce integration
- Select Data source. Please note that the default object for account assignment in Salesforce is AccountTeamMember. You need to enable it in Salesforce or use a custom object. Read more
4. Click 'Load Preview'
5. The mapping page is pre-loaded with a default mapping template
Modify the mapping table if needed
6. Click 'Validate Mapping' and see the preview of the objects and fields that will be imported from Salesforce
7. Complete the Setting and Scheduling and click 'Save and Sync'
Notes:
- The Account Assignment job does not create new accounts in Totango
- The Accounts must exist in Totango before syncing Account Assignments. This means that Accounts Inbound job is required before the Account Assignment inbound job as we sync from SFDC only Account Assignments that their account is already matched to Totango
- The user does not have to exist in Totango. It will be created as Account Assignment contact
Usage Inbound
Usage information is important to understand the customer full picture. Now you can upload usage data from Salesforce.
This feature lets customers get the full customer picture by adding usage information from various Totango admins have a simple way to upload usage data information from Salesforce as a one-time or a recurring upload using a reliable and stable mechanism.
Step by step
- Connect to Salesforce (see above)
- Select Usage integration job from the Salesforce integration
- Select Data source parameters
-
Click 'Load Preview'
-
Complete the mapping table
- Click 'Validate Mapping' and see the preview of the objects and fields that will be imported from Salesforce
- Complete the Setting and Scheduling and click 'Save and Sync
FAQs
Question: Will the configured Salesforce integration jobs in Totango get impacted if there is a transition from Salesforce Classic to Salesforce Lightning (no change to backend code in SFDC)?
Answer: No, the jobs will not get impacted.
Comments
0 comments
Please sign in to leave a comment.