Integrating BotDistrikt and Dialogflow is easy. You will simply need to retrieve a JSON file from Google and upload it to the BotDistrikt Platform.
To generate the account key, you will need to have the following:
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.
If this is your first time logging into Dialogflow, you will have to grant 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.
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.
You have now created your Dialogflow account and have logged into Dialogflow.
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.
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 publicly.
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 BotDistrikt.
Once you are done filling in the information, select the blue "Create" button on the top right.
On the BotDistrikt Platform, navigate to Integrations and scroll down to the Dialogflow Card
In order to integrate with your Dialogflow agent, you will have to retrieve the API 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.
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.
Click on the IAM link on the left sidebar and this open a list of all access accounts on your Agent's Google Cloud Project on the Google Cloud Platform
Look for the entry with the name "Dialogflow Integrations" and press the pencil ✏️ button on the far right of the table.
This will open up a right-sidebar. Change the Role type from "Dialogflow API Client" to "Dialogflow API Admin"
Once done, click on Save.
Now click on Service Accounts on the left sidebar and you will be shown your service accounts
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.
Under the dropdown menu, select the "Create key" option. This should open up a menu where you can create a private key.
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 BotDistrikt Platform and upload the API key JSON file in the Dialogflow Card to finish your integration.
Your linked card should look something like this