Apply

How to Create a Salesforce Action

Actions specify what data will move between SurveyMonkey Apply and Salesforce and when. It’s the link between an object in SM Apply and an object in Salesforce.

To create a Salesforce action:

  1. Access the Salesforce Integration section of the site
  2. Click the Title of your Salesforce integration.
  3. Click the Add Action button. This will open a dialogue where you’ll configure the action.
  4. Choose Push to Salesforce or Pull from Salesforce
  5. Complete the Add Push/Pull Action dialogue.
  6. Click Save to continue.
Add Salesforce action, Pull or Push

TIP! Push creates or updates Salesforce fields with application data. Pull bring in information from Salesforce into an application, custom field, or form fields.

The Add Push Action dialogue is where you'll finish setting up the action. Here is a list of the options to fill out:

SettingDescription
TitleThe name of your Salesforce action. Give it a clear name so you can distinguish between actions.
Salesforce Object TypeRecords that are created or updated by this action will be of an object type that is specified here.
Fire Action When:When should SM Apply sync the source object to Salesforce. The available options are, when an application has been:CreatedEditedSubmitted

NOTE: This setting should only be used within the push action of single-program sites. If you have multiple programs in your site or wish to configure advanced sync options, you should use an automation action instead. If this is the case, you can leave this selection blank and create your automation.

This section is for choosing which particular fields you want to map between the source and destinations objects. 

Field mappings, showing upsert, apply field, salesforce field and default data
UpsertThe upsert field, if selected, will cause the system to check to see if an object already exists with the same value. This field is also known as a “unique” field.

Here are a few things to take into consideration when making a field mapping Unique:

- Multiple fields can be specified as unique and then the match must be successful on all specified fields
- All unique fields must have a value in order for the sync to work.
- SurveyMonkey Apply does a search on the fields the first time the action runs.
- If it does, it will update the existing object rather than create a new one, thus ensuring that only one record in Salesforce has that value.
- If we find more than one SF object, it will fail as we have no way of knowing which object to update.
- TIP! This is commonly used with email addresses or IDs to make sure that duplicate records aren’t created for the same object.

This is case insensitive. If the field changed from “apply@surveymonkey.com”' to 'Apply@surveymonkey.com”' then the field will be updated; a new one would not be created.

If the unique field(s) has/have no value, then SM Apply does not attempt to run the action.
- The “unique” fields are seen as a unique identifier and they have to have a value; otherwise, we’ll end up with a lot of SM Apply objects pointing to the same Salesforce object.
Apply FieldSelect what data from the application you want to sync:

Available Apply Fields include:
- Form Responses
- Basic Fields about Application and Owner
- Application and Applicant Custom Fields
- Custom: use specified Default Data option

NOTE: You will not be able to use fields from the Eligibility form or Reviewer and Recommender Custom Fields. 
Salesforce FieldSelect the field the Salesforce object will push SM Apply data to.

NOTE: Required fields may be found in PUSH actions and will appear automatically
Default DataSpecifying a default value for the data will replace the value of a field with the value specified IF the source field being mapped doesn’t have a value. If mapping “Custom - use specified default data option” as described above, the default data is always used.
Add/ Remove MappingPress the plus button to add another field mapping or the X button to remove an existing mapping.

SM Apply supports Lookup fields (both optional and required) along with Master-Detail fields. For more information in regards to Relationships you can refer to Salesforce's reference material about Relationships.

Relationship mappings, showing apply action, salesforce field and default data

Relationship Mappings are located below the "Field Mappings" area of a Push Action.

You can choose to create a relationship between an already existing SM Apply Action and the Salesforce Field. The object must be the same in order to create the relationship.

For more information in regards to this, you can refer to Advanced Mapping with Relationships

If the selected Salesforce object type supports it, and if it is a Push action, you will be able to specify any file attachments that should be synced. File attachments are synced separately from the fields themselves, and the newly created Attachment object in Salesforce will be linked to the created record.

For more information in regards to this, you can refer to How to Push Attachments to Salesforce

A Pull Action is very similar to a PUSH Action, however we are pulling information from a Salesforce field into a SM Apply field. 

SettingDescription
NameThe name of your Salesforce action.
TIP! Give it a clear name so you can distinguish between actions.
Salesforce Object TypeRecords that are created or updated by this action will be of an object type that is specified here.
Fire Action when: When should SM Apply sync the source object to Salesforce. The available options are, when an application has been:
- Created
- Edited
- Submitted
NOTE: This setting should only be used within the pull action of single-program sites. If you have multiple programs in your site or wish to configure advanced sync options, you should use an automation action instead. If this is the case, you can leave this selection blank and create your automation.
Run when the following fields matchA PULL action will only occur when the selected Salesforce field matches the mapped, corresponding SM Apply field. This means that this information needs to be in SM Apply first. Custom Fields can be used with this as well. 

This section is for choosing which particular fields you want to map between the source and destinations objects.

Apply FieldSelect what data from the application you want to sync.Available Apply Fields include:
- Form Responses
- Basic Fields about Application and Owner
- Application and Applicant Custom Fields
- Custom: use specified Default Data option

NOTE: A Pull Action will not overwrite existing responses. This means that the pull will only occur once, there is no editing of a field to initiate another pull in the same form even if the responses are blank (as blanks are considered a response). Custom fields, however, are an exception to this rule.

NOTE: You will not be able to use fields from the Eligibility form or Reviewer and Recommender Custom Fields. 
Salesforce FieldSelect the Salesforce field that data will be pulled from, into the SM Apply field.
Default DataSpecifying a default value for the data will replace the value of a field with the value specified IF the source field being mapped doesn’t have a value. If mapping “Custom - use specified default data option” as described above, the default data is always used.
Add/ Remove MappingPress the plus button to add another field mapping or the X button to remove an existing mapping.

Within a Salesforce Action you can also Push or Pull Reviewer or Recommender Data to your Salesforce Account. 

Within the SM Apply Field mapping you can select both Reviewer and Recommender forms to select a question within the form to pull from. If you wish to push Scores from your form into Salesforce you will need to configure AEP to calculate the score in a hidden field within the form.

When multiple reviews are given on a single application, the data will be pushed to Salesforce, comma separated into a single record. 

To turn your action off:

  1. Access the Salesforce Integration section of the site
  2. Click the name of your Salesforce integration
  3. Under the far right column click on the More Options icon
  4. Click Activate or Deactivate
    NOTE: The option that appears will be based on the current Status of your Action.
Three dots showing more actions, Edit, Duplicate, Deactivate and delete
  1. Access the Salesforce Integration section of the site
  2. Click the name of your Salesforce integration
  3. Under the far right column click on the More Options icon, and click Edit
       -- OR --
    Click on the Name of the Action
  4. Make your required changes and click Save
  1. Access the Salesforce Integration section of the site
  2. Click the name of your Salesforce integration
  3. Under the far right column click on the More Options icon
  4. Click Duplicate
Three dots showing more actions, Edit, Duplicate, Deactivate and delete
  1. Access the Salesforce Integration section of the site
  2. Click the name of your Salesforce integration
  3. Under the far right column click on the More Options icon
  4. Click Delete
  5. Confirm that you wish to delete the Action
Three dots showing more actions, Edit, Duplicate, Deactivate and delete