Every flow you build can be exported to a JSON file and imported into another agent. This lets you copy a working flow from a test agent to production, share flow templates across domains, and keep local backups before making big changes.
What Gets Exported
An exported file contains the full flow definition:
- All states (nodes), including their instructions and tool configurations.
- All transitions between states, including descriptions.
- Routing configuration for Call Routing states.
- Info collection field definitions and their actions.
- Comfort message overrides (if configured).
The file does not include anything specific to a single agent: voice settings, company knowledge, phone numbers, or integration credentials. Those stay with the agent you import into, so you cannot accidentally overwrite another agent's setup.
Exporting a Flow
- Open the agent whose flow you want to copy.
- Go to the Flows tab.
- Click Export in the flow toolbar.
- The browser downloads a file named
flows-<agentId>.json.
Save it somewhere you will remember. The file is plain JSON and safe to open in any editor if you want to inspect it, though hand-editing is not necessary for normal use.
Importing a Flow
- Open the target agent and go to the Flows tab.
- Click Import in the flow toolbar.
- Select a previously exported JSON file.
- The importer validates the file and loads the flow into the editor.
- Review the states, transitions, and tools. Save to commit the change.
Importing replaces the current flow on the agent. If you want to keep the existing flow, export it first so you have a backup you can restore.
What to Check After Importing
A flow is independent of the agent, but it assumes the target agent has the right integrations and data. After importing, verify:
- Integrations — if the flow uses Calendly or Heartland tools, confirm those integrations are enabled on the new agent's domain.
- Knowledge Base — if the flow has a Knowledge Base search tool, the new agent needs its own active Knowledge Base.
- Extensions and phone numbers — Call Routing destinations from one domain will not resolve on another. Update them to the new domain's extensions.
- Company info — prompts that reference "our Monday hours" or "our address" rely on the agent's training data. Make sure the target agent has equivalent content.
Common Use Cases
- Test → production. Build and iterate on a test agent, then export and import into the production agent when ready.
- Template reuse. Keep a library of exported flows ("basic lead capture," "after-hours router," "multi-location triage") and import them as starting points for new agents.
- Backups before a big change. Export the current flow, make the edit, and keep the old file as a one-click rollback.
Validation Errors on Import
If the file was edited by hand or came from an older version, the importer may flag format issues. The editor converts older formats automatically on save when it can. If you see a hard error, the safest fix is to re-export from the source agent on the current version and try again.
Still have questions?
Submit a ticket and we will help you move flows between environments.