How to Export or Import a Scenario?

When you need to save a backup copy of a scenario or transfer it between projects, export and import allow saving the complete scenario structure to a file and restoring it later. This instruction will help export and import scenarios.

When Needed

  • You need to create a backup copy of the scenario before major changes.
  • You need to transfer the scenario from one project to another.
  • You need to restore the scenario from a previous version.
  • You need to share the scenario with other users or the team.

What's Important to Know

  • Export — saving scenario structure to a file (usually in JSON format).
  • Import — loading a scenario from a file and restoring its structure.
  • Backup — regular export of scenarios to protect against data loss.

Prerequisites

  • You are logged in with integrator or administrator rights.
  • You have access to the scenario that needs to be exported or imported.
  • For import: you have a file with the exported scenario.

Export Scenario

1. Open Scenario Editor

  1. Navigate to the Dialog module via Apps -> Dialog.
  2. Select the bot whose scenario needs to be exported.
  3. Open the scenario editor via route /dialog/bot-scenario/:id.

2. Open Export Menu

  1. In the scenario editor, find the "Export" or "Export Scenario" button (usually located near the "Save" button or in the settings menu).
  2. Click the export button — a modal window with export options opens.

3. Configure Export Parameters

  1. In the modal window, select what exactly needs to be exported:
    • All sections — export the entire scenario with all sections.
    • Current section — export only the active section.
    • Include translations — export translations for all languages.
  2. Click the "Export" button — the system creates a file with the scenario structure.

4. Download File

  1. The file automatically downloads to your computer (usually in JSON or ZIP format).
  2. Save the file in a safe place for further use.

Import Scenario

1. Open Scenario Editor

  1. Navigate to the Dialog module via Apps -> Dialog.
  2. Select the bot for which you need to import the scenario (or create a new bot).
  3. Open the scenario editor via route /dialog/bot-scenario/:id.

2. Open Import Menu

  1. In the scenario editor, find the "Import" or "Import Scenario" button (usually located near the "Export" button or in the settings menu).
  2. Click the import button — a modal window with import options opens.

3. Upload File

  1. In the modal window, click the "Select File" or "Upload File" button.
  2. Select the file with the exported scenario on your computer.
  3. The system automatically checks the file format and data validity.

4. Configure Import Parameters

  1. In the modal window, select import options:
    • Replace existing scenario — completely replace the current scenario with the imported one.
    • Add to existing — add imported sections to the current scenario.
    • Create backup — automatically export the current scenario before import.
  2. Click the "Import" button — the system begins processing the file.

5. Confirm Import

  1. The system shows a preview of the imported scenario (list of sections and nodes).
  2. Check that all data is correct.
  3. Click the "Confirm Import" button — the system imports the scenario and updates the canvas.

6. Verify Result

  1. After import, check the scenario structure on the canvas.
  2. Make sure all sections and nodes are imported correctly.
  3. Check translations (if they were included in the export).

7. Save Changes

  1. After verification, click the "Save" button at the bottom of the screen.
  2. The system saves the imported scenario and creates a new version in history.

What Happens After

After Export:

  • File with scenario structure is saved on your computer.
  • You can use this file for backup or transfer between projects.

After Import:

  • Scenario structure is restored from the file.
  • All sections, nodes, and translations (if included) are restored.
  • The scenario is ready to use after saving.

How to Verify It Worked

For Export:

  • Check that the file downloaded to your computer.
  • Open the file and make sure it contains structured scenario data.

For Import:

  • Check that all sections appeared in the sections list.
  • Make sure all nodes are displayed on the canvas.
  • Check translations (if they were included in the export).