Documenting

Features and functionality that allows you to turn your design into a communication tool for your team.

Content Exports

An overview on how to export the different types of content contained within your Voiceflow project.

Exporting a Project

To export your project, click the Share button on your project’s top bar. In the Export As tab, you can export your project content and your project's NLP/NLU data into several formats.

Supported formats for Project Content:

  • Project file (.JSON) - all your project content in JSON
  • Dialogs (.CSV) - your project’s response content
  • PDF
  • PNG image

Supported formats for NLP/NLU Exports (Configuration):

  • Voiceflow CSV
  • Microsoft LUIS
  • Amazon Alexa
  • Dialogflow ES
  • Rasa
  • Amazon Lex V1
  • IBM Watson
  • Salesforce Einstein

For NLP/NLU data, you can choose to export your entire model or specific intent(s).

Note: The NLU/NLP exports & formats are only available on 'Voice Assistant' and 'Chat Assistant' type projects, and are unavailable on 'One-Click Publish' type projects.

Share Project Files with Link

You can share your project files across different Voiceflow workspaces, by generating a project clone link.

On the dashboard, hover over your desired project and access its options menu. Hit ‘Copy Clone Link’ and share.

Note: The ‘Copy Clone Link’ feature takes a snapshot of your project at the time you copy the link. You’ll overwrite the link’s previous project snapshot with your current version when you copy the link again. Make sure you copy the link via the options menu to ensure you’re sharing the latest version of your project.

Importing Voiceflow Project files

You can import Voiceflow Project files (.json) onto your workspace by navigating to your workspace Dashboard and selecting the 'Import' icon next to the workspace settings icon.

Selecting this will bring up your computer's file navigation/upload menu. Ensure you ONLY upload files with a .vf file extension in its file name, which is usually obtained from exporting a Project file (JSON) on the project-level sharing menu.

This feature allows for designers and teams to collaborate on projects with their own separate & local versions of the project. This also allows for debuggers, testers or support functions to work with a separate version of your project that they can import into their workspaces to debug or test.

NLU Data & Exports

To export your project's data in supported NLP/NLU formats, ensure you are on a Chat Assistant or Voice Assistant project and navigate to the Share button on your project/canvas top bar.

Then navigate to Export As and toggle the NLU Data option and select the export that best fits your use case.

Voiceflow NLU (CSV)

With a Voiceflow NLU (Voiceflow CSV) export, you will receive your project's intent and utterance data in a generic CSV format. 

Tip: You have the opportunity to import specific intents or the entire model with the Configuration section.

With the Voiceflow CSV export file, there are two columns: Intent Name (including built-in intents and associated custom utterances) and Utterances (categorized in the intent). Any entities used within utterances are indicated as curly braces '{', just as they would be on the Voiceflow Creator Tool.

You can use this data to unlock and allow you to get your Voiceflow NLU data in a simply formatted way for handoff to team members, or to convert it into the desired format required to import it to your NLU or another 3rd party tool.

Amazon Lex V1

Exporting project content into the Amazon Lex V1 format provides a master (.zip) file with each one of your project's intents nested in the .zip file, with each intent as its own unique (.zip) file.

You are then able to import your intents into the Amazon Lex console, under the Intents menu. You can individually import the intent files (.zip) into the Amazon Lex console and all the associated utterance data. You can also upload slot types and slot values under the Slot types menu in the Amazon Lex console.

Note: The import process with Amazon Lex only works with the V1 Console, as this is a V1 Export. Ensure you do NOT 'Switch to the new Lex V2 console' option found on the sidebar.

IBM Watson

With IBM Watson NLU/NLP exports, you receive a .json file export which contains your project's defined intent data.

In the Watson Assistant Dashboard, you will navigate to the Skills tab and Create skill or navigate to an already created skill. You can then navigate to the menu associated with the skill by clicking the three-dots () and select Upload.

This is where you can upload the IBM Watson export (.json) from Voiceflow directly here and overwrite your full skill. This will populate your skill on IBM Watson and directly upload your Voiceflow project's intent and entity data.

Note: You'll need to make sure your Watson Assistant instance is switched to the “Classic Experience” in the account menu. Ensure that the version of the Watson Assistant being used is NOT set to the “new experience”.

Salesforce Einstein

With a Salesforce Einstein export from Voiceflow, you will receive a (.csv) export of your project's model. This will usually be a four-column export with the Intents, Utterances and language(s) contained within your project.

Within Salesforce, log into Data Loader to follow the steps to import the (.csv) Voiceflow export and map the columns to the data types within Salesforce Einstein. This should be a straightforward process as the export will line up (one-to-one) and intents should map without issues. Please note that there is no import option for entities in Salesforce Einstein.

More information on the Salesforce Einstein import process is found here.

Nuance Mix

With Voiceflow's export for Nuance Mix, you will download a (.trsx.xml) copy of all your projects NLU model data. This file will include all intent, utterance, entity and entity value data.

In your Nuance Mix Dashboard, select a project you'd like to upload the data to, and then open the Import/Export tab on the right. Select the ".trsx, .xml, .zip" import option, and select your export in the file selector. This will overwrite all data on your project.

More information on the Nuance Mix import process can be found here.

Other docs in this section