Allow users to install Chat bots

You can use Chat bots in spaces 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.

Information available to bots

When you interact with a bot in Chat, the bot can see your email address, avatar, and other basic user information. The bot can also see the basic user information of other people in the Chat, but it can't see their email address or avatar unless they also interact directly with the bot. 

Bots that you install from the Google Workspace Marketplace can be made by developers from outside of your organization. If you are using third-party bots, 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 allowlistand thenAdd app to allowlist.
  4. In the search box, enter the name of the bot that you want to add. For example, Google Drive bot in Google Chat.

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

  5. Next to the app, click Add to allowlist.
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

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
true
73010
false