---
title: "Understanding Automation Triggers"
description: "All the triggers available to start an automation, what fires them, and the priority order of automatic replies."
url: https://help.getkanal.com/en/articles/82-understanding-automation-triggers
collection: "Automations"
updated: 2026-11-17
language: en
alternates: [fr-fr]
---

# Understanding Automation Triggers

All the triggers available to start an automation, what fires them, and the priority order of automatic replies.

A trigger is the event that starts an automation. You choose it when you create the automation: in **Automations**, click **Create automation**, then start from a library template or click **Start from scratch**.

This article covers each trigger, what fires it and what to check before you build your flow.

> **Info:** Automations do not run on the Free plan. An automation that contains a Scale plan feature (Conditions, AB Testing, API Call, etc.) can only be activated on the Scale plan or higher.

## Overview

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Trigger</p></th><th colspan="1" rowspan="1"><p>What starts the flow</p></th><th colspan="1" rowspan="1"><p>Opens the 24h window</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Inbound message</strong></p></td><td colspan="1" rowspan="1"><p>The customer sends you a WhatsApp message.</p></td><td colspan="1" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>WhatsApp Template</strong></p></td><td colspan="1" rowspan="1"><p>The customer clicks a quick reply button on a template.</p></td><td colspan="1" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Post-purchase</strong></p></td><td colspan="1" rowspan="1"><p>An order is created on Shopify.</p></td><td colspan="1" rowspan="1"><p>No</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Abandoned cart</strong></p></td><td colspan="1" rowspan="1"><p>A customer abandons their cart on Shopify.</p></td><td colspan="1" rowspan="1"><p>No</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Shipment update</strong></p></td><td colspan="1" rowspan="1"><p>A Shopify shipment reaches the selected status.</p></td><td colspan="1" rowspan="1"><p>No</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Incoming webhook</strong></p></td><td colspan="1" rowspan="1"><p>An external tool calls the automation URL.</p></td><td colspan="1" rowspan="1"><p>No</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Store order created</strong></p></td><td colspan="1" rowspan="1"><p>Your custom store sends an order to Kanal.</p></td><td colspan="1" rowspan="1"><p>No</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Store shipment update</strong></p></td><td colspan="1" rowspan="1"><p>Your custom store sends a shipment to Kanal.</p></td><td colspan="1" rowspan="1"><p>No</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Recharge event</strong></p></td><td colspan="1" rowspan="1"><p>A subscription event happens in Recharge.</p></td><td colspan="1" rowspan="1"><p>No</p></td></tr></tbody></table>

When the trigger does not open a conversation window, the first message of the flow must be a template (**Send Template** action). A free-form message (**Send Message**) can only follow a reply or a click from the customer.

## Inbound message

The flow starts when a customer writes to you on WhatsApp. There is a single **Inbound message** trigger, which replaces the former keyword triggers. You choose from 6 match modes:

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Mode</p></th><th colspan="1" rowspan="1"><p>The flow starts if the message...</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Any text</strong></p></td><td colspan="1" rowspan="1"><p>is any message, including media without text.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Exact match</strong></p></td><td colspan="1" rowspan="1"><p>is identical to the keyword.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Contains</strong></p></td><td colspan="1" rowspan="1"><p>contains the keyword anywhere in the text.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Starts with</strong></p></td><td colspan="1" rowspan="1"><p>starts with the keyword.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Ends with</strong></p></td><td colspan="1" rowspan="1"><p>ends with the keyword.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Matches a regex</strong></p></td><td colspan="1" rowspan="1"><p>matches the regular expression you enter (advanced use).</p></td></tr></tbody></table>

-   Case is ignored by default: "PROMO", "Promo" and "promo" are the same. Tick **Case sensitive** to tell upper and lower case apart.
    
-   You can add several conditions to the same trigger: the flow starts as soon as one of them is met.
    
-   To make sure customers send the right keyword, use a [magic link](https://help.getkanal.com/en/articles/40-generate-and-use-magic-links-qr-codes.md): a link and a QR code that pre-fill the message.
    

> **Warning:** Do not create an Inbound message automation on unsubscribe words (STOP, etc.). An automation keyword is checked before opt-out detection and prevents the contact from being unsubscribed. Unsubscribes are managed in [Settings > Opt-out](https://help.getkanal.com/en/articles/76-managing-unsubscribes-opt-out-on-whatsapp.md) (click your team name, then Settings).

## WhatsApp Template

The flow starts when the customer clicks a quick reply button on a specific template. It does not start when the template is sent, nor when the customer types a free-form message.

-   Pick the template in the **Template to send** field: only templates approved by Meta are listed.
    
-   Each template button opens its own branch: the flow continues from the button that was clicked.
    
-   The automation must be active: clicks received while it is turned off are ignored.
    

Use this trigger to handle replies to a template sent from Klaviyo or through the API. See [How to handle replies to a template sent from Klaviyo](https://help.getkanal.com/en/articles/43-how-to-handle-replies-to-a-template-sent-from-klaviyo.md).

## Post-purchase

The flow starts when a Shopify order is created, paid or not (cash on delivery included). It does not wait for payment confirmation. In the editor, this trigger node is labeled "Order created".

It does not open a conversation window: start with a template. To handle cash on delivery orders separately, add the "Cash on delivery (COD) order" condition.

## Abandoned cart

The flow starts when a customer abandons their cart on Shopify. If the customer places an order after the flow has started, the next reminders are not sent: there is no need to add a condition before each reminder.

The "Do not remind after a recent order" setting avoids reminding a customer who has just ordered (see [Automation settings: re-entry and stop rules](https://help.getkanal.com/en/articles/122-automation-settings-re-entry-and-stop-rules.md)). The cart link is available with the `{{variables.shopify_abandoned_checkout_url}}` variable. Start with a template.

## Shipment update

The flow starts when a Shopify shipment reaches the status selected in **Event type**. An automation listens to a single status: create one automation per status.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Status</p></th><th colspan="1" rowspan="1"><p>When</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Fulfillment created</strong></p></td><td colspan="1" rowspan="1"><p>The fulfillment is created in Shopify with its tracking details.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>In transit</strong></p></td><td colspan="1" rowspan="1"><p>The package is on its way.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Out for delivery</strong></p></td><td colspan="1" rowspan="1"><p>The package is on the delivery route.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Delivered</strong></p></td><td colspan="1" rowspan="1"><p>The package has been delivered.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Ready for pickup</strong></p></td><td colspan="1" rowspan="1"><p>The package is waiting for the customer at a pickup point.</p></td></tr></tbody></table>

> **Warning:** Both the tracking number and the tracking URL must be filled in on the Shopify fulfillment, for every status, including "Fulfillment created". Without them, nothing is sent.

-   A given shipment fires each status only once per automation.
    
-   The "delivery attempt", "failed delivery" and "returned" statuses are not available.
    
-   This trigger does not open a conversation window: use a template.
    

The 14 shipment variables (tracking, carrier, shipping address) are listed in [Variables available in automations](https://help.getkanal.com/en/articles/121-variables-available-in-automations.md). See also [Enable Delivery Tracking on WhatsApp](https://help.getkanal.com/en/articles/41-enable-delivery-tracking-on-whatsapp.md).

## Incoming webhook

The flow starts when an external tool (Klaviyo, Zapier, Make, your CRM) calls the automation URL. The **Incoming webhook** node panel shows everything you need to copy: the **Destination URL**, the authentication header, a **JSON body example** and the **Copy as cURL** button, which copies a complete request ready to test.

```text
POST https://api.getkanal.com/api/v1/automations/{webhook_id}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "phone_number": "+33612345678",
  "variables": { "code": "WELCOME10" }
}
```

-   The `Authorization: Bearer` header followed by your key is mandatory. The value is shown in the node panel. See [API authentication and keys](https://help.getkanal.com/en/articles/14-api-authentication-and-keys.md).
    
-   The body must contain `phone_number`. The optional `variables` object passes your data to the flow, usable as `{{variables.name}}`. The `name`, `first_name`, `last_name`, `email` and `shopify_customer_id` fields are also accepted at the root.
    
-   An unknown number creates a new contact.
    
-   The automation must be active, otherwise the call is rejected (error 400 "Automation is not active").
    
-   If the re-entry rule excludes the contact, the call returns 200 with "Contact blocked by re-entry rule" and no message is sent.
    
-   For Klaviyo, turn on **Format JSON for Klaviyo**: the body example then uses Klaviyo syntax. See [Send a WhatsApp template from a Klaviyo flow](https://help.getkanal.com/en/articles/21-send-a-whatsapp-template-from-a-klaviyo-flow.md).
    

This trigger does not open a conversation window: the first message must be a template. Technical details are in [the Messaging API article](https://help.getkanal.com/en/articles/81-send-a-whatsapp-message-inbound-via-the-kanal-api.md).

## Store order created and Store shipment update

These two triggers are for stores outside Shopify, connected to Kanal as a custom store (Settings > Stores) and fed through the [Commerce API](https://help.getkanal.com/en/articles/110-api-commerce-envoyer-vos-donnees-de-boutique-a-kanal.md). They appear once a custom store is set up.

-   **Store order created**: the flow starts when your store sends a new order to Kanal.
    
-   **Store shipment update**: the flow starts when your store sends a shipment, with the same statuses as Shopify.
    
-   An order or shipment without a phone number is saved but does not trigger anything.
    
-   A shipment sends nothing without a tracking number and a tracking URL.
    

## Recharge event

This trigger appears once the Recharge integration is connected, which requires the Scale plan or higher. The flow starts on one of 7 subscription events:

-   Subscription started
    
-   Upcoming renewal
    
-   Payment failed (on the first failure of a charge: retries do not start the flow again)
    
-   Payment permanently failed
    
-   Renewal paid
    
-   Subscription cancelled
    
-   Delivery skipped
    

The contact must already exist in Kanal: a Recharge event does not create a contact. See [Recharge integration](https://help.getkanal.com/en/articles/102-recharge-integration-automate-your-subscriptions-on-whatsapp.md).

## System flows: Opt-out and Business hours

Two flows are created automatically and do not appear in the automation list. They are configured in Settings:

-   **Opt-out**: unsubscribes a contact who sends an unsubscribe keyword. See [Managing unsubscribes](https://help.getkanal.com/en/articles/76-managing-unsubscribes-opt-out-on-whatsapp.md).
    
-   **Business hours**: replies automatically outside your opening hours. See [Set up business hours](https://help.getkanal.com/en/articles/86-set-up-quiet-hours-business-hours.md).
    

## Priority order of automatic replies

When a customer writes to you, Kanal starts only one automatic reply. It checks in this order:

1.  Inbound message automations with a keyword (Exact match, Contains, Starts with, Ends with, Matches a regex).
    
2.  Unsubscribe keywords (Settings > Opt-out).
    
3.  Inbound message automations in "Any text" mode.
    
4.  The AI Agent, if it is turned on.
    
5.  The Business hours flow.
    

As soon as one step replies, the next ones do not run.

> **Warning:** An active "Any text" automation replies to every message that matches no keyword. The AI Agent and the Business hours flow then no longer fire. Unsubscribe keywords still take priority.

## Learn more

-   [Actions available in an automation](https://help.getkanal.com/en/articles/119-actions-available-in-an-automation.md)
    
-   [Conditions available in an automation](https://help.getkanal.com/en/articles/120-conditions-available-in-an-automation.md)
    
-   [Variables available in automations](https://help.getkanal.com/en/articles/121-variables-available-in-automations.md)
    
-   [Automation settings: re-entry and stop rules](https://help.getkanal.com/en/articles/122-automation-settings-re-entry-and-stop-rules.md)
    
-   [Test an automation before activating it](https://help.getkanal.com/en/articles/123-test-an-automation-before-activating-it.md)
    
-   [Version history and duplicating an automation](https://help.getkanal.com/en/articles/124-version-history-and-duplicating-an-automation.md)
    
-   [Analyze an automation's performance](https://help.getkanal.com/en/articles/125-analyze-an-automation-s-performance.md)
