- 29 Feb 2024
- 2 Minutes to read
- DarkLight
Form utilities
- Updated on 29 Feb 2024
- 2 Minutes to read
- DarkLight
Send Form creates secure and interactive web forms that help collect data, log responses, and propel workflows forward. You can trigger workflows with the form or send them as steps within workflows.
Multiple users may fill out the same form in parallel, and their individual answers will be saved.
Toggle between two form access options from the workflow settings:
- Torq users only: A Torq user with a minimum role of Operator
- Organization SSO: Users who can log in with your organization's SSO (ensure you have SSO IdP enabled from within workspace settings). Add users to the Torq group within your SSO app (ex: JumpCloud, Okta, etc.) and not within the Torq app.
Trigger workflows with a form
- Create a workflow with an On-Demand trigger.
- Within the designer, click on the trigger.
- Click on the plus sign to add a parameter to the form trigger.
- Create whatever parameters you want for the initial trigger form.
- If you want to follow up your initial form with additional forms, toggle Conclude web form with to Next form. Otherwise, the window will show a thank-you message after the user submits the initial form.
- Give your form a unique and meaningful name.
- In order to access the forms, either:
- Click on Copy to use as web form, which will copy the link to trigger the workflow, and paste that URL into your browser
- Add a step to send a message via chatbot (Slack, Discord, Teams) to the users you would like to fill out the forms containing the following:
{{ $.metadata.form_url }}
. When the workflow is run, the message will send, and the user can click the link to trigger the remainder of the workflow.
Use forms in steps
- Search for Send form under Utilities in the Steps Library
- Give your form a unique and meaningful name.
- Add as many questions as you would like using the plus sign on the line of Parameters. The following options for responses are available:
- Short/long text
- JSON
- Number
- Boolean (true/false)
- Single/multi-select
- File upload
- Markdown text (no recipient input required)
- You may click on the cogwheel to add the following optional parameters:
- Add a description that will appear as a tooltip on the related question in your form.
- Choose a default value to be returned and if an answer to the question is required in order to submit the form.
- Include a time limit by clicking the cogwheel and adding the timeout parameter.
- If you want to follow up your initial form with additional forms, toggle Conclude web form with to Next form. Otherwise, the window will show a thank-you message after the user submits the initial form.
- Send the form to the user whose response is needed using a step to send a message via chatbot (Slack, Teams, or Discord) to the users you would like to fill out the forms containing the following:
{{ $.metadata.form_url }}
.
Forms are not supported in Nested workflows. When using form steps in parallel, the order the forms will be sent can not be predicted.
Customize form logo
Add your own logo to the form display by uploading a logo PNG or SVG from within the General section of your workspace settings. This will affect every form created from within your workspace.