Hangouts Chat

The Dialogflow Hangouts integration lets you create bots you can include in one-on-one chats as well as chat rooms. See the Hangouts Chat API docs for more information.

Set up

To set up and enable the Hangouts Chat integration, follow these steps:

  1. Click on Integrations in the left menu.
  2. Click on Hangouts Chat.
  3. Click the switch in the top right to enable the integration.
  4. Select one of the following access options:

    • Everyone in your own domain - Any member of your domain can talk to the agent.
    • Specific people or groups in your domain - A list is individuals and/or groups from your domain can talk to the agent.
    • Only me - Only you can talk to the agent.

  5. Choose which environment will serve your agent.

  6. Click START.

Configure your bot

Once your Hangouts Chat bot is created, you can change the details by clicking on the CONFIGURE BOT DETAILS button, on the integration pop-up. This will take you to Google Cloud Platform and you may need to enable the Hangouts Chat API.

These are the options available:

  • Bot Status - Change this to set your bot as LIVE or DISABLED.
  • Bot name - This name is used in messages, when searching, and for @ mentions.
  • Avatar URL - Image URL to the avatar for the bot.
  • Description - Description of the bot.
  • Functionality
    • Bot works in direct messages - Check to allow direct messages from users.
    • Bot works in rooms - Check to allow your bot to work in chat rooms.
    • Bot works in multi-person direct messages - Check to allow your bot to be added to multi-person chats.
    • Also receive messages in group messages and rooms that match regular expressions - Check to add regular expressions your bot will check prior to reciving a message.
  • Verification token - This displays the token sent with every request and can be used to verify where the request is coming from.
  • Permissions - Similar to the option available when first enabling the integration, this allows you to change who can access your bot.

Enable and configure in Google Cloud Console

The Hangouts integration can also be enabled through the Google Cloud Console, using the following steps:

  1. In the Google Cloud Console, click on the menu icon menu in the upper left hand corner.
  2. Click on APIs & Services then Dashboard.
  4. Search for "Hangouts chat".
  5. Click on the Hangouts Chat API tile.
  6. Click Enable.
  7. Specify bot name, avatar URL, and description.
  8. Click Save.


Before testing your bot, make sure you've started it (Step 6 in the Set up section)

To test your bot, follow these steps:

  1. Go to Hangouts Chat.
  2. Click into the Search field.
  3. Select Message a bot.
  4. Enter your bot name.
  5. Click Message.


Error Solution
Your administrator prevented you from talking to bots in direct messages. Ask your G Suite administrator to allow users to install bots.
Was this page helpful? Let us know how we did:

Send feedback about...

Dialogflow Documentation
Need help? Visit our support page.