How a journey is built
Journeys are authored on a visual canvas (built on React Flow) where you drag, drop, and connect nodes:Message node
Sends a specific WhatsApp template or free-text message to the contact.
Wait node
Pauses the journey for a set duration before continuing — e.g. “wait 2 hours”.
Condition node
Branches the flow based on logic such as “if button clicked” or “if tag exists”.
Goal node
Marks successful completion of a conversion event, tracked in the journey’s performance stats.
Real-time execution
Journeys react to incoming webhooks as they happen. When a contact interacts with a message — clicking a button, replying with a keyword — the journey engine evaluates the relevant condition immediately and advances the contact to the next node, without a polling delay.Drafts and publishing
New journeys start in Draft mode, where you can build and test the graph without affecting any live contacts. When you publish a new version, you choose whether contacts already partway through the previous version finish it as-is or migrate onto the new logic — so you can iterate on a live journey without disrupting contacts mid-flow.Performance monitoring
Every node in a published journey shows live stats: how many contacts entered that step, how many dropped (stopped progressing), and how many converted onward toward a goal. This makes it straightforward to spot the exact step where a flow is losing people.Data model
Journeys are stored asjourneys records, with contact progress tracked against the definitions in templates (for message steps) and the core conversations/messages ledger for execution history. See Data Model for how journeys relate to templates, campaigns, and the rest of the schema.
Drafting with Margaret
You can describe a journey in plain language and ask Margaret to draft the graph shape for you — she proposes a structure you review and approve before it’s created, the same draft-and-approve pattern used for templates and replies.See also
- Graphical Journey Editor — the canvas, node types, and versioning in full detail.
- Data Model — how
journeysfits withtemplates,campaigns, and the message ledger. - Campaigns — the one-shot alternative to a multi-step journey.
- Automations — how journeys combine with Margaret’s automation capabilities.