Dialogflow CX - Imports & Exports

Voiceflow allows you to export the NLU data that you have designed on your Assistant directly to Dialogflow CX to speed up the hand-off of production-ready data to your NLU provider. 

Data Included in Exports

Here is a quick overview of the data that will be imported Dialogflow CX from your Voiceflow Assistant:

• Intents
• Entities (including names, values and synonyms)
• Training Phrases (including all entity annotations)

Exporting Data from Dialogflow CX

You can export your data directly from the Dialogflow CX Console, ready for use inside Voiceflow. On your console, open your list of Agents. Open the three-dot menu to the right of your Agent’s name, and select ‘Export’. Choose the data format ‘JSON Package’, and export agent to ‘Download’, and export your agent. 

Importing Data into Voiceflow

Once you have the ZIP file contain your Dialogflow CX Agent's NLU data, you can import this data into Voiceflow, in two ways:

On Assistant Creation

When creating a new assistant in Voiceflow, you will be asked to select your use case (Launch & Host or Design & Handoff), choose Design & Handoff. The select the channel you are building for (Voice Assistant or Chat Assistant) and the NLU you are building for.

Once you select Dialogflow CX from the options, an upload link will appear, and when you click it, you can select the CSV file you have created.

 This will pre-populate your assistant with the complete training data set contained in your file.

In your NLU Manager

There is a similar import function available in your NLU Manager view, and clicking the ‘Import’ button found in the bottom-left will trigger the import flow.

Using this import method will upload all new intents, entities and user examples without deleting the current ones. Any intents or entities with the same name will be overwritten by the newer version.

Connecting an Assistant to Dialogflow CX Agent

The first step is to create a new assistant with the NLU set to Dialogflow CX. Once in the assistant canvas, you will find an Upload button in the top-right corner of the Design Canvas header. 

Clicking this will be the primary way to upload your NLU Data to DF CX, each time you wish to upload. 

The first time you click on this, it will prompt you to authenticate your Google Account. Sign into your desired account and accept the permissions. 

You will then be prompted to connect an agent. To do this, you will need to go to the Dialogflow CX Console, select the Project and the Agent you wish to link to your Voiceflow assistant. Once you're on the 'Build' tab for that agent, you will need to copy the URL. It should looks something like:

https://dialogflow.cloud.google.com/cx/projects/cx123123123123123123123123-123/locations/global/agents/1231231-2312-3123-1231-231231231231/flows/00000000-0000-0000-0000-000000000000/flow_creation

You can then paste this URL into the 'Connect an Agent' modal in your Voiceflow assistant: 

You can then select 'Continue' to initiate your upload.

Uploading New NLU Data Versions to CX

After your initial upload, every time you click the upload button on your assistant, you will be prompted to provide a version name for your upload:

This will allow you to distinguish between your uploaded version on the Versions page. 

Selecting Intents for Upload

By default, you will be uploading all the Intents on your Voiceflow assistant to your CX Agent. If you wish to upload only specific Intents each time, you can select the 'Settings' icon on the 'Upload to Dialogflow CX' modal. 

In this menu, you can select specific intents you wish to upload from the dropdown. The selected intents will persist for the next upload, unless you change them.

Additionally, in this menu, you can change the CX Agent that is linked to your Voiceflow assistant by adding a different Agent's URL here.