---
title: "How to create a new bot scenario in Scenario Builder"
description: "Instructions for creating a scenario in Scenario Builder — the new module that replaces Scenario Dialog."
---

# 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

- [x] You are logged in with integrator or administrator rights.
- [x] You have a bot created for which to create the scenario.
- [x] 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](/en/scenariobuilder/how-to/configure-start-node-triggers.md) (index), [What is the Start node](/en/scenariobuilder/explanation/what-is-start-node.md) (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.

## Related materials

- [Edit scenario](/en/scenariobuilder/how-to/edit-scenario.md)
- [Create section](/en/scenariobuilder/how-to/create-section.md)
- [Add translations](/en/scenariobuilder/how-to/add-translations.md)
- [Scenario Builder hub](/en/scenariobuilder/integrator-hub.md)