Criar um app interativo do Google Chat
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, você encontra uma visão geral dos frameworks que podem ser usados para criar um
app interativo do Google Chat.
Com os apps de chat interativos, os usuários podem fazer o seguinte:
- Adicionar apps do Chat a espaços do Chat ou
mensagens diretas.
- Enviar ou receber mensagens de apps de chat.
- Solicite apps de chat com um comando.
- Visualizar links de um serviço ou sistema externo.
- Enviar informações para apps de chat, como inserir texto em uma caixa de diálogo ou mensagem de card.
Como os usuários descobrem e usam apps interativos do Chat
Os usuários podem descobrir e usar os apps do Chat publicados no
Marketplace de várias maneiras, incluindo:
- Pesquise e instale apps do Chat no Google Chat ou no
Marketplace.
- Interagir com um app do Chat adicionado a um espaço do Chat.
- Descobrir o app Chat no painel de mensagens diretas depois que um administrador do Google Workspace o instalou em nome do usuário.
Para começar a usar um app do Chat, os usuários do Google Chat podem
iniciar uma mensagem direta com o app ou adicioná-lo a um
espaço. Os usuários também podem adicionar o app Chat usando uma @menção. Para mais informações, consulte
Usar apps do Chat.
O exemplo a seguir mostra como um usuário @menciona um
app do Chat para adicioná-lo a um espaço:
Escolher uma estrutura para seu app de chat interativo
Para criar um app do Chat que interaja com os usuários, você
pode escolher entre as seguintes estruturas:
- Complemento do Google Workspace: permite estender outros aplicativos do Google Workspace e listar seu app de chat com outros tipos de apps no Google Workspace Marketplace.
Para saber mais, consulte Estender o Google Chat na documentação do complemento do Google Workspace.
- Evento de interação da API Chat: permite criar outros recursos, como uma página inicial do app Chat, e usar outras arquiteturas, como Pub/Sub e Dialogflow CX. Para saber mais,
consulte
Receber e responder a eventos de interação.
Para cada framework, a tabela a seguir mostra a documentação para configurar
e criar um app interativo básico do Chat para cada
arquitetura de app do Google Chat:
Criar recursos interativos
Para cada framework, a tabela a seguir mostra a documentação para
criar recursos interativos:
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-08 UTC.
[null,null,["Última atualização 2025-08-08 UTC."],[],[],null,["# Build an interactive Google Chat app\n\nThis page provides an overview of the frameworks that you can use to build an\ninteractive Google Chat app. \n\nInteractive Chat apps let users do any of the following:\n\n- Add Chat apps to Chat spaces or direct messages.\n- Send messages to or receive messages from Chat apps.\n- Prompt Chat apps with a command.\n- Preview links from an external service or system.\n- Submit information to Chat apps, such as entering text into a dialog or card message.\n\nHow users discover and use interactive Chat apps\n------------------------------------------------\n\nUsers can discover and use Chat apps published to the\nMarketplace in many ways, including the following:\n\n- Search and install Chat apps from Google Chat or the Marketplace.\n- Interact with a Chat app that's been added to a Chat space.\n- Discover the Chat app in their direct messages panel after a Google Workspace administrator installed the Chat app on their behalf.\n\nTo start using a Chat app, Google Chat users can\nstart a direct message with the Chat app or add it to a\nspace. Users can also add the Chat app by @mentioning\nit. For more information, see\n[Use Chat apps](https://support.google.com/chat/answer/7655820).\n\nThe following example shows how a user @mentions a\nChat app to add it to a space:\n\nChoose a framework for your interactive Chat app\n------------------------------------------------\n\nTo build a Chat app that interacts with users, you\ncan choose between the following frameworks:\n\n- **Google Workspace add-on** : Lets you extend other Google Workspace applications and list your Chat app with other types of apps on the Google Workspace Marketplace. To learn more, see [Extend Google Chat](/workspace/add-ons/chat) in the Google Workspace add-on documentation.\n- **Chat API interaction event** : Lets you build additional features such as a [Chat app homepage](/workspace/chat/send-app-home-card-message) and use other architectures such as Pub/Sub and Dialogflow CX. To learn more, see [Receive and respond to interaction events](/workspace/chat/receive-respond-interactions).\n\n### Configure an interactive Chat app\n\nFor each framework, the following table shows the documentation for configuring\nand creating a basic interactive Chat app for each\n[Google Chat app architecture](/workspace/chat/structure):\n\n| Configuration | Add-on | Chat API interaction events |\n|------------------------|-----------------------------------------------------------------|-----------------------------------------------------------------------------|---|\n| Configure the Chat API | [Documentation](/workspace/add-ons/chat/configure) | [Documentation](/workspace/chat/configure-chat-api) |\n| **Quickstarts** | |||\n| Apps Script | [Documentation](/workspace/add-ons/chat/quickstart-apps-script) | [Documentation](/workspace/chat/quickstart/apps-script-app) |\n| HTTP service | [Documentation](/workspace/add-ons/chat/quickstart-http) | [Documentation](/workspace/chat/quickstart/gcf-app) |\n| Dialogflow CX | Unavailable for add-ons. | [Documentation](/workspace/chat/build-dialogflow-chat-app-natural-language) |\n| Pub/Sub | Unavailable for add-ons. | [Documentation](/workspace/chat/quickstart/pub-sub) |\n\n### Build interactive features\n\nFor each framework, the following table shows the documentation for\nbuilding interactive features:\n\n| Feature | Add-on | Chat API interaction events |\n|---------------------------------------|------------------------------------------------------------------------|-------------------------------------------------------------|\n| Send messages | [Documentation](/workspace/add-ons/chat/send-messages) | |\n| Respond to commands | [Documentation](/workspace/add-ons/chat/commands) | [Documentation](/workspace/chat/commands) |\n| Build interactive dialogs | [Documentation](/workspace/add-ons/chat/dialogs) | [Documentation](/workspace/chat/dialogs) |\n| Collect and process information | [Documentation](/workspace/add-ons/chat/collect-information) | [Documentation](/workspace/chat/read-form-data) |\n| Preview links in Chat messages | [Documentation](/workspace/add-ons/chat/preview-links) | [Documentation](/workspace/chat/preview-links) |\n| Build a homepage for your Chat app | Unavailable for add-ons. | [Documentation](/workspace/chat/send-app-home-card-message) |\n| Connect to external systems and tools | [Documentation](/workspace/add-ons/guides/connect-third-party-service) | [Documentation](/workspace/chat/connect-web-services-tools) |\n\nRelated topics\n--------------\n\n- [Build a Google Chat app as a Google Workspace add-on](/workspace/add-ons/chat)\n- [Receive and respond to interaction events](/workspace/chat/receive-respond-interactions)\n- [Choose a Google Chat app architecture](/workspace/chat/structure)"]]
