Automation triggers and actions reference
This is the reference for the automation builder. It lists every trigger that can start a flow, the filters and conditions that decide who enters and which path they take, and every block you can add, with the options each one offers. For step-by-step instructions, see the Automation builder article.
Les guides sont en anglais.
How a flow is built
| Part | What it does |
|---|---|
| Trigger | The event that puts a contact into the automation. One per automation, always the first card. |
| Trigger Filters | Conditions on the triggering event, such as the products or the total in the order. |
| User Filters | Conditions on the contact, such as segment membership or subscription status. |
| Cancel Trigger | An event that removes a contact from the flow and cancels their pending steps. |
| Message blocks | Email, SMS, Web Push, Mobile Push and Whatsapp. Each sends one message. |
| Flow actions | Time Delay, Split, Webhook, Internal Notification and A/B Testing. They control timing, branching and hand-offs. |
| EXIT | The end of a path. A contact who reaches it has finished the automation. |
Triggers
The trigger list is searchable and grouped by type. The exact list depends on your store platform and the apps you have connected. Any trigger in the list can also be used as a cancel trigger.
Order
| Trigger | Starts when |
|---|---|
| Checkout Started | A customer starts checkout. Use it for abandoned checkout recovery, with Placed Order as the cancel trigger. |
| Placed Order | An order is created. Use it for order confirmations, post-purchase follow-ups and cross-sell. |
| Cancelled Order | A customer cancels an order. |
| Fulfillment Created | A fulfillment is created for an order. |
| Fulfillment Complete | A fulfillment for an order is complete. |
| Fulfilled Order | An order is fulfilled. |
| Order In Transit | An order is in transit. |
| Delivered Order | An order is delivered. Use it for review requests and replenishment reminders. |
Product
| Trigger | Starts when |
|---|---|
| Added To Cart | A product is added to the cart. Use it for abandoned cart recovery. |
| Viewed Product | A contact views a product page. Use it for browse abandonment. |
| Ordered Product | A product is ordered. Unlike Placed Order, which covers the whole order, this fires once for each product in it. |
| Price Drop | The price of a product is reduced. |
| Back In Stock | A product is back in stock. |
| Subscribed To Back In Stock | A customer asks to be told when a product is back in stock. |
Site
| Trigger | Starts when |
|---|---|
| Viewed Page | A contact visits a page. It fires for non-product pages only: use Viewed Product for product pages. |
Customer
| Trigger | Starts when |
|---|---|
| Subscriber Created | A new subscriber is created. Use it for a welcome flow. |
| Subscribed To Email | A contact subscribes to email. |
| Subscribed To Sms | A contact subscribes to SMS. |
| Subscribed To Push | A contact subscribes to web push. |
| Subscribed To Whatsapp | A contact subscribes to WhatsApp. |
| Subscribed To Mobile Push | A contact subscribes to mobile push. |
| Added To List | A contact is added to a list. Filter by List to pick which one. |
| Added to Segment | A contact joins a segment. Filter by Segment to pick which one. Use it for win-back flows built on a lapsed-customer segment. |
| Special occasion(Birthday) | The contact's birthday. Use Greeting Time to send on the day, or a number of days before or after. |
Mobile app, connected apps and custom events
- Mobile app events. With the Contlo mobile SDK installed, app events become triggers, including Mobile App Installed, Mobile App Launched, Mobile User Registered, Mobile User Logged In, Mobile Viewed Product, Mobile Viewed Collection, Searched Product Mobile, Mobile Added To Cart, Mobile Viewed Cart, Mobile Product Added To Wishlist, Mobile Checkout Started, Mobile Payment Started, Mobile Payment Failed and Mobile App Uninstalled. See Mobile SDKs.
- Connected apps. Apps you connect from the App Market can add their own triggers, for example review submitted, shipment out for delivery, or events from checkout, loyalty and helpdesk apps. They appear in the same list once the app is connected. See Integrations catalog.
- Custom events. Events you send to Contlo yourself appear under Custom, and their properties are available as trigger filters. See Track events and identify.
Trigger filters
Trigger filters test details of the event that started the run. The filters offered depend on the trigger. Triggers with no event details, such as the subscription triggers, show Trigger Filters Not Applicable.
| Trigger | Filters you can add |
|---|---|
| Checkout Started, Cancelled Order | Products, Collections, Item Count, Discount Code, Shipping Price, Product SKU, Total Price, Attributed Automation, Attributed Campaign |
| Placed Order, Delivered Order | Everything above, plus Is COD, Order Tag, Product Tag and Source Name |
| Fulfilled Order | The order filters, plus Fulfillment Status (Fulfilled or Partially Fulfilled) |
| Order In Transit | The order filters, plus Tracking Company and Tracking Url |
| Fulfillment Created, Fulfillment Complete | The order filters, plus Tracking Company, Tracking Url and Product Tag |
| Added To Cart, Viewed Product | Products, Collections, Vendor, Product Price, Utm Source, Utm Medium, Utm Campaign, Attributed Automation, Attributed Campaign |
| Ordered Product | The same as Added To Cart, plus Item Quantity |
| Viewed Page | Page Url |
| Price Drop | Products, Collections, Vendor, Product Price, Price Drop Percentage, and Target Audience (Viewed Product, Started Checkout Of Product, or Started Checkout or Viewed Products) |
| Back In Stock, Subscribed To Back In Stock | Products, Collections, Vendor, Product Price |
| Added To List | List |
| Added to Segment | Segment |
| Special occasion(Birthday) | Greeting Time: On Same Day, Before or After, with a number of days. Only one condition is allowed. |
| Custom events | Each property sent with the event |
User filters
User filters test the contact, whatever the trigger. They are available on the trigger and on every split.
| Filter | What it matches |
|---|---|
| Segment | Contacts who are, or are not, in the segments you select. |
| Subscribers Created Date | When the contact was created: on, before or after a date, or within the last number of days. |
| First Name, Last Name | The contact's name. |
| Gender | Male or Female. |
| State, Country | The contact's location, picked from the values in your audience. |
| Is Email Subscriber | Whether the contact is subscribed to email. |
| Is SMS Subscriber | Whether the contact is subscribed to SMS. |
| Is Push Subscriber | Whether the contact is subscribed to push. |
| Is Whatsapp Subscriber | Whether the contact is subscribed to WhatsApp. |
| Num of Orders | How many orders the contact has placed. |
Conditions and how they combine
| Value type | Comparisons |
|---|---|
| Number | greater than, less than, equals, not equal to, is at least, is at most |
| Text | contains, doesn't contain, starts with, doesn't start with, is set |
| Pick list (products, collections, segments, lists, countries) | includes, does not include |
| Date | equals, not equal to, before, after, within last, not within last (a number of days) |
| Yes or no | equals, not equal to, compared with TRUE |
| Greeting time | On Same Day, Before, After (a number of days) |
- Conditions inside one box are joined with OR: the box matches if any condition is true.
- Boxes are joined with AND: every box must match.
- On the trigger, a contact enters only if both the trigger filters and the user filters match.
- Pick lists search as you type, from 3 characters. Product and collection filters accept several values.
Trigger settings
| Setting | What it does | Options |
|---|---|---|
| Trigger | The event that starts the flow. | Any trigger above. Locked after the automation is first published. |
| Cancel Trigger | Ends the run for a contact when the chosen event happens. Pending steps are cancelled. | One or more events, added with Add Cancel Trigger. On some accounts each can have its own filters. |
| Exit when an order is placed | A one-click shortcut that adds Placed Order as a cancel trigger. | Offered for cart, checkout, browse, price drop, back in stock, list and segment triggers when enabled for your account. |
| Frequency | Skips a contact who already entered this automation within the window. | In Last a number of Hours, Days or Weeks. |
| Back-Populate Recipients | Adds contacts who performed the trigger in the past, after you publish. | Last 30 Days, Last 60 Days, Last 180 days or Custom Range. Shown only when enabled for your account. |
A contact who entered an automation in the last 4 hours is not entered again, unless the trigger is an order, fulfillment or custom event. See Exit conditions and re-entry rules.
Message blocks
A message block appears in the builder only when its channel is set up for your account. Every message block can use Smart Sending where it is enabled.
| Option | Details |
|---|---|
| Subject | Required. Supports emoji and the First Name, Last Name and Shop Name tags. |
| Email Preheader | Optional. The text shown next to the subject line in the inbox. Required once the box is ticked. |
| Sender Name | Required. |
| Sender Email | Required. Chosen from your verified sender emails. |
| Use this email as your reply-to mail | Ticked: replies go to the sender email. Unticked: enter a valid reply-to address. |
| Add Content | Required. Drag and Drop (choose a template, then design it), Text Only (plain text with Insert Tag) or Custom HTML. Later, Edit Email reopens it and Change Content Type starts over. |
The drag and drop editor has Preview, and a more menu with Test Email and Copy to Templates, which saves the design to your email templates for reuse.
SMS
| Option | Details |
|---|---|
| Sender | The number or ID your SMS is sent from. Set in SMS settings. |
| Message Text | For accounts that can send free text. Supports emoji and tags such as First Name, Last Name, Email, Phone Number, Address, Shop Name, Shop Url, Tracking Number, Tracking URL and Tracking Company. Connected stores also get Abandoned Checkout Url, Abandoned Cart Url, Abandoned Product Url, Order Status Url, Product Name, Order Id and Cart Value. |
| SMS Template | For accounts that must use approved templates. Browse Templates, search by name or message, then Load Template and fill every variable. Change Template swaps it. |
| Add "Reply STOP to unsubscribe." | Free text only. Appends the opt-out line to the message. |
| Add Discount | Free text on Shopify. Inserts a discount code. Choose Percentage, Fixed or Free Shipping and the Discount Value, or Choose Coupon Rule if coupons are enabled for your account. See Coupons. |
| Upload Image | Shown when your sender supports picture messages. |
| Test SMS Message | Sends the draft to a phone number you enter. |
| Option | Details |
|---|---|
| Whatsapp Number | Shown when your account has more than one WhatsApp number. Picks the number to send from. |
| Whatsapp Template | Required. Browse Templates, search, then Load Template. Only approved templates can be published. |
| Variables | Fill each one with Tags (the contact's own data), Custom (fixed text) or URL (a link, shortened on send). |
| Button URL | For templates with a link button, choose where it goes: Abandoned Cart Url, Abandoned Checkout Url, Abandoned Product Url, Shop Url, Tracking Url or Custom Url. Cash on delivery confirmation links are offered where they apply. |
| Copy code button | For templates with a copy code button, add a discount code or a static code. |
| Discount | Shown when a variable uses the Discount Code tag. Choose Percentage, Fixed or Custom (your own code), or Choose Coupon Rule if coupons are enabled. |
| Attachment Details | For templates with a media header: Default (the template's own media), Custom (upload a file) or Dynamic Link (a link taken from the event). |
| Carousel Cards | For carousel templates: set the media, variables and button URL of each card. Images are JPG or PNG up to 5MB, videos are MP4 up to 16MB. |
| Quick Reply Buttons | On some accounts, choose what happens when a customer taps a quick reply button, such as sending a quick reply or another template message. |
| Test WhatsApp Message | Sends the draft to a phone number you enter. |
Web Push and Mobile Push
| Option | Details |
|---|---|
| Title | Required. Supports emoji. |
| Subtitle | Mobile push only. |
| Push Message | Required. Supports emoji and the same tags as SMS. |
| Target Url | Required. Where the notification takes the customer. |
| Upload Hero Image | Optional large image. |
| Add Expiry Date | Optional. The notification is not delivered after this date and time. At most 28 days ahead. |
| Add Button | Up to two buttons. Web push buttons have text and a destination URL. Mobile push buttons have a title and a Deeplink. |
| Preview Push | Web push only. Sends the draft to your own browser. |
| Send Test Automation | Mobile push only. Sends the draft to a test contact. |
Flow actions
| Block | What it does | Options |
|---|---|---|
| Time Delay | Pauses the flow before the next step. | Wait For a number of Minutes, Hours, Days or Weeks. Optionally Delay until a specific time of day (time and timezone) and Delay until a specific day(s) of the week (one or more weekdays). |
| Split | Sends contacts down a Yes or No path. Each path has its own steps and its own EXIT. | Trigger Filters and User Filters, with the same conditions as the trigger. At least one filter is required. Trigger filters are not available in a split when the trigger is a birthday. Cannot be placed inside an A/B test path. |
| A/B Testing | Divides contacts at random between Path A and Path B. The paths join again afterwards. | Participant Splitting slider from 0 to 100 percent for Path A, with the rest going to Path B. After publishing, Choose Winner keeps one path and deletes the other. |
| Webhook | Sends data to an external URL when a contact reaches the step. | Request Type (POST), Destination URL, Request Headers (key and value pairs) and Request Body (JSON). |
| Internal Notification | Emails your team when a contact reaches the step. It is not sent to the customer. | Recipients (comma-separated addresses), Sender Name, Sender Email, Subject and Body. Subject and body support the First Name, Last Name and Shop Name tags. |
Smart sending
| Control | Where | Effect |
|---|---|---|
| Smart Sending | Bottom of each message panel | Skips that message for a contact who received any message, on any channel, within your smart sending period. |
| Smart Period | Top bar of the builder | Applies smart sending to the whole automation and hides the per-message switches. |
Smart sending is switched off and cannot be turned on for automations triggered by order, fulfillment, checkout or referral events. Both controls appear only when smart sending is enabled for your account.
What makes a step complete
Launch Automation and Publish Changes are available only when every step is complete.
| Step | Needs |
|---|---|
| Trigger | A trigger selected. |
| Subject, sender name, a verified sender email and content. The panel also warns about a missing preheader or reply-to address. | |
| SMS | Message text, or an approved template with every variable filled and a discount set if the Discount Code tag is used. |
| An approved template with every variable, button and attachment filled. | |
| Web Push, Mobile Push | Title, message and target URL. The panel also warns if a button is missing its text or URL, or if the expiry date is in the past or more than 28 days ahead. |
| Split | At least one trigger filter or user filter. |
| Time Delay, A/B Testing, Webhook, Internal Notification | Always treated as complete, so check their settings yourself before launching. |
Guides associés
- Automation builderBuild a flow on the visual canvas: set the trigger and filters, add delays, splits and messages, then launch, edit and test it.
- Automations overviewWhat automations do, how to create one from a template or from scratch, and how to manage and measure them on the Automations page.
- SegmentsGroup contacts by who they are and what they did, using properties, events, orders and lists, then send to them.
- WhatsApp templatesCreate WhatsApp message templates with headers, variables, media and buttons, submit them for Meta approval, and test, edit or delete them.
- Track events and identify visitorsUse the Contlo browser methods to tell Contlo who a visitor is and what they did, then use those events in segments, automations and analytics.
- CouponsCreate static or unique Shopify discount codes in Contlo and add them to SMS, WhatsApp and automation messages.