Integrator — Scenario Builder Scenarios Hub
Scenario Builder is a new module that replaces Scenario Dialog. Here you create and edit bot scenarios through a visual editor with a drag-and-drop interface, add translations, and configure bot logic.
Recommendation: Use Scenario Builder for new development. Scenario Dialog remains available for backward compatibility — see Scenario Dialog (Legacy).
Quick Overview
High-Level Goals and Scenarios
Process Library and Search
Goal — quickly find the right bot among many scenarios.
- Use the process library — search, filters, opening constructor. → How to use the process library
- About the process library — explanation of filters, categories, hierarchy. → How the process library works
Creating and Editing Scenarios
Goal — build bot dialog logic through the visual editor.
- Create new scenario — how to create a bot scenario from scratch. → Create scenario
- Edit existing scenario — how to make changes to a scenario. → Edit scenario
- Create scenario section — how to organize a complex scenario into sections. → Create section
Working with Nodes and Logic
Goal — configure scenario elements and their interaction.
- Node type explanations (integrator task, then parameter reference): Menus and buttons · Text from the client · Live operator · Conditional branches (router) · Between sections · Store values (Set)
- Start node and triggers — section entry point with five trigger types: process start, webhook, channels, internal events, MCP Tool. → What is the Start node, Configure triggers (index), Process start, Webhook, Channels, Internal events, MCP Tool
- Entry Point / Exit Point — enter section from another flow or HTTP; jump to another section. → Entry Point, Exit Point
- Connect to operator — subject, tags, events (success / banned / limit / error), aliases. → Connect to operator parameters
- Operator queue cascade — reminders while the client waits for an operator, steps, repeats, branches, and automatic stop. → Operator queue cascade, Configure cascade, Cascade parameters
- Add node — via the «+» button on the canvas; modal with categories (Main, Messaging, Data, etc.).
- Configure Instagram scenario — Router, event types, public reply to comment. → Configure Instagram scenario
- Use actions in scenario — how to add and configure actions. → Use action in scenario
- Standard built-in actions — overview of common routes: Custom Data, schedule, timers, media, Fastline. → Standard built-in actions
- Message + keyboard — attachments, messengers, buttons, validation. → MessageKeyboard parameters
- Wait for input — timeout, skip, validation. → WaitForInput parameters
- Variables and constants — separate sidebar for managing process variables.
Multilingual Support and Translations
Goal — ensure support for multiple languages in the scenario.
- Add translations to scenario — how to add translation texts. → Add translations
- Missing translations are highlighted in red with a badge in the interface.
Import and Export
Goal — save a backup or transfer scenario between projects.
- Export and import scenario — → Import and export
Version History and Testing
Goal — track changes and test the scenario directly in the editor.
- Test scenario — run, chat preview, run history. → Test scenario
- Version history — view and restore previous versions. → View version history
- Runs — scenario run history with view of executed nodes.
- Chat preview — widget for viewing chat during interactive test.
Where to Work in the Interface
- Scenario Builder module:
Menu → Scenario BuilderorProcess Library. - Route
/scenario_builder/:id/scenario/:section_id— scenario editor. - Canvas — central area for visual editing of nodes.
- Node Inspector (right panel) — edit parameters of the selected node.
- Left panel — sections, variables, constants, run history.
- Top toolbar — save, run, export, auto layout, node search.
Quick Links
Creating and Editing
- Create new scenario
- Configure Start node triggers (index of all how-tos)
- Configure Instagram scenario
- Edit scenario
- Create section
Multilingual
Import and Export
History and Testing
Actions
Related Materials
- Scenario Dialog (Legacy) — legacy module for backward compatibility.
- Learn article: Processes and Scenarios — overview of Scenario Builder capabilities.