OneReach.ai Documentation

Working with Triggered Flows

You must first build and activate your Triggered Flow. A Triggered Flow always starts with the Wait for trigger from another Flow Step template and ends with either Return Result to Another Flow or Return Error to Another Flow Step templates. The main Flow must contain either Trigger Another Flow and Wait for Result or Trigger Another Flow and Proceed Step templates. If you use the Trigger Another Flow and Wait for Result in the main Flow, it will pause until it receives the results from the Sublfow.

TIP

All Step template versions in all Flows must match.

Triggered Flow settings

Add any parameters you expect from the main Flow in the Parameters expected from the triggering flow menu. Specify the exit the Triggered Flow will return its result to the main Flow in the Return Result to Another flow Step.

TIP

The data between Triggered Flows can be transferred through Shared Merge fields.

The session timeout is set to default 2 hours from the beginning of a session by default. You can change this setting to anything between 1 min and 48 h in the Session timeout field.

Main Flow settings

You connect both Flows by selecting the Triggered Flow's name from the Flow to trigger dropdown or using a custom trigger name in the main Flow.

TIP

The custom trigger name should be unique for each Wait for Trigger from Another Flow Step throughout your OneReach.ai account.

You can add parameters manually or inherit them from the Triggered Flow in the Parameters and exits menu. The Trigger Another Flow and Wait for Result Step requires setting a timeout in the Advanced Settings. You can also shut down the Flow while waiting for the result. To do so, click the Shut down the flow while waiting toggle.

TIP

Visualize your Triggered Flow to see how it is connected to other Flows. To do that, click Bubble in View mode.

Subflow graph

Timeouts

If you are using the Trigger another Flow and wait for result Step, the Shut down the flow while waiting option is on by default. It stops the main Flow execution until the results from the Triggered Flow are received.

However, in some rare cases, make sure your Triggered Flow is executed faster than defined in the main Flow's Execution time timeout setting. Otherwise, the main Flow will shut down and not respond, even if your Triggered Flow passed some information to it. Find more information in the Trigger another Flow and wait for result Step's help file.

List of available Trigger Step templates

  1. Trigger Another Flow and Proceed: starts another Flow and proceeds with the current Flow's execution without waiting for the result.
  2. Trigger Another Flow and Wait for Result: starts another Flow and waits for its result before proceeding with the current Flow's execution.
  3. Wait for Trigger from Another Flow: starts a Flow after it is triggered by another Flow.
  4. Return Result to Another Flow: sends selected data as a result of one Flow execution to another.
  5. Return Error to Another Flow: sends selected data as an error of one Flow execution to another.
  6. Fetch Result from Another Flow: retrieves the result of another Flow's execution and proceeds depending on that result.