Salesforce Integration Setup

NOTE: This doc explains how to set up the Salesforce integration in Receptive. If you've already done this and want to know how to use the integration, then head here. 

What you need to install the Salesforce integration:

In order to get started with the Salesforce integration, you need:

• Admin access to Salesforce, including the ability to add/configure third-party apps and configure layouts.
• Receptive API key (see step 2)

How to install & configure the integration:

1. Initiate the Receptive integration in Salesforce

2. Obtain a Receptive API key

3. Configure Salesforce Preferences

4. Authenticate Salesforce in Receptive

5. Add Receptive fields to your contact layout (optional)

6. Add account value to your accounts layout (optional)

7. How to get back to your integration preferences panel (optional)

1. Initiate the Receptive integration in Salesforce

To initiate the Receptive integration into your Salesforce production environment, follow the link (will open in a new window):

https://login.salesforce.com/packaging/installPackage.apexp?p0=04t58000000Y02y

Or if using a Salesforce sandbox environment, follow this link:

https://test.salesforce.com/packaging/installPackage.apexp?p0=04t58000000Y02y

Log in to your Salesforce account.

Select "Install For All Users" and click "Install":

Under "Approve Third-Party Access" check the box "Yes, grant access to these third-party web sites" and click "Continue": 

You will get a notice that Installation is Complete and you'll need to enter your API key.

2. How to obtain a Receptive API Key:

1. Log in to your Receptive account here.
2. Select Integrate from the drop down menu in the top right corner.
3. Scroll down to API Keys and click Create API Key, or use an existing API key.
4. Keep this page open in order to authenticate with Salesforce in the next step.

3. Configure Salesforce Preferences 

1. Enter your API key into Salesforce (required)

2. Mapping your domain (optional)

If you have a white labelled Receptive domain, enter your URL under "Receptive hostname". For example feedback.examplesite.com:

3. Mapping user and account ID's (optional)

If your account and user IDs in Salesforce are the same as the account and user IDs in your product, the fields "Unique identifier" for user.id and account.id are optional and can be set to "default":

You've likely already set up your Receptive javascript integration which sends over your product's user and account IDs.

By default, the Salesforce integration will use your Salesforce user and account IDs for the users they create in Receptive.

However, in order to avoid duplicates these need to be the same.

In order to tie these two together, you can set the field where your Salesforce account and user IDs are pulled from, to create (or tie to) the correct user in Receptive.

Use the fields "Unique identifier" for user.id and account.id (see below) to pull the correct fields into the integration:

4. Mapping existing monthly account value (optional)

If you'd like to map an existing monthly account value in Salesforce to your account value in Receptive, you can do that here.

Select the appropriate field under "Account monthly value field":

And then skip step 6: "Add Account Value to your accounts layout" below. 

5. Mapping Account Types (optional)

Receptive uses the following account types: Paying, Not Paying, and Prospect.

By default, this integration will look at the Account "Type" field within Salesforce. If that field contains certain text like "Customer" or "Prospect", the Receptive account type will default to one of three options. See default rules below:

If Salesforce Account Type Contains:	Receptive Account Type will default to:
"Customer"	Paying Customer
"Prospect"	Prospect
Other	"Not Paying" Customer

If you'd like to override these defaults and map to your own account types, then select the field where this data is held in your Salesforce account under the option "Account status field (optional)":

And then you must add any identifiers for your "Paying" accounts, and "Prospect" accounts. Anything not specified here will default to "Not Paying" in Receptive.

In the example above, any accounts with the "Account Type": "Paying" or "Customer" will be identified as a "Paying" account in Receptive.

Anything with the "Account Type": "Prospect" or "Lead" will be identified as a "Prospect" account in Receptive.

Please note:

- Watch your spaces. "Customer " and "Customer" won't be a match.
- Watch the case as well. "Prospect" and "prospect" won't be a match.
- If you don't have a notion of a "prospect", you can leave the values blank.

6. Save preferences

Click "Save" and click "Done".

4. Authenticate Salesforce in Receptive

In Receptive from the "Integrate" page (from the previous step), click the button "Authenticate with Salesforce" button:

Select "Allow":

You will be redirected to the Receptive installation page to confirm authentication:

5. Add Receptive fields to your contact pages in Salesforce.

This step allows you to link Receptive features directly from the contact view in Salesforce.

In your Salesforce dashboard, click on "Contacts" in the top navigation:

Click "Edit layout":

Under the main header "Contact Layout" select "Fields" from the left hand column and select "Section" from the options. Drag "Section" down the page, below the customer details sections:

Section Name should be changed to "Receptive". Select "1-Column" and click OK:

Under the main "Contact layout" header again, select "Visualforce Pages" from the left hand column and select "Contactfeatures". Drag this into the newly created Receptive section:

Click "Save".

Click the video to see the whole process below:

6. Add Account Value to your accounts layout (optional)

This step is only applicable if you don't already have a monthly account value field in Salesforce. If you already have a field in Salesforce that shows account value, follow step 3.4 above, or see step 7 below if you've already completed setup. 

To create a new monthly account value field in Salesforce that will automatically tie to your Receptive account:

From your dashboard click on "Accounts" in the top navigation.

Click "Edit Layout".

Under the main header "Account Layout" select "Fields" from the left hand column and select "Monthly Value" from the options.

Drag "Monthly Value" to the location in the Account Layout that you'd like it held.

Click "Save".

Once done, the new field will be available when viewing/editing Salesforce accounts and will be sent to Receptive as and when required. 

7. How to get back to your integration preferences panel (optional)

Once the setup is complete, if you'd like to make any changes, you just need to go to the integration's "Preferences" page.

Go to your setup panel and search for "Installed Packages":

Click the "Receptive" package name.

Click "View" next to "Post Install Instructions":

And you'll see your Preferences:

Once you're done editing, click "Save".  

See our Salesforce FAQ.