The Salesforce Integration Options page allows you to manage the integration between your Communications Enterprise account and your Salesforce account.

NOTE: This page is only accessible if the login provisioned for the Communications Enterprise integration is a standard Salesforce license.

Access the Salesforce Integration Options page

Current admin experience

1. Access the Admin interface.
2. Navigate to the Automation tab.
3. Under Campaign Tools (left sidebar), click Salesforce Integration.

New admin experience

1. Access the Admin interface.
2. Navigate to Campaigns > Salesforce Integration.

Before using this page...

• Changes on this page immediately go into effect.
• If you apply any changes, all of your Marketing Automation campaigns will automatically use these new options.
• Which options are best will depend on how your Salesforce account is set up. Review your Salesforce data structure before making any changes here.

Configuration options

The configuration options on this page are grouped into five sections, each discussed in its associated section below.

1 - Map Communications Enterprise Fields to Salesforce Fields

In this section, you can assign a one-to-one relationship between recipient fields in Communications Enterprise and Salesforce.

There are two separate mappings: One for Leads and one for Contacts. Switch between them by using the Lead and Contact buttons at the top-right of this page.

To map a field:

1. Click the + add another field link at the bottom of the page.
2. Click the Select Field link to choose a Communications Enterprise field.
3. Click the Select Integration link to choose the corresponding Salesforce field.
4. Check the Key Field box to use this for record matching. More information about this is available below.
5. Click Apply Mappings at the bottom of the page to save your changes.

Communications Enterprise Fields  

• All standard fields (Email, First Name, Last Name, etc.) are available
• Any custom fields you have created are available
• A user can only map Enhanced Personalized Fields if they are shared with that user. Private fields can only be mapped by the user with access to them

Salesforce Fields

• All Salesforce fields are available

Current Mappings

• To change either the Communications Enterprise or Salesforce field in a mapping, click the field link and select a different field.
• To delete a mapping, click the X next to it.

Key Fields

Key fields are used to determine, before a record is added to Salesforce, whether it already exists. Communications Enterprise will search Salesforce using for records which match the key fields. If a record is found, then a new one is not created. Instead, Communications Enterprise will get the Salesforce ID for the existing record and store it in Communications Enterprise.

NOTE: This is required for this page. At a minimum, email address should be selected for both Leads and Contacts.

Which fields should I map?

If you’re not sure which fields to map, you should consider what information you will need to match in both systems to effectively run your marketing campaigns. Communications Enterprise's recommendations are:

• You will almost always want to map the Communications Enterprise Email field to the Salesforce Email field. Communications Enterprise is an email-based system, after all!
• First Name and Last Name are extremely useful fields, as well.
• Map any other fields which are important to your sales efforts. These might include fields such as address, title, or client level.

NOTE: Remember, this key field page controls the information created in Salesforce, but also controls what information is updated in Communications Enterprise should you email from Salesforce to Communications Enterprise.

2 - Map Communications Enterprise Messages to Salesforce Logins

One of the features you get when you integrate Marketing Automation with Salesforce is the ability to send Communications Enterprise messages from inside Salesforce. Use this section to customize which Salesforce users can send which messages.

To map messages:

1. Click the + add another mapping link at the bottom of the section.
2. Click the Select Message link to choose a Communications Enterprise message.

1. Only email messages are available.
2. Only one message can be selected for each row.

3. The default is to make the message available to all Salesforce users. To limit availability, click the All Logins link, and select one or more logins.
4. Click the Apply Mappings button at the bottom of the page to save your changes.

Once a mapping is assigned to a login, that user can go to a Contact or Lead Detail page in Salesforce and send that Contact/Lead a Communications Enterprise email. They will have a dropdown available for all emails mapped to their login.

Mapping Messages and Logins

• You can map any Communications Enterprise message which you have permission to view.
• You can map any logins associated with the integrated Salesforce account.

Current Mappings

• To change the message selected for a mapping, click the message name and select a different message.
• To change the logins who can send the message, click the logins link and select one or more different logins.
• To delete a mapping, click the X next to it.

3 - Map Communications Enterprise Templates to Salesforce Logins

One of the features you get when you integrate Communications Enterprise with Salesforce is the ability to send Communications Enterprise messages from inside Salesforce using a Contact or Lead View. Use this section to customize which Salesforce users can send which message templates.

Mapping Templates

To map messages:

1. Click the + add another mapping link at the bottom of the section.
2. Click the Select Template link to choose a Communications Enterprise template.

1. Only published templates are available.
2. Only one template can be selected for each row.

3. The default is to make the message available to all Salesforce users. To limit availability, click the All Logins link, and select one or more logins.
4. Click the Apply Mappings button at the bottom of the page to save your changes.

Once a mapping is assigned to a login, that user can go to a Contact or Lead View in Salesforce and send those Contacts/Leads a Communications Enterprise email. They will have a dropdown available for all templates mapped to their login.

Mapping Templates and Logins

• You can map any Communications Enterprise template which you have permission to view.
• You can map any logins associated with the integrated Salesforce account.

Current Mappings

• To change the template selected for a mapping, click the template name and select a different message.
• To change the logins who can send the template, click the logins link and select one or more different logins.
• To delete a mapping, click the X next to it.

4 - Set Default Values

NOTE: You must configure any and all required fields for record creation from Salesforce in this section.

You can set default values for your Salesforce fields. If Communications Enterprise tries to upload a recipient to Salesforce, and the recipient is missing information for a field, Communications Enterprise will send the default value.

This section allows you to set what the default values are. You will need to set defaults for Leads and Contacts separately. Switch between them by using the Lead and Contact buttons at the top-right of this page.

Your Salesforce account may have one or more fields required for Leads and Contacts. These fields require default values to prevent recipient uploads from failing.

You can also choose to set defaults for fields which are not required.

Setting Default Values

To set the default values:

1. Click Leads or Contacts to switch between the required fields for each type of record.
2. Enter your chosen default value in the text box for each required field.
3. If you would like, click add another field to add a field which is not required.

1. Click Select Field to choose a non-required field from the list.
2. To change a field selection, click the name of the field and select a new one.
3. To delete a default, click the X icon at the right side of the row.

4. Click the Apply Mappings button at the bottom of the page to save your changes.

Communications Enterprise will allow only certain values to be entered for each field type. The field type is determined by Salesforce.

Field Type	Valid Input
picklist	String
string	String
textarea	String
phone	String
url	String
email	String
anyType	String
boolean	Select ‘true’ or ‘false’
int	Only digits or minus sign (no commas)
double	Only digits, minus sign, or decimal point (no commas or symbols)
currency	Only digits, minus sign, or decimal point (no commas or symbols)
percent	Only digits, minus sign, or decimal point (no commas or symbols)
date, time, datetime	Select time and date

NOTE: Please make sure that your entry matches the format required for the field by Salesforce. This ensures that uploads will work correctly.

Recommendations

Communications Enterprise recommends that you set up a “catch-all” account in Salesforce for all incoming Contacts, and set this as the default account. That way, you will have one place where you can see all the Contacts recently added by Communications Enterprise. Then you can assign them to whichever account makes most sense for your business needs.

5 - Update Salesforce Field on Unsubscribe

You can update one field in Salesforce based on whether a recipient unsubscribes. If a recipient unsubscribes in a message via a Marketing Automation campaigns and the recipient is in Salesforce, Communications Enterprise will set the field value.

You will need to set the unsubscribe field for Leads and Contacts separately. Switch between them by using the Lead and Contact buttons at the top-right of this section.

NOTE: This is one-way stream of data; Communications Enterprise will update the flag in Salesforce, but it is still up to your list creation method to exclude recipients who have unsubscribed outside of Communications Enterprise.

Updating Salesforce Fields on Unsubscribe

1. Click Leads or Contacts to switch between the required fields for each type of record.
2. Check to update the Lead/Contact field.
3. Click Select Field to choose the field you would like to update.

1. To change a field selection, click the name of the field and select a new one.

4. Click the Apply Mappings button at the bottom of the page to save your changes.