> ## Documentation Index
> Fetch the complete documentation index at: https://wabis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Triggers

> Choose the event that starts your workflow — and avoid duplicate or missed runs.

## What is this?

The **trigger** decides **when** a workflow runs. It listens for a specific event and starts the automation only when that event occurs. Every automation has exactly one trigger, and it's the first block on the canvas.

> [!NOTE]
>
> If a workflow fires at the wrong time or not at all, the trigger is the first thing to check.

## What can I do here?

The triggers you can choose depend on the channel type. Each one is covered on its own page:

| Trigger | Runs when… | Page |
| - | - | - |
| **Message Received** | An incoming message matches your keyword automations | [Message Received](https://wabis.mintlify.site/workspace/automation/triggers/message-received.md) |
| **New Conversation** | A brand-new conversation thread is opened (runs once) | [New Conversation](https://wabis.mintlify.site/workspace/automation/triggers/new-conversation.md) |
| **No Match Reply** | An incoming message does not match any keyword automation | [No Match Reply](https://wabis.mintlify.site/workspace/automation/triggers/no-match-reply.md) |
| **Receive Webhook** | An incoming webhook request is received | [Receive Webhook](https://wabis.mintlify.site/workspace/automation/triggers/receive-webhook.md) |
| **Contact or Custom Field Changed** | A selected contact or custom field is created, updated, or its value changes | [Contact or Custom Field Changed](https://wabis.mintlify.site/workspace/automation/triggers/contact-or-field-changed.md) |
| **Pipeline Stage Changed** | A contact is added to or moved within a selected pipeline, optionally filtered to a stage | [Pipeline Stage Changed](https://wabis.mintlify.site/workspace/automation/triggers/pipeline-stage-changed.md) |
| **Payment Status Changed** | A contact's payment is paid, partly paid, fails, is refunded, expires or is cancelled | [Payment Status Changed](https://wabis.mintlify.site/workspace/automation/triggers/payment-status-changed.md) |
| **Trigger Sequence** | A contact is enrolled into the sequence — use Sequence Drip steps for timed messages | [Trigger Sequence](https://wabis.mintlify.site/workspace/automation/triggers/trigger-sequence.md) |
| Comment, Live, Story, and referral triggers on Instagram | Someone comments, replies to a Story, or clicks a referral link | [Instagram Triggers](https://wabis.mintlify.site/workspace/automation/triggers/instagram-triggers.md) |
| Comment, Live, mention, and referral triggers on Facebook | Someone comments, @mentions your Page, or opens Messenger from a referral | [Facebook Triggers](https://wabis.mintlify.site/workspace/automation/triggers/facebook-triggers.md) |
| Group message, member joined or left, and join request in a WhatsApp group | Someone writes in, joins, leaves, or asks to join a group on your WhatsApp number | [WhatsApp Group Triggers](https://wabis.mintlify.site/workspace/automation/triggers/whatsapp-group-triggers.md) |
| Pre-chat form submissions on Web Chat | A website visitor submits the chat widget's pre-chat form | [Web Chat Triggers](https://wabis.mintlify.site/workspace/automation/triggers/web-chat-triggers.md) |

A good trigger matches the real business moment. A poor trigger causes duplicate runs, missed conversations, or logic that fires in the wrong place.

## How to use it

### Choose the right trigger

**1. Define the outcome first**

What should the automation achieve? For example: *Reply to pricing questions and assign them to sales.*

**2. Identify the true starting event**

What real activity marks the start? A keyword message, a new conversation, or a webhook — not a later step in the process.

**3. Pick the matching trigger**

Select the trigger whose event aligns exactly with that moment. When in doubt, prefer the most specific trigger.

### Tips

* **One trigger per workflow.** Don't try to start the same flow from multiple unrelated events — create focused flows instead.
* **Prefer triggers that carry data.** A trigger that includes the payload you need saves extra lookups.
* **Scope by channel.** A workflow built for WhatsApp won't fire for Web Chat. Confirm the channel in [Channels](https://wabis.mintlify.site/workspace/channels/overview.md).

## Troubleshooting / Technical Notes

* **The flow never runs.** Check that it's **Active** and the channel matches the conversation.
* **The flow runs twice.** Two automations may share the same trigger. Review the list in [Manage Live Flows](https://wabis.mintlify.site/workspace/automation/manage-live-flows.md).
* **A trigger I expect isn't in the list.** The builder shows the triggers available for the automation's channel — comment and referral triggers are channel-specific.

## Related docs

* [Automation Overview](https://wabis.mintlify.site/workspace/automation/overview.md)
* [Create a Workflow](https://wabis.mintlify.site/workspace/automation/create-a-workflow.md)
* [Builder Steps](https://wabis.mintlify.site/workspace/automation/steps/overview.md)
* [Manage Live Flows](https://wabis.mintlify.site/workspace/automation/manage-live-flows.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.