Get started: Chat setup guide for admins

Allow users to install bots

Bots are accounts created by Google, users in your organization, or third parties. You can use bots in rooms or direct messages to connect to services in Google Chat and look up information, schedule meetings, or complete tasks.

When you start a message with a third-party bot, the third party can see your basic information, the message sent to the bot, and other contextual data. Review each developer's Terms of Service and privacy policy for more information about third-party use of your data.

Control bot use in your organization

To control the use of bots in your organization, you have these options:

  • Restrict all bots.
  • Let users install and use any bots from the G Suite Marketplace, including bots created by Google (such as @meet and @drive). Users can also install bots created by people in your organization.
  • Let users install and use only the bots you choose and place in an allow list. The allow list can also control bots created by users in your organization only if they're published to the G Suite Marketplace.

If you allow bots for your organization, but you use an allow list for bots or block users from seeing apps in the G Suite Marketplace, users can still install bots for personal use. Developers can use the Chat API to publish bots that are not on the allow list for up to 5 users. To restrict personal use of bots in your organization, you have to restrict users from installing all bots.

Restrict all bots in Chat

  1. Sign in to your Google Admin console.

    Sign in using an account with super administrator privileges (does not end in @gmail.com).

  2. From the Admin console Home page, go to Appsand thenG Suiteand thenGoogle Chat and classic Hangouts.
  3. Click Chat Bots.
  4. To apply the setting to everyone, leave the top organizational unit selected. Otherwise, select a child organizational unit or a configuration group.
  5. Under Allow users to install chat bots, select Off.
  6. Click Save. If you configured an organizational unit or group, you might be able to Inherit or Override a parent organizational unit, or Unset a group.

Note: Turning off Allow users to install chat bots disables all bot usage, including 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 thenGoogle Chat and classic Hangouts.
  3. Click Chat Bots.
  4. To apply the setting to everyone, leave the top organizational unit selected. Otherwise, select a child organizational unit or a configuration group.
  5. Under Allow users to install chat bots, select On.
  6. Click Save. If you configured an organizational unit or group, you might be able to Inherit or Override a parent organizational unit, or Unset a group.
  7. At the top left, click Menu "" and point to Apps.
  8. Click G Suite Marketplace Appsand thenSettings.
  9. Select Allow visibility of all apps in G Suite Marketplace.
  10. Click Save.

Allow only bots that you approve

  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 Suite Marketplace apps.
  3. At the top, click Settings.
  4. Select Allow users to install only whitelisted applications from G Suite Marketplaceand thenclick Save.
  5. To add bots to the allow list, click Manage whitelistand thenAdd app to whitelist.
  6. In the search box, enter the name of the bot that you want to add.

    Important: For the bot to appear in search results, enter the full name. For example, Google Drive bot.

  7. Point to the bot that you want to add and click Add To Whitelist.
  8. At the top, click Settings.
  9. Click Save.

Note: You don't need to add the classic Hangouts bot to the allow list. It's automatically available in all organizations.

Turn on incoming webhooks in Chat

Use incoming webhooks to send one-way messages to rooms or direct messages without using bots. For example, you might use webhooks to send an alert if there are server issues or if you add a new employee to your corporate directory.

Webhooks can't read other chat messages. Only users in your organization can create webhooks.

  1. Sign in to your Google Admin console.

    Sign in using an account with super administrator privileges (does not end in @gmail.com).

  2. From the Admin console Home page, go to Appsand thenG Suiteand thenGoogle Chat and classic Hangouts.
  3. Click Chat Bots.
  4. To apply the setting to everyone, leave the top organizational unit selected. Otherwise, select a child organizational unit or a configuration group.
  5. Under Allow users to add and use incoming webhooks, select On.

    This setting applies to all incoming webhooks. 

  6. Click Save. If you configured an organizational unit or group, you might be able to Inherit or Override a parent organizational unit, or Unset a group.

Related topics

Was this helpful?
How can we improve it?