How to create a new bot scenario in Scenario Builder?

Scenario Builder is a new module that replaces Scenario Dialog. This guide helps you create a basic scenario and configure its structure.

When you need it

  • You need to create a new bot with its own service scenario.
  • You need to build dialog logic for automating client responses.
  • You need to configure the sequence of messages and actions for the bot.

What you need to know

  • Scenario — a sequence of messages, actions, and logical transitions the bot executes during a user dialog.
  • Section — a logical block of the scenario with nodes and entry/exit points.
  • Node — an individual scenario element (message, input wait, action, etc.).
  • Edge — a connection between nodes that defines the execution sequence.

Before you start

  • You are logged in with integrator or administrator rights.
  • You have a bot created for which to create the scenario.
  • Scenario Builder is available for your instance (if the menu item is missing, contact your administrator).

Step-by-step instructions

1. Open Scenario Builder

  1. Go to Scenario Builder via Menu → Scenario Builder or Process Library.
  2. Select the bot for which to create the scenario.
  3. Click «Open constructor» or go to /scenario_builder/:id/scenario/:section_id.

2. Create the first section

  1. In the left panel (sections), click «Add section» or «Create section».
  2. Enter the section name (e.g., «Welcome»).
  3. Click «Create» — the section appears in the list.

3. Add start node

  1. On the canvas, click the «+» (add node) button.
  2. In the modal, select Start.
  3. The node appears on the canvas. Configure the trigger (channels, webhook, etc.) in the Node Inspector on the right. See Configure Start node triggers (index), What is the Start node (use cases) for details.

4. Add message with buttons

  1. Click «+» and select Message with buttons (MessageKeyboard).
  2. Connect the Start node to MessageKeyboard via an edge.
  3. In Node Inspector, enter the message text and add buttons.

5. Add input wait (optional)

  1. Click «+» and select Input wait (WaitForInput).
  2. Connect MessageKeyboard to WaitForInput via an edge.
  3. In Node Inspector, configure input type, validation, and variable for saving.

6. Save the scenario

  1. Check the structure on the canvas — all nodes should be connected.
  2. Click «Save» in the toolbar or press Ctrl+S (Mac: Cmd+S).
  3. The system saves changes and shows a success message.

What happens next

The scenario is saved and ready to use. The bot will execute the sequence of actions according to the created logic.