Concepts
Public Forms
Public forms expose actions to the outside world, allowing anyone to submit data to your stubs without authenticating with the Stubber platform.
Sometimes you want to collect data from the public or from a specific user within a stub process.
You can expose an action as a public form, which generates a unique URL that can be shared with anyone, allowing them to submit data to your stubs without authenticating.
Features
- Customizable form look and feel, allowing you to tailor the form to suit your branding with HTML and CSS
- Supports all field types available in the platform, allowing you to collect a wide variety of data, such as maps, file uploads, and signature fields
- The form automatically expires when the action is no longer available on the specific stub, ensuring that the form is only active when it can be submitted successfully
- Submissions run the action on the stub as if the data had been submitted from within the platform, allowing you to leverage all the capabilities of actions and tasks in your form submissions.
- The form can be pre-populated with dynamic data when there fields are present in the stub data, allowing you to create a more personalized and efficient user experience.
Use Cases
- If an AI agent needs to collect a large number of data points from a user, the agent can send the user a link to a public form, allowing them to submit the data and then continue the conversation or process.
- You can use public forms to initiate a new stub by setting an action on the
_createcontext to be exposed as a public form. This allows you to create a form that anyone can submit to create a new stub and start a process without authenticating with the platform. - If you have a process that requires input from external users, such as customers or partners, you can use public forms to collect that data without requiring them to create an account or log in to the platform. This can help streamline your processes and make it easier for external users to interact with your stubs.
Detailed Information
- Users can create a public form layout within the platform and customize it using the built-in AI agent.
- Any action can then be exposed as a public form by enabling the public form setting on the action and setting a
publicformlayoutuuid. - When an action is available and set as a public form, the form will be available at the URL:
https://forms.stubber.com/[stubref]/[action_name] - When the form is submitted, the action will execute on the stub with the submitted data as input.
- It is possible to inject dynamic data into the form layout using public form variables, which can be set on the action and referenced in the form HTML.