Web Forms

Web forms look like a questionnaire and collect information from people for a Pushbot instance. Because a web form is a publicly accessible web page with a form built in, you can loop customers, partners, or vendors into your automation. When a web form is submitted, all entries are available as fields in the process.

screen readers look here

Web forms are either sent in an action, like the Email: Send a Form action or can be a trigger to start a new Pushbot with a Web form trigger. In both cases, the form answers are turned into fields.

Examples of use

A web form or web form trigger is useful for collecting input from customers, partners, vendors and employees who are not users within your Catalytic team. For users on your Catalytic team, the Assign task to a person action is a simple alternative.

When a web form trigger is completed, the trigger initiates an instance of that Pushbot using the information entered into the form. This is often used as an intake mechanism for requests, tickets, or issues that can then be addressed through a Pushbot.

How web forms work

Fields filled out in a web form, like Name, Date, Claim Type, or Claim Image in the example above, are available as fields in a process.

Web forms are used in three ways:

How a web form trigger works

With a web form trigger, the web form is hosted on a publicly accessible link, like example-team.pushbot.com/form/submit-new-claim-trigger, and any time it’s submitted, an associated Pushbot starts.

screen readers look here
With a web form trigger, each submitted web form starts a Pushbot instance. In this example, when the form is filled and submitted, a Pushbot begins. The Pushbot uses the field data to create a dynamic PDF. The PDF is then uploaded online and sent over email.

How to create a web form trigger

Creating a web form trigger has two steps: first follow the steps to create a web form trigger. After the web form trigger is created, follow the steps below to add fields to the web form.

  1. From the Pushbot Settings page, head to your Pushbot level fields under the Fields section.
  2. Select Add a Field. Expand the Fields section by selecting if the Add a Field button isn’t visible. This opens the Add a Field screen.

    screen readers look here
  3. Add fields to the action in the order they should appear on the form
  4. Select each field to configure field specific settings, like type or description. See How to configure fields for more details.
  5. When finished, select .

How to share a web form

Web forms are either hosted on a publicly accessible link, like example-team.pushbot.com/form/submit-a-new-claim-trigger, or can be embedded straight into a web page.

To get started sharing a web form, select at the top of the Pushbot Settings page for the Pushbot whose web form trigger you’d like to share. You can only share web forms after adding a webform trigger.

screen readers look here
To get to the Pushbot Settings page, select All Pushbots from the top navigation, select the Pushbot to edit, then select Edit in the top right.

From the share web form screen, select the Link or Embed tab to choose how you’d like to share the form.

screen readers look here

The webform link on the link tab is a publicly accessible link that can be shared with anybody. Copy and paste it from here and add it to an email, instant message, or anywhere else.

Embed a web form into your site

From the embed tab, you can generate a piece of code and embed a Catalytic web form directly within your own website. Just add the copied code to your website’s HTML to embed the web form into the content of your website, where it will be available directly from the page.

For security purposes, you can only embed forms on allowed domains. Team admins can set these allowed domains from the admin team center, from the web form settings menu. Everyone can view a list of allowed domains using the link at the bottom of the embed page.

screen readers look here

On this page, you can see a sample form and set the embedded form dimensions. Adjust the width and height to customize how your embedded form will appear on your website—the preview on the right hand side updates dynamically to show how the form will look. After setting up the form, copy the code into the HTML of your web page where you want the form to appear.

💡Tip: If you make edits to the height, width, or logo after the code is copied or embedded, copy the code again as changes do not apply to previously embedded forms.

Manage which domains can host embedded web forms

For security purposes, you can only embed forms on allowed domains. Admins can add allowed domains from the Admin Team Center. From the web form settings screen, enter the trusted domains where web forms are allowed—web forms will only appear if hosted on an included domain.

  1. Enter the domains allowed to host embedded web forms. The domain is the part of the URL before .com. Such as www.catalytic.com.
  2. The results save automatically.

To remove a domain, select the x on an added domain.

How a web form sent by an action works

With a web form sent by email or SMS, the web form is a unique address sent directly to a recipient. It can only be filled out once. Once it is submitted, the task completes.

screen readers look here
With the Email: Send an Form action, a Pushbot sends out a web form in the middle of the process. In this example, the Pushbot creates a new table, then sends out the form. When the form is filled, that data is added to the table with a Tables: add a row action.

How to create a web form sent by an action

  1. Add an Email: Send a formaction to any Pushbot
  2. Select that action and select
  3. From the configure task page, select Add a field in the Form Fields section.

    screen readers look here
  4. Continue adding fields to the action in the order they should appear on the form
  5. Select each field to configure field specific settings, like type or description. See How to configure fields for more details.
  6. Configure the rest of the action as usual. See Email: Send a form or SMS Text: Send a form via text for more information.

Additional ways to customize web forms

Web forms have some functionality available if you customize the web form URL. The following examples involve making edits to a standard web form link. You can experiment and test these features out yourself at https://training.pushbot.com/form/webformsandbox or any web form you use.

💡Tip: For each following customization options, add a ? before the first option, and an & between any additional options.

Set unique redirect URLS when a web form is submitted

Configure your webform to redirect to a specific URL after it has been submitted, if there’s an error, or if there’s a 404 error. This is useful to redirect users to another form, a specific internal website, or to the “next step” if they’re in a process.

  • ref-success={{url}} - redirects users if their submission is successful.
  • ref-error={{url}} - redirects users if there is an error after they submit the form.
  • ref-404={{url}} - redirects users if there is a 404 page not found error after they submit the form.

Add a ? before the first options, and a & between any additional options. For example,

Hide the Submit button on a web form

Hide the submit button on a web form to create a mini-website. This is great for hosting information like a schedule, list of links, instructions, or event details.

To hide the submit button, just append disable-submit=true at the end of any web form URL. For example https://training.pushbot.com/form/webformsandbox?disable-submit=true.

Add a ? before the first customization, and a & between any additional customizations.

Auto-populate web form fields with URLs

During setup of an action or Pushbot, you can set defaults for each field so every web form has fields pre-populated. But for added customization, you can create custom web form URLs so each web form is auto-populated with dynamic data.

For example, you could generate 3 custom web form URLs for three company regions, then distribute the regional link to the recipients in each region. When the recipient accesses the web form, a Region field can be pre-filled with EMEA or APAC.

This small touch can reduce error rate in a web form by auto-populating important survey information like office, date, email address, or region. Read more about setting this up from the Auto-populate fields with URLs article.