Get started: Chat setup guide for admins

Allow users to install bots

Bots are special accounts you can chat with, just as you would with people. Bots provide a conversational way for you to connect to services in Hangouts Chat, such as looking up information, scheduling meetings, or doing tasks. Bots can be created by Google, users in your domain, or third parties.

For information on creating custom bots for your organization, go to the Hangouts Chat API documentation.

Note: When starting a message with or talking to third-party bots, your user’s basic information, the message sent to or @ mentioning the bot, and other contextual data will be sent to the third party. Review each bot developer’s terms of service and privacy policy for more information about third-party use of your data.

Controlling bot use

You can control the use of bots in your organization. You have these options:

  • Disallow all bots.
  • Allow users to install and use any bots from G Suite Marketplace, including bots created by Google (such as @meet and @drive). They can also use bots created by users in your domain.
  • Allow users to install and use only the bots you choose and place in a whitelist. They can also use any bots created by users in your domain, which aren't controllable by the whitelist. Bots created by users in your domain are controllable by the whitelist if they've been published to G Suite Marketplace. Unwhitelisted bots can also be used as described in Personal bot use.

Allow all bots in Chat

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Appsand thenG Suiteand thenHangouts Chat.
  3. Click Bot Options.
  4. Under Organizational Units, select the domain or organizational unit you want to apply settings to.
  5. Check the Allow users to install and use bots box.
  6. Click Save.

Unchecking the Allow users to install and use bots box disables all bot usage, including personal bot use.

Allow bots from G Suite Marketplace

To allow users to install and use any bots from G Suite Marketplace, including bots created by Google:

  1. In the Google Admin console, go to Apps > Marketplace apps.
  2. Select Manage Apps, and click Manage Access to apps.
  3. Select Allow users to install any application from G Suite Marketplace.

To allow users to install and use whitelisted bots only:

  1. In the Google Admin console, go to Apps > Marketplace apps.
  2. Select Manage Apps, and click Manage Access to apps.
  3. Select Allow users to install only whitelisted applications from G Suite Marketplace.
  4. To add bots to the whitelist, click Manage whitelist.
  5. Click Add to display a list of available bots and apps.
  6. Search for the bot you want to add.
  7. Check the box next to the bots you want to add, then click Whitelist.
  8. Click Confirm.

Personal bot use

If you enable bots for your domain, and you select Allow users to install only whitelisted applications from G Suite Marketplace or Do not allow users to install any application from G Suite Marketplace, users can still install unwhitelisted bots for personal use. In this configuration, developers can still use the Hangouts Chat API to publish unwhitelisted bots, but only for a maximum of five users.

The only way to restrict the personal usage of bots in your domain is to uncheck the Allow users to install and use bots box.

Was this helpful?
How can we improve it?