Brightspot Content Types Guide

Modules

Form module

Back to Form module

Form submission actions

When a visitor fills out a contact form, custom form, or third-party form, and clicks Submit, Brightspot ingests the data and can take a variety of actions with it.

Data collection

Brightspot stores the submitted data in a raw format, and your web application can ingest the data as required.

Email

Brightspot sends an email after ingesting the data. You can configure the email to include information that the visitor submitted in the contact form using a command of the form ${parameter-name}. The following example shows how to send an email to a customer service center that includes the visitor's email address.

Step 1: Set parameter value

Create a form with an email text field. Under more_horiz> Advanced, in the Parameter field, note or change the value as required.

Step 2: Refer to parameter

Create an email action that uses the parameters.

Create an email action that uses parameters.png

In the previous illustration, Brightspot populates the email's body using the value visitors-email-address that the visitor entered using the form in Step 1.

Step 3: Add filtering rules

You can add filtering rules that examine email addresses before Brightspot forwards them to your email server. Brightspot processes only those email addresses that match the rule.

Under more_horiz> Styles, in the Custom Pattern field, enter a regular expression.
In the Custom Pattern Message field, enter a message that appears on the form should the submitted email address not conform to the regular expression.

Referring to the previous image, if the submitted email address contains @example.com, Brightspot displays the following message:

Thank you for your interest. Please use your business email address.

External submit

Brightspot can forward a visitor's contact information to an external application. This scenario occurs when your organization manages a sales or technical support effort using an application other than Brightspot.

To configure an external form submission action:

Under Actions, click External Submit Action. An Action Link form appears.
Using the following table as a reference, configure the external link and the information sent to it.

Field	Description
Submit Method	GET or POST. For an explanation of these terms, see The Method Attribute. Consult with the external application's developers to determine which of these settings to use.
Main widget
URL	URL of the application that ingests the visitor's data.
Advanced widget
Target	How the visitor's browser displays the response from the external application. Same Window/Tab—Browser displays the external application's response in the same browser window or tab from where the visitor submitted the form. This selection replaces your form with the response. New Window/Tab—Browser displays the external application's response in a new browser window or tab.
Attributes	Name and value pairs Brightspot appends to the visitor's submitted contact information. You can use this field to collect additional information about the visitor, such as from which site the visitor submitted the form.

Third-party submit

When you select an third-party external submit action, such as Hubspot External Submit Action or Marketo External Submit Action, Brightspot

To configure an external form submission action:

Under Actions, click External Submit Action. An Action Link form appears.
Using the following table as a reference, configure the external link and the information sent to it.

Field	Description
Submit Method	GET or POST. For an explanation of these terms, see The Method Attribute. Consult with the external application's developers to determine which of these settings to use.
Pre Processor	The action Brightspot takes before forwarding the form submission. None—No action is taken, and Brightspot forwards the form submission directly to the URL. Default External Submission Pre Processor—Brightspot pre-processes the form submission, inspecting it for malicious or invalid data before forwarding the submission to the URL. This option is ideal for relieving high-volume receiving servers that may not have enough resources to do the inspection.
Main widget
URL	URL of the application that ingests the visitor's data.
Advanced widget
Target	How the visitor's browser displays the response from the external application. Same Window/Tab—Browser displays the external application's response in the same browser window or tab from where the visitor submitted the form. This selection replaces your form with the response. New Window/Tab—Browser displays the external application's response in a new browser window or tab.
Attributes	Name and value pairs Brightspot appends to the visitor's submitted contact information. You can use this field to collect additional information about the visitor, such as from which site the visitor submitted the form.