Data Sources are used to pull data from external systems into personalization forms and push these personalizations back into the CRM. Learn more about data sources here.

This article will explain how to configure your Salesforce integration to automate personalizations in the following steps:

Contact your Customer Success Manager or support@turtl.co to get Turtl API enabled on your account

Navigate to your Salesforce integration in Turtl and confirm that it is working properly. Be sure that the correct Salesforce instance is connected.

Click on Setup for Automation:

Once this setup process is completed, you should be able to see the Turtl Personalized Doc as a new type of custom object in your Salesforce account:

3.1 Navigate to the Doc you’d like to set up for personalization. In this example, we will create a Personalization that has two tokens: name and email. These tokens will be added to single-line fields. For more information see personalization form fields.

For each personalization field, you will need to configure the ‘Prefill Value’ so that it is mapped to the Salesforce property you would like personalized in your Doc.

To do this, select the lightning icon next to the Prefill Value field:

Here you will be prompted to select the CRM to extract data. Select Salesforce and then choose the Salesforce property to map to your personalization field. For example, I will map the Name property to the name field and the Email property to the email field:

Once the property is selected, it is recommended to add a lead Id from your Salesforce database to test that the property is successfully configured. Follow this article to learn more about how to extract the lead Id from Salesforce.

When the lead Id is added you will be able to see the property value appear in the field below:

Finally, select OK to save the changes.

3.2 Once both the personalization form and Doc are completed, publish your Doc and click the Share button.

Within the share options, select the API tab and note the automation URL.

4.1 Navigate to the Object manager in Salesforce. Select the object ‘Turtl Personalized Doc’ and grant access to the lead__c field.

The ‘lead__c’ field on the Turtl Personalized Doc object is a Lookup type, which creates a relationship between a Turtl Personalized Doc object and a Lead object. This field enables us to navigate from Turtl Personalized Doc object to the Lead object and vice-versa with one simple click. The relationship between the Lead object and the Turtl Personalized Doc object is created by the Turtl API at the point of Doc creation, but some access/permissions must be granted first.

To grant access you will need to:

4.2 Next, you will need to make the lead field visible in Salesforce as it is hidden by default. To do this:

4.3 Grant access to the Turtl_Personalized_Doc__c field

In the previous step, we made the Lookup Relationship field visible on the Turtl Personalized Doc object. Now we need to make the field visible on the other end - the Lead object.

To do this follow these steps:

4.4 Lastly, you will need to make this field visible:

#datasources

The personalization engine is protected by US patents.