WhatsApp Trigger
Starts the flow when a customer messages your WhatsApp number. Every flow needs exactly one trigger per channel it serves.
- Out → the first node to run (usually an AI Agent).
Config
Section titled “Config”| Field | Status | Behavior |
|---|---|---|
| WhatsApp number | Live | Connects/disconnects the sandbox number — see the WhatsApp guide. |
| Keyword filter | Live | Comma-separated list (e.g. order, help, refund). If set, the flow only runs when the message contains one of the keywords (case-insensitive substring match). Blank = all messages. |
| Only trigger on first message | Live | When on, the flow only runs for a conversation’s first customer message — later messages are skipped. |
Runtime behavior
Section titled “Runtime behavior”When a WhatsApp message arrives, the engine picks this trigger, applies the
keyword filter, and if it matches, follows the Out wire. If the filter
doesn’t match, the turn is skipped (you’ll see keyword filter did not match
in the Test chat trace; first-message-only skips say
first-message-only: conversation already started).