Extend Google Chat (original) (raw)
Extend Google Chat
This page provides an overview about how to build Google Workspace add-ons that extend Google Chat.
Google Workspace add-ons that extend Chat can help users do any of the following:
- Preview links from Chat messages, and take action without leaving the conversation.
- Automate or perform tasks across Google Workspace applications.
- Receive alerts or notifications about external tools or services.
How Google Workspace add-ons work in Chat
In Chat, add-ons appear to users as Google Chat apps. To interact with users, Chat apps can do the following:
- Send messages that contain text, cards, and interactive UI elements.
- Respond to quick commands.
- Respond to slash commands.
- Open dialogs to help users complete multi-step processes, like filling in form data.
- Preview links in messages by attaching cards with helpful information that let users take action directly from the conversation.
Get started
To start building Google Workspace add-ons that work in Chat, see the following documentation:
- Try a quickstart to build a basic Chat app usingGoogle Apps Script or an HTTP service.
- Configure a Chat appand its interactive features using the Chat API.
- Learn about the ways you canbuild Chat interfacesusing add-on triggers, actions, and event objects.
Limitations and known issues
The following Chat and add-on features are unavailable:
- The Chat app architecturesDialogflow,Pub/Sub, andAppSheet are unavailable. Instead, you must build the Chat app using Apps Script or an HTTP service.
- Apps Script'sCard Service. To useChat actionsand build cards, return JSON objects instead. For examples, seeOpen interactive dialogs andPreview links.
- Custom authorization cards. To authenticate and grant authorization to your service from Chat, the Chat app must return a basic authorization card.
- Add-on homepagesin the Chat sidebar. If you've configured ahomepage trigger for your add-on, the homepage only appears in the sidebar of the other Google Workspace applications that your add-on extends.
- Chat app homepages, which appear in the Home tab of direct messages with the Chat app.
If you're updating an existing Google Workspace add-on, consider the followingconfiguration requirementsfor Chat apps:
- TheGoogle Workspace Marketplace installation settingsmust permit both individuals and Google Workspace administrators to install the add-on.
- Any common configuration settings in the add-on'smanifest(
addons.common) are ignored in Chat. To configure the add-on to work in Chat, you must enable and configure the Chat API. For steps, seeConfigure a Google Chat app. - To deploy and test an add-on in Chat, you must use the Chat API's Visibility setting. Any visibility or testing settings that you've configured in the Google Workspace Marketplace SDK are ignored. To deploy a test version of the add-on in Chat, seeTest interactive features for Google Chat appsin the Chat API documentation.
- If your add-ons is published to the Google Workspace Marketplace, you can't save a draft of any changes to theGoogle Chat API configuration settings. When you update Chat API configuration settings, the updated Chat app is immediately available to all existing users. To update your Marketplace listing, you cancreate a draftbefore submitting any changes.
- Google Chat API documentation overview
- Try a sample:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-05 UTC.