Skip to main content

Overview

MoEngage Flows is a series of Cross-channel (across the channels such as Email, Push, SMS, and so on) Lifecycle campaigns that will be sent to your customers based on their actions or in-actions on your app or website.
Ensure that the channel settings are configured.
To create a flow, perform the following steps:
  1. On the sidebar menu in MoEngage, hover over the Engage menu item Screenshot 2025-06-04 at 4.32.53 PM.png . The Engage menu appears.
  2. Click + New Flow. You can also click All Flows on the Engage menu and then click + Create flow on the Flows page. The Create new flow page appears.
  3. On the Create new flow dialog box, click + Start with a blank canvas. The Create flow page appears.
  4. From the resulting pop up, use one of the following options to create a flow:

Option 1: Create a Flow Using a Flow Template

Flow templates provide you with inspiration for crafting your flows based on your goals - onboarding, incentivization, and engagement.You can create single-channel or multiple-channel flows for sending reminders for abandoned carts, reach out to customers who are a churn risk, and improve app/website engagement. The various Flow templates are discussed below :

Template Types

There are two basic template types
  • Adoption: Adoption templates can be used for onboarding new customers and are available for a single channel and multiple channels.
  • Engagement: Engagement templates are available for single, multiple, or specific channels such as the web and app. They can be used for improving app or website engagement, engaging with customers who have looked up certain offerings or added certain products to their carts and abandoned them, and reaching out to customers who are a churn risk.
You can choose one of the following templates when creating a flow: Now that you know the types of templates, you can use them to create flows.
  • You can edit the Flow template to add event checks wherever necessary and edit the campaign content.
  • You can add or delete stages to the template as required.

Use a Template

  1. Select the flow template and click Use template.
  2. Add entry conditions, define the target audience, and conversion goal (if any) for the flows.
  3. Review the campaigns in the template and modify them as required.
  4. Add new stages or paths if necessary, as per the business use case.
  5. After the structure of your flow is ready, you can click Save to save it as a draft. To publish the flow, your next action depends on your account’s settings:
      • If the Campaign Approval workflow is disabled, you can publish the flow directly.
      • If the Campaign Approval workflow is enabled, you have the permission to create, manage, and publish campaigns, you can publish the flow directly .
      • If the Campaign Approval workflow is enabled and you only have the Create & Manage permission, you must submit the flow for approval. For more information, refer here.
Flow templates.gif

Option 2: Create a Flow from Scratch

You can start with a blank canvas and build a flow of your choice. The following are the steps to create a flow from scratch:
  1. Details and goals: Define the goal of the flow and add the required details.
  2. When will users enter the flow: Define when the users will enter the flow.
  3. Who will enter the flow: Define the audience of the flow.
You can directly enter the canvas from any step during flow creation. Click Skip to Canvas to open the MoEngage canvas.

Details and Goals

After you click + Start with a blank canvas, the Create flow page is displayed. This section contains the following:

Flow Details

The flow details section contains the following fields:

Conversion Goals

Define the conversion to track conversion for the flow. The conversion goal configured for the flow is treated as the conversion goal of all the campaigns part of the flow.
  • You can add five conversion goals for a single flow. For more information, refer to Add multiple goals to flows.
  • You can publish the flow without any goals.
Define the goals by selecting the following: Click + New goalto add more goals.
You can change the goal, tags, and exiting users on conversion setting at any point in time before publishing the Flow by clicking Settings. For more information, refer to Flow Settings.Screenshot_2022-07-31_at_1.40.29_AM.png
Click Next to navigate to the When will users enter the flow step.

When Will Users Enter the Flow

Select one of the following to define when the will user enter the flow. On Event TriggerAt fixed time On flow exit On business event trigger To define the trigger condition, do the following:
  • In the If user section,
    1. Under Primary trigger event (s), in the Has Executed field, Select an event from the list to define the primary trigger event for the user to enter the flow.
    2. Click + Add alternate trigger event to add multiple events under Primary trigger event(s). This will allow users to enter the flow if they perform any of the events defined in the Primary trigger event. (This is optional)
    3. Click + Attributes to add attributes to any of the added primary triggers. (This is optional) bau 1.png
To define a secondary trigger condition, do the following:
  • In the AND section,
    1. Click + Add secondary trigger event.
    2. Under Secondary trigger event(s), select Has Executed or Has Not Executed based on your requirements select the event from Select an event list to define these secondary trigger events along with the primary trigger event for the user to enter the flow.
    3. Click + Add more trigger event to add multiple events under Secondary trigger event(s). (This is optional)
    4. Click + Attributes to add attributes to any of the added secondary triggers. (This is optional).
      You can add personalized dynamic checks for users based on their previous actions. For more information, refer to Linked Conditions. bau123.png
  • In THEN enter the user section,
      1. Select Immediately to allow users to enter the user immediately.
        This is applicable only when Primary triggers are defined for the flow.
      2. Select With Delay to allow the user to enter the flow at a delayed time interval by providing the following details:
        1. Type the time value and select minutes, hours, or days. The entered value can range between 2 minutes and 30 days (both inclusive).
        2. Select Before or Afterto specify whether the user should enter the Flow before or after the specified time interval.
          When you add multiple primary trigger events, only the After option is allowed to specify the time interval. However, when only one primary trigger event is added, both the Before and After options are allowed to personalize your delay.
        3. Select the attribute relative to which this time calculation has to be done. To learn more about this, click here. bau1234.png
Flow Schedule Settings Under Start, select one of the following options to trigger the flow: To schedule the flow at a fixed time, do the following: Under User entry, select one of the following options to trigger the flow: Select the following details to allow the user to enter the current flow on exiting an existing flow: To define a primary trigger condition, do the following:
  • In the If user performs section,
    1. Under Primary trigger(s), in the Has Exited list, select a flow in the Select by name list from which the user exits the flow.
    2. Click the + Add alternate flow exit to add multiple flow exits under Primary trigger (s). (This is optional)
    3. Click the + Add exit stage filter to add attributes to any of the added primary trigger events. (This is optional) 11234.png
To define a secondary trigger condition, do the following:
  • In the AND section,
    1. Click + Add secondary trigger event.
    2. Under Secondary trigger event(s), select Has Executed or Has Not Executed based on your requirements and select the flow in the Select an event list to define the secondary trigger events along with the primary trigger event for the user to enter the flow.
    3. Click the + Add more trigger event to add multiple flow exits under Secondary trigger event(s). (This is optional)
    4. Click the + Attributes to add attributes to any of the added secondary trigger events. (This is optional) 22.png
  • In the THEN user enter the flow section,
  1. Select Immediately to allow the user to enter the flow within the next 30 to 60 seconds.
    You can allow the user to enter the flow only if the condition is’ If’.
  2. Select With Delay and provide the following details to define the delay after flow exit:
    1. Type the value of the time.
    2. Select minutes, hours, or days.
Flow Schedule Settings Under Start, select one of the following options to trigger the flow: To make users enter the flow on a business event trigger, perform the following steps:
  1. In the Select Business Event list, click a business event (for example, Series Launched).
  2. Select one of the following options to define the Flow schedule:

Limit User Entry Settings

When you select At fixed time under the Users enter the flow section, the Limit user entry into this flowtoggle is visible only when you select a Periodic option.
To limit the number of times a user enters the flow, turn the Limit user entry into this flow toggle on and enter a value in the following fields:
  1. Define the maximum entry limit. For example, 2 times.
  2. Configure the frequency. For example, 1 month. The range can be from a minimum of 1 day to a maximum of 1 year (both inclusive).
Flow user entry 1.png

Global Exit Criteria

Under Flow Exit, turn the Exit based on conditions toggle on to define flow exit conditions. When the users fulfill the conditions defined, MoEngage removes them from their last known position in the flow regardless of where they are. The exit criteria are applicable for all flow types (for example, On event trigger, At fixed time, On flow exit, and On business event trigger). Screenshot 2024-07-29 at 3.35.49 PM.png MoEngage evaluates users on these conditions right from the time they enter the flow to the time they exit the flow due to reasons such as:
  • Passing through an exit stage in the flow path
  • Fulfilling the conditions in the exit criteria
  • Achieving the conversion goal defined in the flow
You can define the exit criteria using events triggered by users or user properties that you track for them: Screenshot 2024-07-29 at 3.35.49 PM.png
  • User property: On the User property tab, you can define the exit criteria using user properties by specifying a value for a specific attribute. For example:
    • Remove users when their membership is Gold (this can be used when the flow has a fixed agenda to convert users to Gold Membership).
  • User behavior: On the User behavior tab, you can define the exit criteria using the list of events tracked in MoEngage.For example:
    • Remove users when they have purchased any product after entering the flow
    • Remove users when they have purchased the same product that they added to their cart after entering the flow
      • You can achieve this and similar use cases by linking the primary trigger event and the Exit Condition. For more information, see Linked Conditions
    • Remove users when they have purchased the same product that is now back in stock.

Supported Filters

You can define exit criteria only using conditions that are of string, integer, and Boolean data types.
MoEngage does not support the conditions defined with following filters:
  • Custom segments
  • Affinity segments
  • Array type and GeoPoint
  • Special Date Filters (Daily where the hour, Weekly where the day, Monthly where the day, Yearly where the month, Yearly where the date)
  • last n weeks, hours, months
  • last n days where n> or equal to 30 days
  • Merlin AI-based attributes
If you use a filter that is not supported, an error message will be displayed. You will have to select a filter that is supported to fix the issue.Screenshot 2024-07-29 at 3.43.22 PM.png
Click + Add exit condition to include additional conditions, with a limit of five conditions. Each condition will be evaluated using OR logic with the others. If the users fulfills any of these conditions (in any order), they will exit the flow. For example, if the users fulfill the Condition 3 first, they will exit the flow even though they have not fulfilled the Condition 1. Screenshot 2024-07-29 at 3.41.39 PM.png Within each condition, you can add sub-conditions. Click + Filter to add more conditions. You can add a maximum of five sub-conditions. Each sub-condition will be evaluated using AND logic with the others. Only If the users fulfills all conditions, they will exit the flow. Screenshot 2024-07-29 at 3.43.16 PM.png
If there are multiple sub-conditions used in a condition, users must fulfill all sub-conditions within a 30-day period in any order to satisfy the exit condition. For example, in Condition 1, you have defined the following sub-conditions.
  • Has Executed App/Site Opened at least 1 time
  • Last Seen Date is on July 25, 2024
  • Last Known City is New York
7.pngIf the users fulfill the fist two conditions on August 1, 2024, they do not exit flow immediately. MoEngage waits for 30 days from August 1 for the last condition to be fulfilled. If it happens before August 31, the users will exit the flow. If it happens on September 2, the users will not exit the flow because the first two conditions are outside the 30-day window.
You can edit an exit criteria even after you publish the flow. However, MoEngage creates a new version of the flow in this case. This is not applicable for one-time flows. Click Next to navigate to Who will enter the flow step.
OR
Click Previous to navigate to the Details and Goalsstep.

Who Will Enter the Flow

Select the Target Audience or the target segment for the flow. You can use multiple filters to create the target audience.
If your organization uses Teams 2.0, it automatically adds the team’s original targeting criteria to any new rules you create. For more information, refer here.
The following options are available: All Users Filter by User Property Filter by User Behavior Filter by User Affinity Filter by Custom Segment This filter option allows you to select all the app users. When you use this option, you cannot add multiple filters. 1.png This filter option allows you to select the users based on user properties such as first seen, last seen, city, etc. Click the User property tab and do the following:
  1. Select the desired attribute in the Select attribute list. This enables filters based on the attributes selected.
  2. Select any filters with the conditions in the dropdown list. For example, string attributes can have filter conditions such as ‘is’ and ‘is not,’ while integer attributes can have different filters.
  3. The default Constant value helps you complete the filter with specific static values. The User attribute (applicable for all types of flows) or Business event attribute (only for Business Event Triggered flows) option, as shown below, allows you to define the conditions using a different user attribute or business event attribute.
    For example, refer to the following screenshot to create a flow that announces the launch of a new Thriller series and targets users who have preferred the Thriller as the Genre. Screenshot 2024-12-19 at 3.53.15 PM.png
For more information, refer to Create Segments. This filter option allows you to select the users based on the behavior of the users or events, such as ‘App/Site Opened,’ ‘Viewed Product,’ and so on. Click the User Behavior tab and do the following:
  1. Select the User Behaviour from the dropdown list.
  2. Select an event in the Select an event list.
  3. Enter the event frequency and time duration for the event execution.
  4. Click + Attributes and select the desired attribute in the Select attribute list. This enables filters based on the attributes selected. For example, string attributes can have filter conditions such as ‘is’ and ‘is not,’ while integer attributes can have different filters.
  5. The default Constant value helps you complete the filter with specific static values. The User attribute (applicable for all types of flows) or Business event attribute (only for Business Event Triggered flows) option, as shown below, allows you to define the conditions using a different user attribute or business event attribute.For example, refer to the following screenshot to create a flow that announces the launch of a new Thriller series and targets users who have watched Thriller in the Genre at least once in the past 3 days: Screenshot 2024-12-19 at 5.09.21 PM (1).png For more information, refer to Create Segments
  6. Select the desired user event or attribute.
  7. Select the user affinity parameter from the following:
    • Predominantly: Select affinity attribute with a filter condition and provide the affinity values.
    • For a minimum of: Select affinity attribute with a filter condition and provide the affinity values.
    • Most no. of times: Enter a value or use the arrows to provide the top percentage of users.
    • Least no. of times: Enter a value or use the arrows to provide the bottom percentage of users.
  8. Enter or use the arrows to provide the time duration for the event execution.
  9. Click + Attributes to add more attributes to the filter.
For more information, refer to Create Segments 4.png This filter option allows you to select a custom segment as the target audience. Select a custom segment as the target audience from the list of custom segments available. For more information, refer to Custom Segments. 5.png After selecting the filter criteria, you can do the following as well: 5.png
  • Create Multiple Filters You can create and combine multiple user property rules, user activity rules, and custom segment rules to create a complex user segment using this option.
    1. Click + Filter.
    2. Click AND or OR.
    3. Select the attribute or event and define the filter conditions.
  • Exclude Users: Select this checkbox to define the filter criteria for users to be excluded from the flow. For more information on excluding users, refer to Preference Management.
  • Reset filters: Click this option to reset the segmentation filters.
  • Show count: Click this button to display the total number of users who are currently in the configured segment.

Control Group

You can enable the control groups to which you want to send the campaign. For more information about control groups, refer to Control Group. Click Next to open the flow in the Canvas.
OR
Click Previous to go to the When will users enter the flow step.

Design and Publish Your Flow

  1. To design the structure of your flow, click + to add the following to the flows:
  2. After the structure of your flow is ready, click Save to save it as a draft. To publish the flow your next action depends on your account’s settings:
      • If the Campaign Approval workflow is disabled, you can publish the flow directly.
      • If the Campaign Approval workflow is enabled and you have the permission to create, manage, and publish campaigns, you can publish the flow directly.
      • If the Campaign Approval workflow is enabled and you only have the Create & Manage permission, you must submit the flow for approval. For more information, refer here.

The Approval Flow

Creator Reviewer As a creator, to send the flow for approval, perform the following steps:
  1. On the flow canvas page, select the Actions button on the right side.
  2. In the Actions list, select Send for Approval. The Send for approval pop-up window appears.
    The MoEngage identifies any configuration errors in your flow which are displayed in the Error panel on the right side of the canvas.You must resolve all listed errors before you can send the flow for approval.
  3. You must select the users who would review and approve your flow.
    1. In the Start typing to filter approvers box, search for the users (Admins or Managers) from the team you selected in the Details and Goals step.
    2. Click + Add next to the name of each user you want to review the flow. The selected users appear in the Selected Approvers section on the right.
  4. In the Add yours comment here (optional) box, you can add comments to provide context, instructions, or notes for your approvers.
  5. Click Send for approval.
  6. The selected approvers receive an email notification informing them that the flow is awaiting their review. While the flow is in the Under Review state, you have the following options.
    1. Edit the flow: You can edit a flow that is Under Review. After making the edits, you must resend the flow for another review by clicking Update and send for approval. Then, repeat steps 3 through 5.
    2. Follow up with approvers: To follow-up, click Remind Reviewers.The approvers receive a reminder notification.
To review the flow, perform the following steps:
  1. Open the email you received from MoEngage and click Click to Review Flow. OR.
    Navigate to the All Flows page. In the Select status filter select the Under Review checkbox.This provides the list of flows awaiting your approval.
  2. Click the flow you want to open.
You must review the flow by verifying the configurations of every stage. After the review is complete, and if there are no corrections required for the flow, perform the following steps:
    1. On the flow canvas page, click Approve and Publish on the right side. The Approve & publish flow pop-up window appears.
    2. In the Add yours comment here (optional) box, add the comments for the creator.
    3. Click Approve & publish. After you publish, the flow becomes Active or Scheduled based on the flow (for example, On event trigger or At fixed time). The creator and the other approvers receive an email notification informing them that the flow is published.
If the flow requires corrections, you must perform the following steps:
  1. On the flow canvas page,select the Actions button on the right side.
  2. In the Actions list, select Reject. The Reject the flow pop-up window appears.
  3. In the Add your comments here box, you must add comments that explain why the creator needs to make edits.
  4. Click Reject flow. After you reject the flow, the creator and other approvers receive an email notification with your comments.
  • When a flow is rejected, creators can find the approver’s comments in their email notification and the Flow Audit logs.
  • After making the requested changes, MoEngage can resubmit the flow by following the approval process. For more information, refer here.
All MoEngage AI products, which were previously referred to as Sherpa AI, are now known as Merlin AI.