Episerver Salesforce

Note:  Episerver Salesforce is an add-onA plug-in or module, developed by Episerver or its partners, to extend the capabilities of Episerver. Add-ons are available from the Episerver Add-on Store inside Episerver. for the Episerver Digital Experience platform. It requires a specific installation and license. Contact your system administrator to find out more. See Episerver World for technical information.

The Salesforce^® add-on automatically exports form data from your website to your Salesforce account database by mapping Episerver form fields to Salesforce database fields. For information about other database connector add-ons, see Marketing Automation.

Setting up Episerver forms with Salesforce

The Forms Marketing Automation Integration (MAI) connector lets you connect Episerver form fields to a Salesforce database. See also: Marketing Automation.

Note:  An administrator must install the EPiServer.Marketing.Automation.Forms and EPiServer.MarketingAutomationIntegration.Salesforce NuGet packages to use the Salesforce connector.

1. Open the global menuA group of options that appears in the uppermost part of the user interface when logged in. The global menu displays products and systems integrated with your website. It also displays links to the user guide and user settings, and to a global search. See the User interface topic for further information. and select Admin > Config > Tool Settings > Salesforce.The Salesforce configuration settings screen appears.

   

   Note:  You can have multiple instances of the same connector. For example, if you have marketing teams in separate regions, you can have more than one Salesforce connector, such as Salesforce - Europe, Salesforce - US, and Salesforce - APAC.Click Add Connector to add another instance.

   1. Enter an email address, password, and token associated with your Salesforce account.

      The security token is emailed when a new account is set up. If you need a new token, you can get one by going to your Salesforce account and selecting My Personal Information > Reset My Security Token. Then click Reset Security Token to receive a new security token in an email that is sent to the address in your Saleforce personal settings.

   2. For Account Type, select Production or Sandbox to which you want to connect.
   3. For Multiple submissions in same session, select either Create new entity or Update previously created entity.
   4. As of Episerver Salesforce version 4.2.0, you can choose REST API to communicate with Salesforce.
      • You must have a Salesforc -connected app (see Create a Connected App) to get the ConsumerKey and ConsumerSecret for the fields. While creating the connected app, enable the Enable OAuth Settings check box and select the following OAuth scopes: Access and manage your data (api) and Allow access to your unique identifier (openid).

        

      • If you want faster performance form submissions and do not need auto-fill and personalization based on Salesforce Profile criteria, enable Enable asynchronous form submissions on the Salesforce configuration settings screen. When enabled, entities are created asynchronously when forms are submitted, but there is no user tracking.
   5. Click Save.
2. Enter the information associated with your Salesforce account and click Save.
3. Create a form on a page.
4. Click All Properties on the form.
5. Open the Mappings tab.
6. Select the database to which you map the form fields from the MA System Database drop-down field.

   

7. Click Publish.
8. On the form, select Edit from a form field's context menu.
9. Open the Extra field mappings tab. The database option that you selected earlier appears.
10. Enable the database option and open the associated drop-down to see the fields it has available. For example, if your form has a Text field that was configured to capture a name:
    1. Edit the email text field.
    2. Select the Extra field mappings tab.
    3. Select LastName from the drop-down list to map the Pardot database field to the Name field on the form.

    

11. Repeat steps 8 through 10 for as many fields that you want to map.
12. Click Publish.

To test the mapping, go to your form on a published page, fill in and submit the form, then go to your Salesforce provider to verify that the user is added to the Salesforce database.

Retrieving contact data

When a visitor submits the form, the data is sent to Salesforce. To see who submitted the form, login into your Salesforce account, select the tab you want (Account, Campaign, Contact or Lead), select the view you want, and click Go.

To create a visitor group for a Salesforce form, see Create a visitor group for an MAI connector form.