Skip to main content

Torq Interact: Start an Interaction Flow

Learn how to start an Interaction Flow to interact with end users, create forms, pages, and more

Updated this week

An Interaction Flow allows you to collect user input, display structured information, or guide decisions as part of a workflow. You can start an Interaction Flow either as a workflow trigger or at any point within an existing workflow.

How to use

Start a workflow with the Interact trigger

Use the Interact trigger when you want the workflow to begin with user interaction.

  1. Create a new workflow: Click Create > Start from scratch.

  2. Select the Interact trigger: Choose the Torq Interact trigger as the starting point.

  3. Build your Interaction: Open the trigger configuration and drag and drop the desired elements (display or input elements) into the Interaction canvas.

  4. (Optional) Add the Interaction operator: From the operators panel, drag a new Interaction operator onto the workflow Canvas.

    • Choose the Interaction Flow assignment:

      • Select New Interaction Flow to create a new flow starting with this Interaction, or

      • Select Existing Interaction Flow to assign it to the current Interaction Flow.

    • The new Interaction will follow the trigger on the webpage or task created.

  5. Access the submitting user’s email: Use the following context reference within the workflow to retrieve the email of the user who submitted the form:
    {{ $.metadata.user_email }}

Start an Interaction Flow inside a workflow

You can start a new Interaction Flow at any point within an existing workflow.

  1. Drag the Interaction operator: From the operators panel, drag the Interaction operator to the desired location on the workflow Canvas.

  2. Configure Interaction Flow settings:

    • Name the Interaction Flow: Provide a clear, descriptive name.

    • Select the display type: Choose whether the Interaction Flow will appear as a web page or a Cases Task.

    • Configure access: Define user access as needed.

  3. Save the configuration: Click Save to apply changes.

  4. Use the Interaction Flow URL:

    • If the Interaction Flow is a web page (not a Cases Task), a URL is automatically generated.

    • This URL can be shared with end users via email, chatbot, or other communication channels.

Reference an Interaction Flow URL

You can reference an Interaction Flow URL inside other workflow steps.

  1. Open the workflow context: Type $ in a supported field.

  2. Select the Interaction Flow URL: Choose interaction_flows_url.

  3. Select the relevant Interaction Flow: Pick the flow you want to reference.

  4. Use the generated reference: The reference will appear in the following format:
    {{ $.interaction_flows_url.'My Interaction Flow' }}

Did this answer your question?