This article in depth describes how to set up integration between Salesforce and Aritic Pinpoint. This integration leverages the REST API and the only Salesforce editions that enable APIs are:
- Enterprise Edition
- Unlimited Edition
- Developer Edition
- Performance Edition
If your account does not fall in the above category then please contact Aritic Pinpoint support or your Salesforce rep, they will guide you and help you learn about the new update.
However, if you do own an account in the above category then, the following steps will help you to enable the plugin:
Step 1: Acquire the Client credentials of Salesforce.
1. Go to: Setup (top right corner) / Build (bottom left corner)
2. Click on Create > Apps >Connected Apps >New [marked as 1,2,3 as per the order of clicking].
3. Make sure the Selected OAuth Scopes can:
- Access and manage your data (API)
- Perform requests on behalf of you at any time (refresh_token, offline_access).
Click on Save once you are done.
4. You will see the following page with all your saved details. From here, copy the Consumer Key and the Consumer Secret.
Now, open a new tab and login into your Aritic PinPoint account.
Configure the Aritic Pinpoint Salesforce plugin
1. Click on Plugins from Settings as shown below.
2. Select CRM option to view all the CRMs available for integration. Select Salesforce CRM from the list.
3. You will see the following dialog box. Change the published status to Yes. Proceed with entering the Consumer ID and secret code that you generated via your Salesforce account. Make sure to enable pop-ups to proceed further. Click on Authorize app to get started. Next, click on Features tab to configure and map all contact fields.
4. Make appropriate selections in the Features tab and click on save and close option.
Features Tab within the plugin
- You can pull leads/push leads to and from the integration.
- Only through a form of a campaign can the “Triggered action push to integration” is done.
- Via API one can “Pull leads”.
- Through an API sync, one can “Push contacts to this integration,” every 8-10 minutes it occurs.
- Feature specific settings: Select the objects you want to pull/push records from. You can push contacts to the Leads object in Salesforce. You can also push activities (contact’s timeline records) to a custom object in Salesforce.
- Pulling records will be done from Leads and/or Contacts objects in Salesforce.
Setting up Aritic PinPoint’s Activities in Salesforce
If one wants to push Aritic Pinpoint activities into salesforce then two options are available with the Salesforce integration. The first option requires one to pass the activities into a custom object, in this way activities are reportable. The second option requires one to set up a custom URL field in the Salesforce after which Aritic Pinpoint will insert a contact’s timeline link. Due to these associated activities and their timestamps, that will be available to you :
- Emails read
- Contact Points
- Form Submits
Following are the two available options:
Option 1: Make activities reportable – you first need to set up a custom object in your Salesforce instance. Please set up the object as per the description is given below.
Step no. 1: On the initial screen of creating a custom object, make sure the Label field is populated with the value “Timeline” and the Object Name is “Aritic Pinpoint_timeline”. This will lead a few fields to auto-populate and then you are given the option to populate other fields which aren’t pre-populated by values that can relate to this object or your business. These extra fields do not have an impact on the activities.
Step no. 2: Once you save this initial screen, you will be exported to the custom objects screen where you have the liberty to set up the custom fields. Create the 7 custom fields that match the below format exactly:
- ActivityDate: Date/Time
- contact_id : Lookup(Contact)
- Description: Long Text Area(131072)
- WhoId: Lookup(Lead)
- Aritic PinpointLead: Number(18, 0) (External ID)
- Aritic Pinpoint_url: URL(255)
- ReferenceId: Text(255)
- This needs to be set up as a unique – select “do not allow duplicate values” in Salesforce
Step 3: After saving the custom object, if your Namespace Prefix is blank or missing, then leave it as it is. If the Namespace Prefix field shows up with a value auto-populated then you will need to add yours here.
Step 4: On the Aritic Pinpoint side, make sure ‘Activity’ is checked in the Features tab of the Salesforce plugin.
Step 5: Unpublish your plugin then re-publish. Save and close.
Option 2: Contact’s timeline link – One needs to create a custom URL field within Salesforce. The “Contact Mapping” tab on the Aritic Pinpoint plugin page, allows one to search for the most recently created URL field in the list of Salesforce fields. Then proceed to map this field to the Aritic Pinpoint, “Contact’s timeline link” field. After which a link will display in Salesforce, this link when clicked on will display an iframe of all activities which are related to the contact. This is the same view that you have within Aritic Pinpoint’s timeline history on individual contact records. Note that these items will not be reportable within Salesforce.
One needs to choose the arrow that points from Aritic Pinpoint to Salesforce since you need to determine the direction of the update without mapping.
The contacts need to sign up as users in case your sales reps to press the link and to be able to see the contact’s history.
Test the plugin
To make sure that the configuration was successful, you are given 3 options how to do that. A contact can be pushed to integration via these places:
- The Campaign Builder has the Push contact to integration action which can be used in the Campaign drip-flow.
- The Standalone Form has the Push contact to integration action which can be used after a standalone form is submitted.
- The Point Trigger has the Push contact to integration action which can be triggered when a contact achieves some point limit.
Use any of those triggers to test the plugin and see if the contact appears in the integration.
Recommendations and Best Practices
- Aritic Pinpoint doesn’t display the lead ID or Salesforce contact in the UI. One of the best practices is to make a custom field for the Salesforce ID within Aritic Pinpoint and map it to the Salesforce ID under “contact mapping” in the plugin. This enables one to build reports that include contacts with a Salesforce ID within Aritic Pinpoint.
- Put the plugin to test by only turning on the “Triggered action push contacts to integration” cause this allows you to test the mapping of your custom field safely with a select number of contacts only.
- In order to test, create a test segment and a test campaign with an action to “Push contacts to Integration”, so you can make sure the fields mapped appropriately.
- If setting up a Select list custom field in Aritic Pinpoint, we recommend matching the values in Aritic Pinpoint that you have in your Salesforce picklist. If you choose to not match the lists then Aritic Pinpoint can push values into Salesforce picklists only when the picklist custom field in Salesforce is set as unrestricted. Aritic Pinpoint’s select fields, by default, are unrestricted.
- Within the Features tab, in order to pull contacts in from “Activity”, you need to have a namespace prefix entered. This field is right below the Activity field on the Features tab.
- Salesforce requires values on certain fields being passed in, such as Last Name and Company Name. If Aritic Pinpoint has those fields set as blank then Aritic Pinpoint will push the value, “Unknown” into Salesforce. In case you have the “Pull contacts from integration” turned on to pull those fields into Aritic Pinpoint then Aritic Pinpoint will not populate those fields with Unknown. They will be left blank.
- If you use Salesforce campaigns, you can set up a segment to pull in members of a specific Salesforce campaign
- Create a new segment then use a filter for “Integration Campaign Members” then select the campaign you’d like to use