To add Google Assistant channel to your Bot, you will need to build a project in ‘Actions on Google’, link it to an agent in Dialogflow, configure actions and enable fulfillment using webhook integration.
- Do ensure that your dialog tasks contain Bot Message node as the last node only
- Alert task notifications are currently not supported
- Some of the Hold & Resume options with explicit messages to the user will not work
- Task execution will not be automatically resumed when users provide authorization using web forms. After providing authorization, users have to re-initiate the task.
- Web form based responses are not supported for Action, Information, and Alert tasks.
To add Google Assistant channel to your bot, you need to:
- Create Actions on Google Project- To enable Google Assistant channel to your Kore.ai bot, create a project on ‘Actions on Google’ Console and add all the required details.
- Define Actions – To define actions, you will need to add an action to your project.
- Create Agent in Dialogflow – You will need to create an agent in your Dialogflow Console.
- Enable Fulfillment – You will need to configure a Webhook integration between your Dialogflow agent and Kore.ai bot to enable Fulfillment.
- Test using Simulator – Once all the configurations are done, you need to test your actions using the built-in Simulator on ‘Actions by Google’ console.
- Deploy and Release – When you have configured the integration and tested your bot, you will need to deploy your bot for making it available to potential users.
- Enable Channel – After completing integration setup and entering the configuration details in the Bot builder, you need to enable the channel.
To add the Google Assistant channel
To complete this procedure, you must have or register for a new account in the ‘Actions on Google’ Console.
- Select the bot to enable the Google Assistant Channel. On the Channels tab, select the Google Assistant channel.
- In a new browser tab, login to Actions on Google Console, click on Go To Actions Console and click on Add/import project. Provide all the details in the required fields and click on Create Project.
- After your project is created, you would be redirected to the project page. Here, you can optionally select a category for your project or skip and proceed to project’s Overview page.
- On the Overview page, proceed to Modify Languages option and update languages in which your Actions will be displayed.
- Now proceed to Invocation option on the left navigation bar. Provide a name that users would use to invoke your actions. You may review other options available.
- Actions are the tasks that you intend your project to fulfill. Click on Actions option on the left navigation bar and click on Add Your First Action. A new popover screen with options to either build a custom intent or to choose built-in intents is displayed. Choose an appropriate option as per your requirement.
- Actions on Google will redirect you to Dialogflow application for defining the action definition. If you are new to Dialogflow, you would be requested to register on Dialogflow. Once your Dialogflow account is set up, you would be redirected to Console of Dialogflow to create a new Agent. Click on Create button to complete the creation of new agent.
- Once your agent is created, click on Intents option on the left navigation bar. Dialogflow will add two intents by default viz. Default Fallback Intent and Default Welcome Intent. Default Fallback Intent is used to respond to any user input that does not match any of the other intents defined in the intent. Default Welcome Intent is used to respond the user on the first input. If no other intent is created in Dialogflow, these two intents will be used to address all user inputs.
- As you expect your Kore.ai bot to fulfill all your user requests, you would need to turn on Webhook call for both these intents. Once enabled, Dialogflow will route all user requests reaching any of these two intents to your Kore.ai bot.
- Select Default Fallback Intent to open the intent details and navigate to the end of the page. Under Fulfillment section, turn on the toggle switch for Enable webhook call for this intent option. Click on Save to update your changes.
- Navigate back to the Intents option from the left navigation bar, select Default Welcome Intent to open the intent details and navigate to the end of the page. Under Fulfillment section, turn on the toggle switch for Enable webhook call for this intent option. Click on Save to update your changes.
- To configure the webhook integration between your Dialogflow agent and Kore.ai bot, click on Fulfillment option on the left navigation bar and enable Webhook toggle switch.
- Navigate to Configurations tab of Google Assistant channel page on the builder, copy the Webhook URL provided there and update it in the URL field in Fulfillment section of Dialogflow.
- Navigate to Configurations tab of Google Assistant channel page on the builder and copy the Access Token. This token should be added as header key in Dialogflow Fulfillment screen. Under Webhook option of Fulfillment section, add key as Access-token and update the copied access token as the value for this key.
- Navigate to the end of the page and click Save.
- Your configurations to enable the channel are all set up now. Actions on Google provides a built-in simulator to test your bot. For this, you would have to first enable few additional options of your Google account’s Activity Controls as per the details provided here.
- After you configure these controls, navigate to your project on Actions on Google and click on Simulator option in the left navigation bar. Select the required version of your actions and then click on Start Testing to begin testing your actions.
- Once you have configured the integration and tested your bot, you have to deploy your bot for making it available to potential users. Proceed to Deploy section on the left navigation bar and furnish all the required information and submit for release by clicking on Submit for Production button. Your action will be available on Google Assistant Explore only after your release submission is approved.
- Proceed to Configurations tab on the Google Assistant channel page to continue with the channel setup process.
Editing the Google Assistant Channel
To edit the Google Assistant channel, hover your mouse over the channel and click to modify. You can make the necessary updates to your channel configurations and save them. You may also disable or delete the channel information by clicking the Settings icon.
Select one of the following commands to modify the channel:
- Disable/Enable – Click Disable to temporarily disable use of the Google Assistant channel for your Bot.To enable use of the Google Assistant channel, Click Enable.
- Delete – Click Delete, and then click OK in the Delete Confirmation dialog to permanently delete the Bot channel configuration.