In this guide, we will look at:

  • What are field mappings
  • The difference between non-configurable & configurable field mappings
  • Where to view field mappings
  • Viewing Campaign import rules

What are field mappings?

Field mappings show which Salesforce record (Lead/Contact) attributes we will be importing and which Saleswhale fields they will be stored as.


For example, in the above screenshot:

  • the First Name of Leads in Salesforce will be mapped to a Saleswhale field also called First Name
  • the Title of your Leads in Salesforce will be mapped to a Saleswhale field called Job Title

These Saleswhale fields can subsequently be used as merge tags in your conversation topic to personalise your AI Assistant's emails.

After these fields have been mapped across successfully, you can find them when you navigate to your Lead's detail page, and click on 'Edit Details'.


The mapped attributes will not be editable within the Saleswhale app.

For now, we only pull in Salesforce attributes on first import. As we do not currently support bi-directional sync between the two platforms, any subsequent changes made on your Salesforce records will not be synced across to Saleswhale.

The difference between non-configurable & configurable field mappings

Non-configurable field mappings

These are non-editable mappings that come out-of-the-box with your integration:

  • Id (Salesforce) -> CRM Object Id (Saleswhale)
  • First Name (Salesforce) -> First Name (Saleswhale)
  • Email (Salesforce) -> Email (Saleswhale)
  • Company (Salesforce) -> Company (Saleswhale)
  • Owner (Salesforce) -> Sales Rep (Saleswhale)

Configurable field mappings

Configurable field mappings are customisable mappings. Many fields in Salesforce can be mapped to Saleswhale fields. However, it is recommended to choose only string-based data types (e.g. text or textarea) or picklists where the internal field name can be used, as we currently do not support formatting values returned by Salesforce.

To set this up, email us at and your Customer Success Manager will be setting this up for you.

Here are some examples of configurable fields:

  • Last Name (Salesforce) -> Last Name (Saleswhale)
  • Title (Salesforce) -> Job Title (Saleswhale)

Where to view field mappings

To view your field mappings, navigate to the Integrations tab under Settings, then select Salesforce.


Viewing Campaign Import Rules

To view your Campaign import rules, navigate to your specific campaign and click on Settings.


You will also be able to see how many Salesforce records fit your criteria and are available for import into the campaign.

Did this answer your question?