Home/Browse/🛠️ State Management System for Long-Running Workflows with Wait Nodes

🛠️ State Management System for Long-Running Workflows with Wait Nodes

n8n22 modulesv1.0

codeexecuteWorkflowexecuteWorkflowTriggerfilterhttpRequestifmanualTriggernoOprespondToWebhooksetsplitOutwait

About this workflow

How it works This template is a powerful, reusable utility for managing stateful, long-running processes. It allows a main workflow to be paused indefinitely at "checkpoints" and then be resumed by external, asynchronous events. This pattern is essential for complex automations and I often call it the "Async Portal" or "Teleport" pattern. The template consists of two distinct parts: 1. The Main Process (Top Flow): This represents your primary business logic. It starts, performs some actions, and then calls the Portal to register itself before pausing at a Wait node (a "Checkpoint"). 2. The Async Portal (Bottom Flow): This is the state-management engine. It uses Workflow Static Data as a persistent memory to keep track of all paused processes. When an external event (like a new chat message or an approval webhook) comes in with a specific sessionid, the Portal looks up the corresponding paused workflow and "teleports" the new data to it by calling its unique resumeurl. This architecture allows you to build sophisticated systems where the state is managed centrally, and your main business logic remains clean and easy to follow. When to use this pattern This is an advanced utility ideal for: Chatbots: Maintaining conversation history and context across multiple user messages. Human-in-the-Loop Processes: Pausing a workflow to wait for a manager's approval from an email link or a form submission. Multi-Day Sequences: Building user onboarding flows or drip campaigns that need to pause for hours or days between steps. Any process that needs to wait for an unpredictable external event without timing out. Set up steps This template is a utility designed to be copied into your own projects. The workflow itself is a live demonstration of how to use it. 1. Copy the Async Portal: In your own project, copy the entire Async Portal (the bottom flow, starting with the A. Entry: Receive Session Info trigger) into your workflow. This will be your state management engine. 2. Register Your Main Process: At the beginning of your main workflow, use an Execute Workflow node to call the Portal's trigger. You must pass it a unique sessionid for the process and the resumeurl from a Wait node. 3. Add Checkpoints: Place Wait nodes in your main workflow wherever you need the process to pause and wait for an external event. 4. Trigger the Portal: Configure your external triggers (e.g., your chatbot's webhook) to call the Portal's entry trigger, not your main workflow's trigger. You must pass the same sessionid so the Portal knows which paused process to resume. To see it in action, follow the detailed instructions in the "How to Test This Workflow" sticky note on the canvas.

🛠️ State Management System for Long-Running Workflows with Wait Nodes

At a glance

About this workflow

How to import this n8n workflow

Setup guide

Step 1: Connect your apps

Step 2: Import the workflow JSON

More N8n workflows

Reviews