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
Navigate to Marketing > Flows
Click the plus (+) icon to create a new Flow
Choose a Trigger
Configure trigger parameters
Click Add Requirement
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
Navigate to Marketing > Flows
Under Pre-Built Flows select your template
Customize triggers, messaging, and logic
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:
One or more nodes are unconfigured. Configure each node until alerts disappear.
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?
See AI Prompts in Flows.
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.


