Adaptal

Account Engagement Form Handler Creation and Testing

Best Practice

Account Engagement Logo 2 shrunk - Adaptal
Overview

Account Engagement (formerly known as Pardot) helps streamline sales and marketing efforts when combined with Salesforce. As a Salesforce Consulting Partner, we leverage our expertise to optimise these integrations for your business. One of the key functionalities  is the use of Form Handler.

Form Handler is a helpful tool in connecting external forms to Salesforce Account Engagement. This article will:

  1. Explain what a Form Handler is;
  2. Demonstrate how to create a Form Handler;
  3. Demonstrate how to test the Form Handler.

What is a Form Handler?

Account Engagement Form Handler can integrate an existing form on your website with Account Engagement.

Imagine the Form Handler as a bridge between the existing form and the Account Engagement Form; once the visitors/prospects submit the form on website, the handler will help map the fields to the Salesforce and create the Leads for users to engage.

How do we create a Form Handler? 

  1. Make sure the field(s) that require filling and mapping are ready. Otherwise, create custom fields in Salesforce and/or Account Engagement on the relevant objects and map them first.
  2. Go to Content > Form Handler> Add Form Handler
  3. Enter the Name, Folder and Campaign
  4. If needed, provide a specific Success Location by pasting the URL (usually a Thank You page)
  5. Add Completion Actions if needed
  6. Under Form Fields, click “Add New Fields” and the enter the External Field Name, the Account Engagement field you need to map to and the field type. Uncheck the “required” checkbox unless required.
  7. Click “Create Form Handler” at the bottom.

How do we test if a Form Handler is working? 

  1. Copy the Endpoint URL on the Form Handler created
  2. Paste it on a browser and edit the URL by adding
    1. Question mark (?)
    2. email=(prospect email)&
    3. External Field Name (if it is more than 1 word, put underscore in between words, e.g. last_name)
    4. Equal sign and then the value of the field that needs to be captured
    5. If there are more fields and values, put “&” before repeating (c) and (d)
  3. Press enter and you should be redirected to the Success Location page if configured
  4. Go to the relevant prospect in Account Engagement and check if the mapped field(s) have the value input

Here is an example where the prospect we want to test:

    1. Has an email “test@adaptal.com.au”
    2. Feedback = Good
    3. Current Status = Negotiation

https://go.sampleclient.com.au/l/1077692/2024-08-21/32vyhq?email=test@adaptal.com.au&Feedback=Good&Current_Status=Negotiation

Conclusion

Creation of Form Handler provides great flexibility especially when users / clients already have existing web forms. This way they do not have to build new forms to substitute the existing ones.