Integrating UserIQ and SFDC
Benefits to Integration
UserIQ connects to the SFDC Bulk API endpoint to perform a Bi-directional sync of data on a nightly basis. This integration allows you to PULL data from Salesforce objects into UserIQ for a deeper insight into targeted messaging and analytics. You are also able to PUSH UserIQ data such as activity and usage back into Salesforce so all of your accounts/contacts in SFDC have a complete picture.
Connecting UserIQ to SFDC
The first part of setting up the integration requires having an admin login to SFDC.
- To start the integration process, login to your Salesforce.com instance. (You will need to be a Salesforce administrator)
- Click on the Setup button in the upper right hand corner.
- In the Build section of the left navigation menu, click Create > Apps:
- In the Connected Apps list, click on the “New” button.
- In the Basic Information section, add the following details:
- Click on the “API (Enable OAuth Settings)” checkbox:
For Production, use the following value as the Callback URL:
Or for Sandbox, use the following value as the Callback URL:
- Click the Save button
Note: There will be a delay of 2-10 minutes after you click save before the Connected App is ready for users. Wait 10 minutes before continuing on to the final steps.
- In UserIQ, click on your name in the upper right corner, click Site Settings, on the menu to the left, click on the Salesforce tab.
- Enter the Salesforce Customer ID and Secret found on the Connected App page for UserIQ in Salesforce:
- Click Connect to Salesforce
a. Only use the Sandbox checkbox if you are using a sandbox instance of Salesforce
b. Once clicking Connect, you will be redirected and asked to allow UserIQ Access
- Configure Salesforce Account/User Settings
a. Choose if you want to sync Account data or User data or both
b. Choose which way to sync data - to UserIQ, to SFDC, or both
- Enable Data Sync checkbox and Save Settings
- Configure Salesforce Fields to Sync with UserIQ
a. Choose which Salesforce Object - Account or User
i. If you want to do both User and Account, they need to both be set up separately
- Configure additional outbound sync attributes. You need to set the variable scope of the Custom Variable that you want to sync outbound to Account.
b. Next, under the Sync Settings at the bottom click the Add New Outbound Field, then under the drop down on the left, select the fields you setup under Custom Variables, then click save.
* See the schema below for a list of fields