Get started: Chat setup guide for admins

Allow users to install bots

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. Bots are accounts created by Google, users in your organization, or third parties.

You can also use webhooks to integrate your organization's existing workflows in Chat. 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.

If you use third-party bots...

Bots that you install from the Google Workspace Marketplace can be made by developers from outside of your organization. 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.

Allow bots in Chat

Step 1: Let users install 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 thenGoogle Workspaceand 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.

    Note: Bots must be turned on for the top organizational unit to work with the Chat API.

  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.
Step 2: Decide what bots users can install
Note: If you let users install apps from the Google Workspace Marketplace, they can install any app that you allow even if they can't install 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 thenGoogle Workspace Marketplace apps.
  3. Click Settings and choose an option:
    • To let users install any app, click Allow users to install any application from Google Workspace Marketplace.
    • To let users install only apps that you allow, click Allow users to install only whitelisted applications from Google Workspace Marketplace.
  4. Click Save.
Step 3: Add Marketplace apps to your allowlist (Optional)
If you allow bots for your organization and use an allowlist for bots or block users from seeing apps in the Google Workspace Marketplace, users can still install bots for personal use. Developers can use the Chat API to publish bots that are not on the allowlist for up to 5 users. To restrict personal use of bots in your organization, you have to restrict users from installing all bots.
  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 thenGoogle Workspace Marketplace apps.
  3. Click Google Workspace Marketplace whitelistand thenAdd app to whitelist.
  4. 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.

  5. Point to the bot that you want to add and click Add To Whitelist.
Note: You don't need to add the classic Hangouts bot to the allowlist. It's automatically available in all organizations.

Restrict all bots in Chat

Note: Turning off Allow users to install chat bots disables all bot usage, including personal bot use.

  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 thenGoogle Workspaceand 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.

Let users add and use webhooks in Chat

To use webhooks in your organization, users need to be able to configure them in Chat. 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 your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Appsand thenGoogle Workspaceand 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?

Need more help?

Sign in for additional support options to quickly solve your issue