maestro
latest
false
Maestro user guide
- Introduction
- Getting started
- Building with Maestro BPMN
- Understanding Maestro BPMN modeling
- Opening the modeling canvas
- Modeling your process
- Aligning and connecting BPMN elements
- Autopilot for Maestro (Preview)
- Process Repository
- Implementing a simple BPMN process
- Implementing a complex BPMN process
- Debugging
- Simulating
- Common implementation scenarios
- Building with Maestro Case
- Introduction to Maestro Case
- Maestro BPMN vs. Maestro Case: when to use case management
- The Maestro Case lifecycle: from event trigger to app experience
- Build your first case with Maestro Case
- Build a Maestro Case with a coding agent (preview)
- Defining case keys (system vs. external)
- Establishing task I/O and write-back contracts
- Exit rules and early stage termination
- Modeling primary and secondary stages
- Triggering a case from Data Fabric
- Implementing stage-level personas and permissions
- Setting SLAs and automated escalation rules
- Configuring a rework loop (re-entry)
- Configuring and testing the Case Manager Agent (preview)
- Case Manager input and output contract
- Maestro Case component dictionary
- Building with Maestro Flow
- Integrations
- Operating
- Monitoring
- Optimizing
- Reference information
The conversation trigger marks the Flow as conversational and interactable from any chat channel.
What it does
The presence of a conversation trigger is what makes the Flow discoverable as a conversational agent on every supported chat channel once published.
Each conversation runs as a single Flow instance — suspending and resuming at each Wait for Message as the user sends more messages. When the Flow execution ends, the conversation gracefully completes as well; users see that the conversation has ended and cannot send more messages to the chat.
Output
| Field | Description |
|---|---|
conversationId | Unique identifier for the conversation this run is serving. |
Downstream conversational nodes may require a Conversation ID input. Reference the trigger's output, such as with:
$vars.conversationTrigger1.output.conversationId
$vars.conversationTrigger1.output.conversationId
Notes
- Ensure a Wait for Message node immediately follows the conversation trigger.
- Once published, the conversation trigger only fires when it's set to the Flow's default trigger in Orchestrator. Either ensure this is the Flow's only trigger, or confirm that the conversation trigger is the default entry point in Orchestrator after publish.
Related pages
- Wait for Message — the next node in a chat loop.
- Chat — full palette of chat conversational nodes.
- Build a chat agent workflow — end-to-end walkthrough starting with the Conversation Trigger.
- Chat deployment — publish and expose the Flow through various channels.