Connecting to Dialogflow

Connecting a Dialogflow Agent to Rocketbots.

Connect to Dialogflow to Rocketbots is not that complicated. You will simply need to retrieve a JSON file from Google and upload it to the Rocketbots Platform.

Connecting Dialogflow (1-min video)

This guide will take you through generating and retrieving the Google Service Account Key (a JSON file) from your Dialogflow Agent.

Setting Up Dialogflow

To generate the account key, you will need to have the following:

If you already have an account on Dialogflow set up and an Agent ready, you can skip directly to connecting Dialogflow to Rocketbots. Otherwise, we will go over getting a Dialogflow Account and creating a Dialogflow Agent below.

Getting a Dialogflow Account

If you do not already have an account, visit the Dialogflow homepage and press "Go to Console" on the top right corner of the page. From here, you will be able to login to Dialogflow using your Google account.

Signing into Dialogflow

If this is your first time logging into Dialogflow, you will have to grant Dialogflow access to your Google account.

Granting Dialogflow Access to Your Google Account

Press the blue "Allow" button to grant Dialogflow access to your Google account.

Before you can access your account, you will need to select your country and accept the Dialogflow terms of service.

Setting Up a Dialogflow Account

Once you have completed the required fields, press the blue "Accept" button at the bottom to finish creating your account. This will take you to the Dialogflow dashboard.

Welcome to Dialogflow

You have now created your Dialogflow account and have logged into Dialogflow.

Creating a Dialogflow Agent

In Dialogflow, each NLP module is called an "Agent." The agent will act as the brain of your bot and is the component that will help your bot understand and classify human languages.

Once you log in to the dashboard, you can see your existing agents as well as an option to add new agents on the left navigation menu.

If you do not have an existing agent that you would like to use, go ahead and click on "Create Agent" to create a new agent.

Agent Creation on Dialogflow

You will have to give your new Dialogflow agent a name. Note that this will only be used internally on Dialogflow and will not be seen publically.

You can also select the main language that you will be using. Choose the language of your target audience. This will be used for Dialogflow's natural language processes. Other langages can be added later.

Select a timezone for your Dialogflow agent. It will be will be used for analytics purposes on Dialogflow.

Note that a new Google Cloud Project will be automatically created to the Dialogflow Agent when created. This will be used to connect your Agent to Rocketbots.

Once you are done filling in the information, select the blue "Create" button on the top right.

Connecting to Dialogflow

On the Rocketbots Platform, navigate to the Settings Module and scroll down to the Integrations section.

The Integrations Section

Press the blue "Connect" button next to the Dialogflow integration. This should open the Connect Dialogflow menu.

The Connect Dialogflow Menu

In order to integrate with your Dialogflow agent, you will have to retrieve the API key.

Getting the Account Key

On the Dialogflow dashboard, navigate to the Agent Settings by pressing the gear icon button on the left navigation panel. Make sure you have the agent you wish to connect selected.

Agent Settings on Dialogflow

From this page, click on the Service Account link under the Google Project section. This will open up a list of service accounts for your Agent's Google Cloud Project on the Google Cloud Platform.

The Service Accounts for Your Agent Project

Look for the entry with the name "Dialogflow Integrations" and press the Actions button on the far right of the table. Look for the three vertical dots.

The Create Key Option

Under the dropdown menu, select the "Create key" option. This should open up a menu where you can create a private key.

Creating a Private Key for Dialogflow Integration

Make sure the JSON key type is selected and press the blue "Create" button. Your computer should begin downloading the key as a JSON file.

When the download has completed, go back to the Rocketbots Platform and upload the API key JSON file in the Connect Dialogflow menu.

Once the file has been uploaded, press the blue "Connect" button to finish your integration.

Your Dialogflow Agent is now connected to the Rocketbots Platform. Your Agent will now respond to messages received from any of the channels on your Rocketbots Space.

To learn more about the advanced functionalities of the Dialogflow + Rocketbots integration, you can take a look at the following page: