Import & Export

The Import and Export tools allow you to save your conversational flows as JSON files and load them back into the builder. This is useful for backups, sharing flows between environments, or migrating flows.

Accessing Import/Export

1. Click the Settings button (gear icon) in the top bar
2. Navigate to the General tab
3. Find the Export and Import buttons

Exporting a Flow

How to Export

1. Open the Settings menu
2. Go to the General tab
3. Click the Export button (download icon)
4. The file will download automatically

Export File Details

The exported JSON file contains:

File Naming

The exported file follows this naming convention:

{alias}-v{version}-{timestamp}.json

Example: onboarding-flow-v3-1705678900000.json

Importing a Flow

How to Import

1. Open the Settings menu
2. Go to the General tab
3. Click the Import button (upload icon)
4. Select a JSON file from your computer
5. Review the confirmation dialog
6. Click Confirm to import

What Gets Imported

When you import a flow, the following elements are updated:

1. Nodes and Edges - The entire flow structure is replaced
2. Variables - All flow variables are updated
3. Web Configuration - Chatbot appearance settings are applied

Import Confirmation

Before importing, a confirmation dialog appears warning that:

• Current flow content will be replaced
• This action cannot be undone
• It's recommended to export the current flow first as backup

Use Cases

Backup Before Major Changes

Before making significant modifications to your flow:

1. Export the current version
2. Make your changes
3. If something goes wrong, import the backup

Environment Migration

To move a flow from staging to production:

1. Export from staging environment
2. Import into production environment
3. Adjust any environment-specific configurations

Team Collaboration

Share flows with team members:

1. Export your flow
2. Share the JSON file
3. Team member imports into their workspace

Version Control

Keep historical versions of your flows:

1. Export after each major milestone
2. Name files descriptively
3. Store in your version control system

File Format

The exported JSON has the following structure:

{
  "label": "Flow Name",
  "alias": "flow-name",
  "description": "Flow description",
  "nodes": [...],
  "edges": [...],
  "variables": [...],
  "webConfiguration": {
    "logo": "...",
    "displayName": "...",
    "description": "...",
    "avatar": "...",
    "primaryColor": "#...",
    "buttonText": "..."
  },
  "exportedAt": "2024-01-19T12:00:00.000Z",
  "exportVersion": "1.0"
}

Troubleshooting

Import fails with error

Check that:

• The file is valid JSON
• The file contains nodes and edges arrays
• The file was exported from a compatible version

Some settings are not imported

Web configuration (logo, avatar, colors) is imported separately. If these don't appear:

• Check that the webConfiguration object exists in the file
• Refresh the page after import

Nodes appear but connections are missing

This can happen if:

• The file was manually edited and edge references are invalid
• The export was from an incompatible version

Try re-exporting from the original source.