Allow users to install Chat apps

You can use Chat apps in spaces or direct messages to connect to services in Google Chat and look up information, schedule meetings, or complete tasks. Apps 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 apps

When you interact with an app in Chat, the app can see your email address, avatar, other basic user information, user locale, timezone, and interaction information. The app 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 app. 

Chat apps that you install from the Google Workspace Marketplace can be made by developers from outside of your organization. If you are using third-party apps, review each developer's Terms of Service and privacy policy for more information about third-party use of your data.

Granting Chat app permissions

Some Chat apps are able to access user’s data and perform actions on their behalf, like creating Chat spaces and adding people to them. These apps ask users for permission to access their data and work on their behalf with OAuth scopes, which give the apps permission to access specific data or do specific tasks.

To learn more about integrating Chat apps and other Workspace apps, see Integrate 3rd-party and custom apps.

To learn more about how Chat app developers configure authentication and authorization, see Authenticate and authorize Chat apps and API requests.

Allow apps in Chat

Step 1: Let users install apps in Chat
  1. Sign in to your Google Admin console.

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

  2. In the Admin console, go to Menu ""and then"" Appsand thenGoogle Workspaceand thenGoogle Chat.
  3. Click Chat apps.
  4. To apply the setting to everyone, leave the top organizational unit selected. Otherwise, select a child organizational unit or a configuration group.

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

  5. Under Allow users to install Chat apps, 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 apps 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 apps in Chat.
To decide what bots users can install, follow the steps in Hide or show Google Workspace Marketplace apps to your users.
Step 3: Add Marketplace apps to your allowlist (Optional)
If you allow apps for your organization and use an allowlist for apps or block users from seeing apps in the Google Workspace Marketplace, users can still install apps for personal use. Developers can use the Chat API to publish apps that are not on the allowlist for up to 5 users. To restrict personal use of apps in your organization, you have to restrict users from installing all apps.
  1. Sign in to your Google Admin console.

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

  2. In the Admin console, go to Menu ""and then"" Appsand thenGoogle Workspace Marketplace appsand thenApps list.
  3. Click Google Workspace Marketplace allowlistand thenAdd app to allowlist.
  4. In the search box, enter the name of the app that you want to add. For example, Google Drive app in Google Chat.

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

  5. Next to the app, click Add to allowlist.

Restrict all apps in Chat

Note: Turning off Allow users to install Chat apps disables all app usage, including personal app use.

  1. Sign in to your Google Admin console.

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

  2. In the Admin console, go to Menu ""and then"" Appsand thenGoogle Workspaceand thenGoogle Chat.
  3. Click Chat apps.
  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 apps, 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. In the Admin console, go to Menu ""and then"" Appsand thenGoogle Workspaceand thenGoogle Chat.
  3. Click Chat apps.
  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
false
false
true
73010
false
false