Skip to content

E-Commerce Event trigger (Shopify) ​

Once a Shopify store is connected, you can use the E-Commerce Event trigger in Automation to send messages when a customer abandons checkout, completes a purchase, has an order fulfilled, and so on.

Connect your online store before you start.

Add the trigger ​

  1. Go to Automation and create or open an automation.

  2. Add a trigger in the trigger block and choose E-Commerce Event under the Shopify category.

    Choose the E-Commerce Event trigger

  3. Choose the Event Type and the Shopify Store, then set the delay, filters and quiet hours as needed.

    E-Commerce Event trigger settings

  4. Add message and other blocks after the trigger, then publish the automation.

Use WhatsApp template messages

Most e-commerce events happen outside the 24-hour customer service window, where WhatsApp rejects regular text or media messages. In automations on a WhatsApp channel, use the WhatsApp Template block.

Event types ​

Event typeWhen it firesDelay setting
Cart AbandonedThe customer reached checkout and has not paid within the Abandonment TimeYes (Abandonment Time)
Purchase CompletedThe customer completes a purchaseYes
New CustomerA customer is first created by a checkout or an order. Customers that were synced when the store was connected do not trigger itYes
Order FulfilledOn each fulfillment, including partial ones. Online-store checkout orders onlyNo
Order CancelledWhen the order is cancelled. Online-store checkout orders onlyNo
Order RefundedWhen a refund is created. Zero-amount refunds do not trigger itNo

Order Fulfilled, Order Cancelled and Order Refunded have no delay setting. To wait before sending, add a Wait step in the flow.

Settings ​

SettingWhat it does
Event TypeSee the table above
Shopify StoreOne specific store, or "All connected stores"
Abandonment TimeCart Abandoned only. If the customer has not paid within this time after reaching checkout, the cart counts as abandoned. Default 1 hour, maximum 7 days (191 hours when set in hours)
DelayPurchase Completed and New Customer. How long to wait after the event before the trigger fires. No delay by default
Minimum Cart Value / Minimum Order Value (optional)Cart Abandoned and Purchase Completed only. The trigger does not fire below this amount
Quiet Hours (optional)The trigger does not fire during this period. A new trigger defaults to 22:00–08:00, in the workspace's time zone

Why Abandonment Time has a maximum

A cart expires after a long period without activity, and no recovery message is sent for an expired cart. If a saved value is above the limit, it is adjusted automatically and the screen tells you so.

How quiet hours behave ​

  • Cart Abandoned: nothing is sent during quiet hours. Carts that are still valid are processed once quiet hours end.
  • Other events: if the trigger would fire during quiet hours, it does not fire for that event, and it is not sent later.

If you need a notification to go out at any time of day, such as a shipping notice, clear the quiet hours.

Things to know about Cart Abandoned ​

  • Only one abandoned-cart automation fires per cart. When several abandoned-cart automations target the same store, the one with the shortest Abandonment Time sends first and the others never receive that cart. Disable the others while testing.
  • Recovery cooldown. When the store has a recovery cooldown, the same customer receives only one recovery message within that period.
  • Recover only buyers who consented to marketing. When this is on for the store, recovery messages go only to buyers who agreed to receive SMS marketing in Shopify.

The last two are set on the store's settings page. See Connect your online store. If an automation is published but nothing is sent, check these two settings first.

Flow variables ​

The trigger provides the variables below for use in later blocks such as Message and Condition. Which ones are available depends on the event type.

All events ​

VariableDescriptionExample
customer.nameCustomer's full name (first + last)Chan Tai Man
customer.firstNameCustomer's first nameTai Man
customer.emailCustomer's email[email protected]
customer.phoneCustomer's phone number, without +85291234567
customer.shopifyCustomerIdShopify customer ID. Empty for guest checkout9731049226324
store.nameThe store's display name in ChatBoosterMy Store
store.urlStore URL. The primary domain is used when a custom one is sethttps://example.com

Cart Abandoned ​

VariableDescriptionExample
cart.itemCountNumber of distinct items in the cart2
cart.totalCart total (two decimal places)380.00
cart.currencyCart currencyHKD
cart.firstItem.nameName of the first itemHydrating Serum 30ml
cart.firstItem.imageUrlImage URL of the first item
cart.lastEventAtTime of the last add-to-cart or checkout activity2026-10-30T14:20:00+08:00
cart.checkoutUrlRecovery checkout link. It restores the original checkout when possible, otherwise rebuilds the cart and goes straight to checkout

Purchase Completed ​

VariableDescriptionExample
order.idShopify order ID6514497355860
order.itemsCountNumber of distinct items in the order1
order.totalOrder total (two decimal places)1093.99
order.currencyOrder currencyHKD
order.firstItem.nameName of the first itemHydrating Serum 30ml
order.firstItem.imageUrlImage URL of the first item
order.createdAtTime the order was placed2026-10-30T13:57:48+08:00

Order Fulfilled ​

VariableDescriptionExample
order.idShopify order ID6514497355860
order.nameOrder number as shown in the store admin#1133
order.itemsCountNumber of distinct items in the order1
order.totalOrder total (two decimal places)1093.99
order.currencyOrder currencyHKD
order.firstItem.nameName of the first itemHydrating Serum 30ml
order.firstItem.imageUrlImage URL of the first item
fulfillment.trackingCompanyCarrierSF Express
fulfillment.trackingNumberTracking numberSF1234567890
fulfillment.trackingUrlTracking link
fulfillment.isPartialWhether this is a partial fulfillment (true / false)false

Order Cancelled ​

Includes every order.* variable in the Order Fulfilled table, plus:

VariableDescriptionExample
order.cancelReasonCancellation reason (a Shopify code such as customer, inventory, fraud)customer
order.cancelledAtTime of cancellation2026-10-30T15:10:00+08:00

Order Refunded ​

VariableDescriptionExample
order.idShopify order ID6514497355860
order.nameOrder number as shown in the store admin#1133
refund.amountAmount of this refund120.00
refund.currencyRefund currencyHKD
refund.createdAtTime of the refund2026-10-31T10:05:00+08:00

Troubleshooting ​

What you seeWhat to do
The automation is published but no recovery message is sentCheck the store's "Recover only buyers who consented to marketing" and "Recovery cooldown" settings, and make sure it is not currently quiet hours
Only one of several abandoned-cart automations sendsThis is expected: a cart only triggers the automation with the shortest Abandonment Time
Messages are rejectedUse the WhatsApp Template block instead
Late-night shipping or refund notices are not sentEvents that fall in quiet hours do not trigger. Clear the quiet hours to send at any time
Existing customers do not trigger New CustomerCustomers synced when the store was connected do not trigger it. Only customers created afterwards do

💡 If you have any questions along the way, contact us at [email protected].