Skip to main content

Flows

AIQ Flows automate customer journeys based on real-time actions. Use triggers, delays, and actions to power welcome series, abandoned cart, win-back, and retention campaigns.

Updated today

Overview

A Flow is made of connected nodes (triggers, actions, delays, splits, integrations). Personas enter a Flow when they match the trigger criteria, and each node determines what happens next.

You can start from scratch with a Trigger-Based Flow or from a prebuilt Flow Template.


Prerequisites

Before getting started, ensure you have:

Required Permissions:

The following roles have access to create Flows:

  • Marketing

  • Marketing + Analyst

  • Operator

  • Owner

⚠️ Only users with Operator or Owner permissions can launch a flow by default. However, this capability can also be enabled for Marketing and Marketing + Analyst roles through the Members Settings.

Other Requirements

  • Marketing Pro (or higher) subscription

  • Required integrations connected (for purchase, abandoned cart, behavioral triggers)


How to Create a Flow

Option 1: Create a Trigger-Based Flow

  1. Navigate to Marketing > Flows

  2. Click the plus (+) icon to create a new Flow

  3. Choose a Trigger

  4. Configure trigger parameters

  5. Click Add Requirement

  6. Click Save

Common Trigger Types

  • Signup Form → Persona submits a form

  • Audience Events → Persona enters or exits an audience

  • Abandoned Cart → Based on integration data

  • Purchased → Product, brand, or category-based

  • Behavioral Events → Viewed but didn’t buy (integration dependent)

  • Points Events → Earned, redeemed, unlocked

  • Campaign Events → Opened, clicked, received

  • Lifecycle Events → Birthday, inactive, X days since last order


Option 2: Use a Flow Template

  1. Navigate to Marketing > Flows

  2. Under Pre-Built Flows select your template

  3. Customize triggers, messaging, and logic

  4. Save

Available Template Categories

  • Welcome Series

  • Abandoned Cart

  • Win-Back

  • Repeat Purchase

  • Retention

  • Opt-In Messaging


Flow Builder Basics

The Flow Builder uses a drag-and-drop interface. Nodes must be connected, no standalone or disconnected nodes.

Key builder functions:

  • Zoom in/out via floating controls

  • Save as Draft, Duplicate, Archive

  • Edit Details (name, tags, dates, budget)

  • Switch between Edit and Analytics modes

  • Back button returns to Flow Table (warns if unsaved changes)

Once you start building, each node must be configured before the Flow can launch.


Node Types

Nodes define the actions taken as personas move through the Flow. There is no limit to how many nodes a flow can contain.

A Flow can start with either a Trigger or a Split. Both nodes contain Traits, that qualify (or not) personas from entering the flow. There are also new Flow-specific Traits you can use as well.


Trigger Node

Defines how personas enter the Flow.

  • Multiple triggers allowed

  • Cannot be edited once Flow is live


Split Node

Routes personas into Yes/No paths based on an audience.

  • Define your Traits or select from an existing audience

  • Multiple splits are allowed per flow

  • You can start your flow with a split


AI Split

AI evaluates a yes/no condition and routes personas accordingly.

  • Must be a yes/no question

  • Must end in a question mark

  • AI evaluates the condition


Message Node (Campaign)

Send a message through all of our available channels (excluding Loops)

  • Must include at least one message to launch

  • Campaigns created in Flows do not appear in the main Campaigns list

  • Content can be edited after launch (if persona hasn’t reached node yet)


Give Discount

Attach a discount to personas moving through the sequence.

  • Select an existing discount or create a new one

  • Discounts created in Flows do appear in the main Discounts list


Gift Points

  • Gives customer loyalty points (a fixed amount defined in the node settings)

  • Processes in real-time once persona reaches node


Time Delay

Pause the Flow before moving to the next step.

  • Minimum delay: 30 minutes

  • Maximum delay: 1 year

  • Messaging triggered after a delay will still follow quiet hours, TCPA, 10DLC, and unsubscribe rules


Persona Update Node (Coming Soon)

Modify a persona's traits or opt them out of specific channels when they reach this step. See Persona Update Node for more info.


Integration Node (Coming Soon)

Node representing events from external systems.


Flow Details Settings

When you go to save or launch a flow for the first time, you will be prompted to fill out the Flow Details. You can also access these settings in the flow builder, click on the (...) more menu > Edit Details.

  • Name: The internal name of the flow. This name is used for identification and reporting and is not visible to your customers.

  • Tags: Tags help you organize and manage your flows. Tags are shared globally across AIQ features, including campaigns, making it easier to filter and group related assets.

  • Start Date / End Date: Optionally set a start and end date to control when the flow is active. If no dates are set, the flow will run continuously until paused or disabled.

  • Daily Max Credits: Optionally set a daily spend or credit limit for the flow. If this limit is reached, the flow will automatically pause for the remainder of the day and resume the following day.

    • Note: Clients on legacy pricing will see dollars here instead of credits.

  • Lifetime Max Credits: Optionally set a total lifetime spend or credit limit for the flow. Once this limit is reached, the flow will be disabled and will not resume unless manually updated.

    • Note: Clients on legacy pricing will see dollars here instead of credits.

  • Flow Attribution Window: Sets the attribution window used to measure conversions and revenue for all nodes within this flow.

    • The default attribution window is configured in Settings → Company Account → Account Settings, but can be overridden at the flow level if needed.

  • Flow Re-entry: If re-entry is enabled, they may enter the flow again later (after completing the entire flow) if they meet the trigger conditions again.

    • Flow cooldown: When re-entry is enabled, a cooldown period (in days) is required. This determines how long a customer must wait before they can enter the flow again.

Only certain Traits qualify for re-entry.


Timing Differences: Audiences vs Flows

Traditional Audiences are not updated in real time and typically become available after an overnight capture. Audience-based campaigns can only message customers once this overnight process completes.

Flows process events and traits more frequently than traditional audiences, allowing for faster follow-up in many cases. However, timing varies by trait type:

Trait Timing

Available in 5–20 minutes:

  • Messaging & opt-in–related traits (e.g. submitted signup form, opt-in status change)

    • Does not include signed up via referral

  • Custom attributes

  • REST API traits

Traditional Audience Capture:

  • Sales-related traits (purchases, transactions)

  • Persona attributes (name, phone, email used for targeting)

Real-Time:

  • Gift Points & Discount nodes (after persona reaches node)

⚠️ Note: Trigger and split conditions created in flows will not be added to the Audiences list and is isolated to just that flow.


Best Practices

Avoid Using Opt-Ins as Triggers in Re-Entry Flows

Do not use opt-in status as a trigger when flow re-entry is enabled.

For example, using a trigger like Email Opt-In = True can cause personas to repeatedly re-enter the flow because opt-in status rarely changes. This can unintentionally create looping behavior.

Instead, trigger the flow using an actual event or behavior, then use a split inside the flow to check opt-in status and route personas to the appropriate channel.


Use Multi-Channel Splits

Customers are not always reachable through a single channel.

Use splits within your flow to check available channels and route personas accordingly, such as:

  • Email if email opt-in is available

  • SMS if SMS opt-in exists

  • Push notification if app push is enabled

  • Or fall back to another channel when one is unavailable

This ensures more customers receive your messaging instead of being excluded from the flow.


Trigger on Actions (Not Static Traits)

Flows perform best when triggered by customer actions or events, such as:

  • Purchase made

  • Cart abandoned

  • Signup completed

  • Loyalty points earned

  • Reward redeemed

Avoid triggering flows on static profile traits that rarely change, as this can cause unintended re-entry or low relevance messaging.


Add Delays to Prevent Over-Messaging

Use delays between steps to avoid overwhelming customers with multiple messages in a short time.

Spacing messages improves engagement and reduces opt-outs.


Keep Flows Goal-Focused

Each flow should have one clear purpose, such as:

  • Welcome new customers

  • Win back inactive customers

  • Encourage repeat purchases

  • Promote loyalty engagement

Avoid combining too many objectives in one flow, as this makes performance harder to measure and optimize.


Launch & Editing Rules

Launch Requirements

  • A Flow cannot be launched if any node is unconfigured.

  • All sends follow: TCPA, Quiet hours, 10DLC, Opt-in and unsubscribe handling, Persona frequency caps


Once a Flow is live:

  • Only Time Delay nodes can be edited

  • You cannot change the trigger

  • You cannot reorder nodes

  • You cannot alter logic

Message (campaign) content can be edited; personas who haven’t reached the message node will receive the updated version.


Flow Analytics & Reporting

AIQ provides two ways to view flow performance, depending on the level of detail you need.

  • For step-by-step, node-level analytics within a flow, see Flow Analytics.

  • For aggregate performance reporting across all flows, see Reporting.


Troubleshooting

Flow Won’t Launch

A Flow can only launch if all nodes are fully configured and valid. Check the following:

  1. One or more nodes are unconfigured. Configure each node until alerts disappear.

  2. The trigger setup is incomplete


Personas Aren’t Entering the Flow (no entrants)

If your Flow shows zero entrants, the issue is almost always related to triggering or data availability. Possible causes:

  • Trigger conditions have not been met (e.g. no one has submitted the signup form)

  • Fix: Check the analytics for that trigger (audience, signup form, etc.)

  • Audience logic is too restrictive

  • Fix: For Audience-based triggers, overly narrow filters may match zero personas. Preview the audience → check how many personas qualify.


Personas Are Stuck / Not Moving to the Next Node

If a persona enters the Flow but stops progressing, check the following:

  • Time Delay has not elapsed yet: Delays are strict. Delays also respect quiet hours, which may postpone sends until compliant windows.

  • Split conditions are still pending: This occurs if AI needs more information or an audience assignment is still processing.

  • Integration node is waiting for an external event: If the Flow expects an event such as “order_created,” the persona remains paused until that event occurs AND is sent to AIQ from the respective partner.

  • Discount or points node validation failed: If a discount is expired or misconfigured, delivery can’t proceed.

  • They qualify for certain nodes earlier in the flow, but not ones later in the flow: For example, they might complete the Email node (because they are opted-in to that channel), but get stuck at the Text node later in the flow (because they are not opted in) and then cannot move past that node. Use conditional splits with opt-in traits to fix this issue.


Discount or Points Are Not Applying

  • Discount may be expired: If the discount expires after launch, personas can get stuck.


FAQs

Once I launch a Flow, can I make edits?

Partially. You can only edit Time Delay nodes in a live Flow. You cannot edit triggers, campaigns, discounts, gift points, splits, or any other node type once the Flow is active.

If you need to change anything other than a Time Delay, duplicate the Flow, make updates, and launch the new version.


Do Flows save automatically?

No. Flows follow the same pattern as our Campaign Builder, where you can manually Save as Draft and if you try to close the builder with unsaved changes, a confirmation modal will appear.


Do messages in Flows show in the main Campaigns list?

No. Messages created inside Flows are not standard campaigns. They only contain content (no campaign-level settings) and inherit rules from the Flow itself.


Do discounts created or used in Flows appear in the main Discount list?

Yes. All discounts created or attached in Flows are available in the normal Discounts list.


Do messages in Flows have their own attribution window settings?

No. Attribution is set at the Flow-level, not per message (aka campaign).


Can I have multiple Splits in a single Flow?

Yes. You can add as many Split or AI Split nodes as needed.


Can I have multiple triggers in a single Flow?

Yes. Multiple triggers are supported.


Can I use campaign-level settings like Intelligent Timing (aka Personalized send time) inside Flows?

No. Campaigns inside Flows do not use campaign-level features. All sends follow the Flow’s logic and global compliance rules.


Can I AB test Flows?

Not in this version. A/B testing will be considered for a future release.


Is there a node limit in flows?

No. You can have as many nodes as you want.


Is there a time delay limit in flows?

Yes. The time delay cannot exceed 365 days, or 1 year.


How are Flow audiences different from traditional AIQ Audiences?

Traditional AIQ Audiences are evaluated during an overnight processing cycle, meaning customers may not become eligible until the next day.

Flows evaluate triggers and traits more frequently, allowing customers to enter a Flow much sooner after an action occurs. See info above.


Can I use an existing audience in a flow?

Yes, use the Is in audience(s) to select from your existing list.


My AI condition / prompt is not working as expected, how can I fix it?


Can a customer / persona enter the same flow more than once? (can they go through multiple times)

Yes, but with limitations. You can enable re-entry with optional cooldown periods for flows which start with certain triggers. For more information, check out Flow Re-entry . This allows retailers to enable "ongoing" or recurring flows.


What if I need to check something in the future or send follow-up actions?

Use delays and conditions within the same flow.

If you need to wait for a future event or evaluate a condition at a later time, add a delay step followed by the appropriate condition. Customers will continue moving forward through the flow as those steps are reached.


Do I need to add “Email opt-in = true” as a trigger for email flows?

No. If your flow contains email steps, messages will only be sent to customers who are opted in to email. Customers who are not opted in will simply not receive the message.

However, if the flow continues to other steps after an email node, customers who cannot receive that email may stop progressing through the flow unless you add splits or alternate paths.


What happens if a customer isn’t opted into a channel used in the flow?

If a customer reaches a step for a channel they are not opted into, they cannot proceed past that step unless you add a conditional split or alternate path.

Example:

  • Flow step order: Wallet message → SMS

  • Customer not opted into wallet

  • Customer never reaches SMS because the flow is linear.

To avoid this, add a split or alternate path around channel-specific steps.


Can I send an SMS containing a Contact Card in a flow?

No. Contact Cards are not supported in this version of Flows. We are considering it for a future version.


I created a flow, but I do not see my persona list entering the initial trigger?

If you have a start date set on your flow, this will prevent AIQ from analyzing your trigger until that date/time occurs. Check back after the flow flips to live.


Can I edit my Max Credits after launching my flow?

Yes, after you launch your flow, you can edit both your daily and lifetime max credits.


Need Help?

If you need assistance, reach out to AIQ Support anytime via the chat widget in your AIQ Dashboard.

Did this answer your question?