Google Cloud Dialogflow CX quick start guide

AI-generated summary

Genesys Cloud integrates with Google Cloud Dialogflow CX to deliver conversational AI capabilities for contact centers by combining Google's machine learning and natural language understanding with Genesys automation infrastructure. The integration enables real-time audio streaming from Genesys Cloud to Dialogflow CX for intent and slot processing, supporting order placement, bot integration, call transfers, audio prompt configuration, and phone number routing. Natural language understanding functionality recognizes user intent and extracts entities such as time, date, and numbers, while self-service fulfillment occurs either on the Google side or within Architect flows, with graceful escalation to live agents when needed. The feature maintains PCI DSS compliance for secure call flows. Implementation requires a Google Cloud Platform account and Genesys Cloud subscription update through Genesys Cloud Sales for premium access. Technical setup involves creating a Google Cloud Dialogflow CX service account credential with appropriate roles (Dialogflow API Client, Dialogflow API Reader, and Dialogflow Conversation); obtaining the integration from Genesys AppFoundry; configuring credentials by mapping specific JSON key values (client_id, client_email, private_key_id, and private_key) into corresponding Genesys Cloud fields; and activating the integration through the Details tab. Edge and Media Tier version 1.0.0.8398 or later is required, with configurable regional search settings supporting multiple regions such as us-central1 through JSON configuration. Architect flow configuration involves accessing Admin > Orchestration > Architect, selecting an appropriate flow type, and defining flow properties including name, description, default language, and division assignment. The flow utilizes Task actions with initial greeting prompts and Call Dialogflow CX Bot actions from the Data category. Outcome path configuration includes Play Audio actions for customer confirmations and Transfer to ACD actions for routing to live agents, with optional parameters for queue selection, pre-transfer audio, routing priority, preferred agents, and language skills. Phone number routing is established through Call Routing configuration accessible via Menu > Orchestration > Routing > Call Routing, where users create call route entries by assigning unique names, adding telephone numbers in numeric format, and configuring flow routing. Only previously published Architect flows can be associated with call route configurations. The process requires Architect Flow View and Call Route Add, Edit, View, Delete permissions, with published flows appearing in search results after a few minutes.

Google and Genesys developed a partnership to help organizations deliver advanced capabilities to enhance customer experiences, blending AI and Google voice interaction technologies with Genesys contact center automation.

Note: This feature is PCI DSS compliant. You can use this integration in secure call flows.

Google Cloud Dialogflow CX bots use Google machine learning. This machine learning implements natural language understanding (NLU) to recognize a user’s intent and then extracts entities such as time, date, and numbers. With the evolving functionality of artificial intelligence tools, conversational interactions with computers are now mainstream. Contact centers are a natural progression into this world of virtual assistants.

Organizations can stream audio in real time from Genesys Cloud to Google Cloud Dialogflow CX and return intents and slots to Genesys Cloud. The self-service fulfillment of intent can be handled on the Google side or in Architect flows. When required, customers gracefully escalate to an appropriate agent.

Click the image to enlarge.

Quick start steps

This quick start article helps guide you through implementing the Google Cloud Dialogflow CX integration. Here, you learn how to perform the following steps:

Create the Google Cloud Dialogflow CX platform service account credential.
Obtain the Google Cloud Dialogflow CX integration from Genesys AppFoundry.
Configure and activate the Google Cloud Dialogflow CX integration.
Set up a Genesys Cloud Architect flow and then associate the Google Cloud Dialogflow CX bot with the Architect flow.
Route a Genesys Cloud phone number to the Architect flow.

Note: Before you can obtain the GoogleCloud Dialogflow CX premium application, you must contact Genesys Cloud Sales to update your subscription. For more information about these applications, see and .

Step 1: Create the Google Cloud Dialogflow CX platform service account credential

This section describes how to create a Google Cloud Dialogflow CX platform service account credential in the Google Cloud Platform console.

Create the Google Cloud Dialogflow CX platform service account credentialClick to expand

Prerequisites

To create the Google Cloud Dialogflow CX platform service account credential, perform the following steps:

In the Google Cloud Platform console, create a new project and then create a service account for the project.
Grant the following roles to the service account:
- Dialogflow API Client
- Dialogflow API Reader
- Dialogflow Conversation
Create a service account key and download the JSON version of it.

Learn moreClick to expand

Step 2: Obtain Google Cloud Dialogflow CX from the Genesys AppFoundry

This section describes how to access and install the Google Cloud Dialogflow CX integration from the Genesys AppFoundry. Before you can obtain the Google Cloud Dialogflow CX premium application, you must contact Genesys Cloud Sales to update your subscription. For more information about these applications, see What are premium applications? and About premium applications.

Install the Google Cloud Dialogflow CX integration from Genesys AppFoundryClick to expand

To install Google Cloud Dialogflow CX in your org, perform the following steps:

Log in to Genesys Cloud for the org in which you want to add Google Cloud Dialogflow CX:
1. Select the appropriate organization.
2. Enter your email address and password.
3. Click Log in.
Click Menu > IT and Integrations > Integrations.
Click Integrations .
In the Search box, type Google Cloud Dialogflow CX. The card for Google Cloud Dialogflow CX appears.
Click the Google Cloud Dialogflow CX card. Information about the app appears.
Click Install.

Google Cloud Dialogflow CX is now available to configure and activate from Genesys Cloud’s Admin > Integrations > Integrations page.

Learn moreClick to expand

Step 3: Configure and activate the Google Cloud Dialogflow CX integration

This section describes how to configure the Google Cloud Dialogflow CX platform service account credential in Genesys Cloud.

Configure the Google Cloud Dialogflow CX platform service account credentialClick to expand

Prerequisites

Edge and Media Tier version 1.0.0.8398 or later

To configure and activate the Google Cloud Dialogflow CX integration, perform the following steps:

In the Google Cloud Platform console, create a new project and then create a service account for the project. For more information, see Creating and managing service accounts.
Grant the Dialogflow API Client and Dialogflow API Reader roles to the service account. For more information, see Granting roles to service accounts.
Note: These roles enable Genesys Cloud to access and search the Google Cloud Dialogflow CX agents, and successfully carry out the bot at runtime.
Create a service account key and download the JSON version of it. For more information, see Creating and managing service account keys.
Note: The JSON file contains the credentials required for the integration with Genesys Cloud. The Google Cloud Dialogflow CX integration does not require that you add roles or admins to the service account.
In Genesys Cloud, open the Google Cloud Dialogflow CX integration:
- If you have not previously installed the integration into your Genesys Cloud organization, install it now.
- If you have installed the integration, click Menu > IT and Integrations > Integrations. Then, search for and open the Google Cloud Dialogflow CX integration.
On the Google Cloud Dialogflow CX integration page, click the Configuration tab.
Click Credentials.
Click Configure. The Configure Credentials dialog box opens.
Open the Google Cloud JSON service account key file that you downloaded previously.
Copy the information from the JSON service account key file into the appropriate Genesys Cloud fields.
1. Copy the “client_id” value from the JSON file into the Genesys Cloud Client ID field.
2. Copy the “client_email” value from the JSON file into the Genesys Cloud Client Email field.
3. Copy the “private_key_id” from the JSON file into the Genesys Cloud Private Key ID field.
4. Copy the “private_key” value from the JSON file into the Genesys Cloud Private Key field.
  Notes:
  - Ensure that you copy all the information that appears between the quotation marks.
  - Ensure that you copy and paste the exact value shown, and that no values convert to invalid commands. For example, a third-party copy program can convert the n value to a new line.

On the Advanced tab, define the Google regions in which to look for Google Cloud Dialogflow CX bots. By default, this setting is {}, and Genesys Cloud searches only for the global region. However, you can, for example, specify the following:

{

 "locations": [

   "global",

   "us-central1"

 ]

}

With this configuration, Genesys Cloud searches the global and us-central1 regions.

Click Save.

Select the Details tab.

To activate the integration, click Inactive. The Change Status dialog appears and asks you to confirm that you want to activate Google Cloud Dialogflow CX.

Click Yes. The status changes to Active.

Learn moreClick to expand

Step 4: Create a Genesys Cloud Architect flow and configure it with a Google Cloud Dialogflow CX bot

The following example demonstrates how to create an Architect flow that allows customers to order flowers for delivery. The example provides an extra example that displays how to set up Architect for a preconfigured Google Cloud Dialogflow CX bot for car rental. These examples assume that you have a previously configured Google Cloud Dialogflow CX agent, and also Genesys Cloud queues and data actions.

Create the flowClick to expand

Prerequisite

A Google Cloud Dialogflow CX bot configured in the Google Cloud Dialogflow CX console. For more information, see Google Cloud Dialogflow CX documentation.

To create an Architect flow, perform these steps:

In Genesys Cloud, click Admin > Orchestration > Architect.
From the Architect home page, click or hover over the Flows menu and choose the appropriate flow type.
Click Add . The Create Flow dialog box opens.
In the Name field, enter a unique name for the flow.
(Optional) In the Description field, include a short sentence or phrase to describe this flow.
Click the Default Language list and select the flow’s default supported language.
Click the Divisions list and select the division in which to place the flow.
Click Create Flow. The flow configuration page opens.

Create a task to call the Google Dialogflow botClick to expand

Configure the task for flower ordersClick to expand

Configure the outcome pathsClick to expand

From the Architect toolbox, expand the Audio category and drag a Play Audio action below the Order Flowers path.
Add a prompt or text-to-speech that thanks the customer for the flower order.
Expand the Transfer category and drag a Transfer to ACD action below the LiveAgent path.
Configure the Transfer to ACD action for the following options:
- The queue to transfer the customer when they want to speak to a live agent.
- (Optional) Pre-transfer and failed transfer audio.
- (Optional) Routing priority, preferred agents, and language skills.
- (Optional) Failure outputs.

Learn moreClick to expand

Step 5: Route a Genesys Cloud phone number to the flow

If you already own a phone number, you can associate it with the flow you created previously. You can also purchase a Genesys Cloud Voice phone number. For more information about Genesys Cloud Voice, see the Learn more section below.

Create the call route entry and associate telephone numbersClick to expand

Prerequisites

This task requires the following permissions:

Architect > Flow – View
Routing > Call Route – Add, Edit, View, Delete

To configure the call route entry, perform the following steps:

In Genesys Cloud, click Menu > Orchestration > Routing > Call Routing.
Click Add .
In the Name field, type a unique call routing name. This name appears in your list of entries on the Call Routing page.
To add phone numbers to associate with the configuration, do the following:
1. Under Addresses, click Add .
2. Type the complete telephone number string in numeric format only.
3. Click Submit.
Repeat step 5 to add more telephone numbers.
Click Save.

Configure flow routingClick to expand

To always route to a single flow, do the following:

Under Regular Routing, ensure that the Use Schedule Based Routing toggle is disabled.
Click the All Calls list, type the first few letters of the published flow that users enter when they dial the associated number or numbers, and select it from the list.
Click Save. A message appears, indicating that your entry saved. Your entry may take a few minutes to appear in the search results.

Note: Only flows previously published in Architect appear in this list. You cannot associate a call route configuration with an unpublished flow.

Learn moreClick to expand

Summary

Congratulations! You are now set up and ready to test your Google Cloud Dialogflow CX Agent with Genesys Cloud. You can now route interactions to a flow in Genesys Cloud Architect. You can also use the Google Cloud Dialogflow CX Agent associated with the Architect flow to steer interactions and set up escalation to a live agent in Genesys Cloud.

[NEXT] Was this article helpful?

Get user feedback about articles.

Loading...

Google Cloud Dialogflow CX quick start guide

Quick start steps

Step 1: Create the Google Cloud Dialogflow CX platform service account credential

Step 2: Obtain Google Cloud Dialogflow CX from the Genesys AppFoundry

Step 3: Configure and activate the Google Cloud Dialogflow CX integration

Step 4: Create a Genesys Cloud Architect flow and configure it with a Google Cloud Dialogflow CX bot

Step 5: Route a Genesys Cloud phone number to the flow

Summary

[NEXT] Was this article helpful?