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.

For the product-level capabilities, see the Chatbot Builder overview.

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
• Where to Work in the Interface
• Quick Links

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
• Edit a scenario together with colleagues — parallel work in different sections, live cursors, hand-over of a section on request. → Edit together
• 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, Bind MCP Tool to FLP agent
• 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
• Send Request with scenario secrets — HTTP auth and secret fields in URL/headers/body without tokens in node params (after admin enables the feature). → Use scenario secrets in Send Request
• Custom action with secrets — Credential parameter in Action Jail and server-side helpers. → Use scenario secrets in a custom action
• Built-in actions reference — common routing, Custom Data, schedule, timer, media, and Fastline actions. → Built-in actions reference
• 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
• C1 Flow (YAML) — read-only text snapshot of the saved scenario for analysis. → View C1 Flow · What is C1 Flow
• 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 Builder or Process 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
• Edit a scenario together with colleagues
• Create section

Multilingual

• Add translations

Import and Export

• Export and import scenario

History and Testing

• Test scenario
• View version history
• View C1 Flow (YAML)

Actions

• Use action in scenario
• Use scenario secrets in Send Request
• Configure operator queue cascade

Related Materials

• Scenario Dialog (Legacy) — legacy module for backward compatibility.
• Learn article: Processes and Scenarios — overview of Scenario Builder capabilities.