Triggers
The Trigger is the flow's start node. It defines which event activates execution. Each channel has its own trigger type with specific variables.
Reference
- WhatsApp — incoming message
- Fires when a message arrives on the connected number. Variables: {{trigger.message}}, {{trigger.from}}, {{trigger.message_id}}, {{trigger.type}} (text/image/audio/document).
- WhatsApp — button callback
- Fires when the user taps an inline button. Variable: {{trigger.callback_data}}.
- Telegram — message
- Fires on any message to the bot. Variables: {{trigger.message}}, {{trigger.chat_id}}, {{trigger.user.first_name}}.
- Telegram — callback
- Fires when the user taps an inline button. Variables: {{trigger.callback_query.data}}, {{trigger.callback_query.id}}.
- Instagram — DM
- Fires when a direct message arrives. Variables: {{trigger.message}}, {{trigger.sender_id}}.
- Manual webhook
- HTTP trigger. Receives any JSON payload at the webhook URL. Variables: entire body as {{trigger.*}}.
- Manual / Test
- To run the flow manually from the canvas or history. No real channel variables.
Common errors
- Flow doesn't activate with real messages
- Verify: 1) the flow is in Production mode, 2) the channel webhook is correctly configured in Meta/BotFather, 3) the Trigger points to the correct channel.
- Disconnected trigger
- The channel associated with the Trigger was deleted or disconnected. Reconnect the channel or create a new one.
Next step
Learn to activate Production mode to receive real events.