How to View and Restore Scenario Versions?

Scenario version history allows tracking all scenario changes and restoring previous versions in case of errors or unsuccessful editing. This instruction will help view version history and restore the needed scenario version.

When Needed

  • You need to see all saved scenario versions to track changes.
  • You need to restore a previous scenario version after an error or unsuccessful editing.
  • You need to compare different scenario versions to analyze changes.

What's Important to Know

  • Scenario version — saved state of the scenario after each save.
  • Active version — scenario version that is currently used by the bot.
  • Version history — list of all saved scenario versions with dates, authors, and comments.
  • Version restoration — activation of a previous scenario version instead of the current one.

Prerequisites

  • You are logged in with integrator or administrator rights.
  • You have an open scenario editor for the bot.
  • The scenario has at least one saved version.

Step-by-Step Instructions

1. Open Version History

  1. In the scenario editor, find the "History" button near the "Save" button (clock icon or list icon).
  2. Click the button — a modal window with scenario version history opens.

2. View Versions List

  1. In the modal window, you see a table with all scenario versions.
  2. For each version, the following is displayed:
    • Creation date — when the version was saved.
    • Author — who saved the version (user name or email).
    • Comment — description of changes (if added during saving).
    • Status — whether the version is active (current bot scenario).

3. View Version Details

  1. Find the needed version in the list.
  2. Click the "Show" button or click on the version in the table.
  3. A page with the scenario version opens — the canvas displays the scenario structure in the state of the selected version.
  4. You can view all sections, nodes, and connections of the version.

4. Activate Previous Version

  1. Find the version you need to activate.
  2. Click the "Activate" button — a confirmation dialog window opens.
  3. In the dialog window:
    • Read the warning that activating the version will replace the current active scenario.
    • (Optional) Enable the "Keep Current Version" option if you need to save the current version in history before activating the previous version.
  4. Click the "Confirm" or "Activate" button.
  5. The system activates the selected version and updates the scenario.

5. Verify Result

  1. After version activation, check the scenario structure on the canvas.
  2. Make sure all sections and nodes correspond to the activated version.
  3. Check that the active version updated in version history (marked with an indicator).

What Happens After

Version is activated:

  • Current active scenario is replaced with the selected version.
  • The bot begins using the activated scenario version.
  • Previous version is saved in history (if the save option was selected).
  • All changes are displayed on the canvas.

How to Verify It Worked

  • Check that the scenario structure on the canvas corresponds to the activated version.
  • Make sure the active version updated in version history.
  • Check that the bot uses the new scenario version during dialogs.

Important Notes

  • ⚠️ Version Activation: Activating a version replaces the current active scenario — make sure this is what you need.
  • 💾 Saving Current Version: It is recommended to save the current version before activating a previous one — this allows returning to it later.
  • 📝 Version Comments: Add comments when saving the scenario — this helps quickly find the needed version in history.