Set up the Digital Assistant action for Google Assistant
You can deploy a Digital Assistant bot to the Google Assistant directory. Follow the below steps.
This requires for your Digital Assistant server to be publicly accessible. Learn more
1. Create a Google Assistant app project
Go to https://console.actions.google.com/ and click on Add/import project.
On the next screen enter a Project name and click on Create Project.
On the next page, just click Skip to not select any presets.
Now we should be on the overview page of our new project. Click on the cogwheel icon in the top left-hand corner and then Project settings.
Now take a note of your Project ID as it will be required in the next step.
2. Configuring Actions
We have prepared a configuration file. Download this from our Github repo.
Open the file and in
line 43, change the URL to match the Public Server URL of your Digital Assistant server, i.e.
3. Uploading Actions
To upload our modified configuration file we will need to use a command prompt (or Terminal on a Mac).
- Download the command line interface that's right for your platform from this Google website
- On a PC: Open
cmd promptas Administrator On a Mac: Open Terminal
- Point your command line interface to the folder that contains your file
chmod +x gactionsto make the binary file executable
- On a PC: Then enter
$ gactions update --action_package google.assistant.bot.action.json --project <Your-Google-Project-ID>On a Mac: Then enter
./gactions update --action_package google.assistant.bot.action.json --project <Your-Google-Project-ID>
<Your-Google-Project-ID>is the Project ID as noted under step 1
- You will now likely get the following message:
Gactions needs access to your Google account.... This means you need to follow the link to authenticate with Google and paste the code you are given back into the command line.
- If successful, your actions should have updated; but if not, just repeat step 5
Now we want to give our project an invocation name. So please go to Invocation and follow these steps:
- Enter a phonetic invocation phrase. This should be how a machine would hear your bot skill's name and not be stylized.
- Enter the title as it should be listed in the Google Assistant directory
- Click Save
To test if the connection is established we need to enable a testing mode in Digital Assistant.
- Go to
- Enter your Google email address (often ending in @gmail.com)
- Click the checkmark icon to save
Now we open the Simulator and select the Draft version of our app for testing. Say "Talk to Digital Assistant" to get started.
Your invocation name would be different if you have entered something else under step 4.
The expected response from Digital Assistant should be: "I'm sorry, I did not understand: Talk to Digital Assistant".
This means the connection is established, even though the response is non-sensical at this point.
6. Set up Digital Assistant for account linking
In order for Digital Assistant to accept requests by Google Assistant we need to set up a new API Client.
- Go to
- Enter a Name
- Enter a Title
- Click Save
7. Set up account linking with Google Assistant
Now we need to set up account linking on the Google side.
Click on Account linking
Select No, I only want to allow account creation on my website
Select OAuth from the dropdown
Select Authorization code
Paste value A
Paste value B
Paste value C
Paste value D
Enter testing instructions as to how Google can review your submission before it is entering their public directory.