Skip to contentSkip to navigationSkip to topbar
On this page

Connect Virtual Agent (Dialogflow ES)


(error)

Danger

Google Dialogflow ES integration is no longer supported by Twilio as of May 27, 2024. For more information, see this Twilio Changelog announcement(link takes you to an external page).

Studio customers using Programmable Voice and Dialogflow ES should migrate to using Connect Virtual Agent with Google Dialogflow CX.

(information)

Studio uses Widgets to represent various parts of Twilio's API that can then be stitched together in your Studio Flow to build out robust applications that require no coding on your part.

(information)

Info

New to Twilio Studio? Check out our Getting Started guide!

The Connect Virtual Agent (Dialogflow ES) Widget allows you to connect a Twilio Voice call to a Dialogflow Essentials (ES) agent(link takes you to an external page).

You can leverage a native integration between Twilio Voice and Google's Dialogflow ES to provide callers with conversational experiences through their Interactive Voice Response (IVR). Twilio provides the telephony aspect of the conversational IVR experience, and Dialogflow ES manages agent configuration, including intents and responses, via the Dialogflow ES console or Dialogflow APIs.

Connect Virtual Agent (Dialogflow ES) Widget.
(information)

Info

Connect your Dialogflow ES agent to Twilio from the Dialogflow ES console. Choose the "Twilio" One-Click Telephony integration in the Integrations section of the Dialogflow ES console, and follow the prompts to complete the setup. Once the integration is complete, you can use Twilio to manage the flow of your calls and configured connections to Dialogflow ES agents.

When you first connect a Dialogflow ES agent to Twilio via the One-Click Integration, Twilio will create a new Studio Flow containing a Connect Virtual Agent (Dialogflow ES) widget. When a call comes in to the Twilio number you've configured for the integration, Twilio will connect the call directly to this Studio Flow and route the caller to the Dialogflow agent.

You can modify this Flow by adding widgets before and after the Connect Virtual Agent (Dialogflow ES) Widget. Additionally, once you have connected a Dialogflow ES agent to Twilio using the One-Click Telephony integration, you can then add a Connect Virtual Agent (Dialogflow ES) Widget for that agent to other Studio Flows.

Note that you cannot pass information back and forth between Twilio Studio and the Dialogflow agent. This Widget allows you only to connect a Twilio Voice call to a Dialogflow agent, and then resume the call Flow once the caller has stopped speaking with the Dialogflow agent. If you need to modify what happens during the Dialogflow agent conversation, you should do so in the Google Dialogflow console.


Required Configuration for Connect Virtual Agent (Dialogflow ES)

required-configuration-for-connect-virtual-agent-dialogflow-es page anchor

The Connect Virtual Agent (Dialogflow ES) Widget requires the connector name for the Google Dialogflow ES instance.

NameDescriptionDefault
Connector NameConfigured in Dialogflow ES connector instance in the Unique Name Field. Appears as "Unique Name" in the connector.empty
(error)

Danger

Editing the Connector Name within the Connect Virtual Agent (Dialogflow ES) Widget alone will break the integration between Dialogflow ES and your Twilio project. If you need to update the Connector Name, you must edit it in the Dialogflow ES Stream Connector(link takes you to an external page) and the Studio widget.


Optional Configuration for Connect Virtual Agent (Dialogflow ES)

optional-configuration-for-connect-virtual-agent-dialogflow-es page anchor

The Connect Virtual Agent (Dialogflow ES) Widget also accepts a number of configuration options that you can use to configure agent interactions and analysis.

NameDescriptionDefault
LanguageLanguage to be used by Dialogflow ES agent.Defaults to the language provided in the Dialogflow ES connector configuration.
Sentiment AnalysisWhether sentiment analysis should be enabled or not.Defaults to the sentiment analysis setting in the Dialogflow ES connector configuration.
Status Callback URLURL to post status callbacks from Twilio.empty

Connect Virtual Agent (Dialogflow ES) Transitions

connect-virtual-agent-dialogflow-es-transitions page anchor

These events trigger transitions from this Widget to another Widget in your Flow. For more information on working with Studio transitions, see this guide.

NameDescription
ReturnFired when the Dialogflow ES agent ends the connection because an intent matched the "end of the conversation" intent.
HangupFired when the caller hangs up during the Dialogflow ES agent interaction.

Now that you know the basics of the Connect Virtual Agent (Dialogflow ES) Widget, you may want to learn more about connecting Twilio with your Google Dialogflow Agent:

We can't wait to see what you build!

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.