Follow

Salesforce

Time to read: 10 min

topic.pngThe article covers the following topics:

How to start working with Salesforce?

To work with SalesForce, you should have an account and register a Connected App on Salesforce. You can configure a flexible synchronization of fields.

For successful integration, you need to follow the next setup plan:

  1. Create a Connected App on the Salesforce side, through which data will be transferred from Affise to a Salesforce account.
  2. Get authorization details and input them into Affise.
  3. Grant data management rights to the Connected App on the Salesforce side.
  4. Set up synchronization between affiliate fields on Affise and fields on Salesforce.

Step 1. Setup on Salesforce

First, you need is to create a Connected App. Log in to Salesforce and go to the Setup section:

Screenshot_161.png

Next, you need is to find 'App Manager' with the help of the search bar:

Screenshot_162.png

Click on the 'New Connected App' button and fill in all required fields in the Basic Information section.

_______2020_04_09_16_30_35_728.gif

Fill in required fields: Connected App Name, API Name, Contact Email:

Screenshot_164.png

import.pngAffise API domain needs to be available on HTTPS protocol only. 

click__1_.png Find out more about How to set custom domain name in Affise here.

Screenshot_from_2020-04-08_11-02-20.png

import.png You need to select: 1) Access and manage your data (API) and 2) Perform requests on your behalf at any time (refresh_token, offline_access). 

Save your New Connected App by clicking on the dedicated button.

After saving your New Connected App, you will get 'Consumer Key' and 'Consumer Secret' to be needed during the Affise integration setup process:

Screenshot_165.png

Step 2. Fields in Salesforce

Salesforce has the essence of Leads, which is essentially the equivalent of the Affiliates in Affise, but Leads has its own set of pre-installed fields. View the Leads object as follows: navigate to the search bar and enter 'Lead' and go to the 'Object Manager' section:

Screenshot_169.png

In the 'Object Manager' - > 'Details' Tab, you will see 'Api name' field used as Salesforce destination object on the Affise side to unload data into this object:

Screenshot_170.png

Get the fields in the 'Fields&Relationship' section in the Lead object to match them with Affise's fields:

Screenshot_171.png

 

Step 3. Custom object and fields

If you don’t want to use the default Lead object for some season, you can create your object and fill it with the necessary fields. Navigate to 'Object Manager' section - > 'Create' button - > 'Custom Object' section:

Screenshot_172.png

Further customization of the object depends on your needs. However, we need to know the object name by which we can access it (API name). In the New Custom object field, you need to fill in all the required fields and save your new object:

_______2020_04_09_18_35_32_758.gif

Step 4. Setup on Affise 

To set up integration with the Salesforce plugin on Affise side navigate to the 'Marketplace' section and select the 'SalesForce - Leads' plugin:

Screenshot_166.png

 Fill in all fields: 

Screenshot_167.png

Where:

  • Consumer Key and Consumer Secret - fill these fields with the data from Step 1. Setup on Salesforce
  • API URL - fill it with https://{salesforce-instance-name}.salesforce.com/services/data/v48.0. You can find your Salesforce instance name in the 'View Profile' Tab on the Salesforce side: 

Screenshot_168.png

  • Salesforce destination object  - fill it with 'Api name' from Step 2. Fields in Salesforce
  • Salesforce domain - fill it with https://{salesforce-instance-name}.salesforce.com.  You can find your Salesforce instance name in the 'View Profile' Tab on the Salesforce side. 

After filling all the fields, save your integration by clicking on the dedicated button.

Step 5. Fileds in Affise

In the plugin settings, click on the 'Setup fields' button or navigate to 'Settings' section - > 'Content' - > 'Salesforce fields' section

Screenshot_173.png

Here you will see the list of Affiliate fields in Affise (on the left) and Salesforce fields (on the right). Take the fields from the 'Fields & Relationship' section on the Salesforce side of the object into which the data will be unloaded. Once the needed fields have been matched, click on the 'Save' button. It is not necessary to set the match for all fields; the blank fields will be ignored when the data are unloaded. 

Step 6. Grant permissions

On the plugin page, click on the 'Grant permissions' button:

Screenshot_174.png

You will be redirected to Salesforce, where you should authorize and allow the integration with the Connected App:

KM_QC_Space__5_.jpg

Step 7. Health check assessment

After creating or editing Affiliate in 'Affiliate' section - > 'Affiliate management' section, you will see a green notification:

mceclip1.png

 If you have more questions on the Affise <> Salesforce integration, feel free to contact the Salesforce Team or Affise Support Team via support@affise.com or your Dedicated Account Manager.

Written by Anastasia Deryugina

 

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.