Esta página oferece uma visão geral de como criar um app interativo do Google Chat. Os apps interativos do Chat são criados como complementos do Google Workspace que estendem o Google Chat.
Com os apps de chat interativos, os usuários podem fazer o seguinte:
- Adicione apps do Chat a espaços do Chat ou mensagens diretas.
- Enviar ou receber mensagens de apps de chat que contêm texto, cards e elementos interativos da interface.
- Veja e interaja com um card da página inicial do app na guia Início das mensagens diretas individuais com o app Chat.
- Envie comandos para apps de chat com comandos de barra, comandos rápidos ou ações de mensagem.
- Visualizar links de mensagens do Chat e tomar medidas sem sair da conversa.
- Enviar informações para apps de chat, como inserir texto em uma caixa de diálogo ou mensagem de card.
- Automatizar ou realizar tarefas nos aplicativos do Google Workspace e conectar a ferramentas ou serviços externos.
Como os usuários descobrem e usam apps interativos do Chat
No Chat, os complementos que ampliam o Chat aparecem para os usuários como apps do Google Chat. Os usuários podem descobrir e usar apps de 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 instala o app 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 do 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:
Primeiros passos
Para começar a criar um app interativo do Chat, consulte a documentação a seguir:
- Configure a API Google Chat e ative recursos interativos para seu app Chat.
- Saiba como receber e responder a interações do usuário usando acionadores, objetos de evento e ações.
- Teste um guia de início rápido para criar um app básico do Chat para sua arquitetura de app do Google Chat preferida.
Configurar e criar um app do Chat básico
A tabela abaixo lista a documentação para configurar a API Chat e criar um app básico de chat interativo para cada arquitetura de app do Google Chat:
| Arquitetura ou tarefa | Guia |
|---|---|
| Configurar a API Chat | Configurar a API Google Chat |
| Guias de início rápido | |
| Apps Script | Criar um app do Chat com o Apps Script |
| Serviço HTTP (Cloud Run Functions) | Criar um app de chat HTTP |
| Pub/Sub | Criar um app de chat com o Pub/Sub |
| Dialogflow CX | Criar um app de chat do Dialogflow CX |
| Dialogflow ES | Criar um app de chat do Dialogflow ES |
| Agente de IA do Kit de Desenvolvimento de Agente (ADK) | Criar um app de chat com um agente de IA do ADK |
| Agente de IA Agent2Agent (A2A) | Criar um app de chat de agente de IA A2A |
| Agente de IA A2UI | Criar um app de chat com um agente de IA A2UI |
| Agente de IA do Gemini Enterprise | Criar um app de chat de agente de IA do Gemini Enterprise |
Criar recursos interativos
A tabela a seguir mostra a documentação para criar recursos interativos do app de chat:
| Recurso | Guia |
|---|---|
| Receber e responder a interações do usuário | Receber e responder a interações do usuário |
| Enviar mensagens (responder a interações ou enviar proativamente) | Responder com uma mensagem ou Enviar uma mensagem usando a API Chat |
| Responder a comandos de barra, comandos rápidos e ações de mensagens | Responder a comandos |
| Criar caixas de diálogo interativas | Abrir caixas de diálogo interativas |
| Coletar e processar informações de cards e caixas de diálogo | Ler dados de formulários inseridos pelos usuários em cards |
| Visualizar links em mensagens do Chat | Links de prévia |
| Criar uma página inicial (página inicial do app) em mensagens diretas individuais | Criar uma página inicial para um app do Chat |
| Conectar a sistemas e ferramentas externos | Conectar um app de chat a outros serviços e ferramentas |
Limitações e considerações sobre os complementos do Google Workspace
Como os apps do Chat são criados como complementos do Google Workspace que ampliam o Chat, lembre-se das seguintes limitações de recursos:
- A arquitetura do app do Chat do AppSheet não está disponível ao criar como um complemento do Google Workspace. Em vez disso, crie o app de chat usando um serviço HTTP, Apps Script, Dialogflow ES, Dialogflow CX, ou Pub/Sub.
- Não há suporte para cards de autorização personalizados no Chat. Para autenticar e conceder autorização ao seu serviço no Chat, o app precisa retornar um card de autorização básica.
- As páginas iniciais de complementos na barra lateral do Chat não são compatíveis. Se você configurou um
gatilho de página inicial no
manifesto (
addons.common.homepageTrigger), a página inicial só vai aparecer na barra lateral dos outros aplicativos do Google Workspace que seu complemento estende. Em vez disso, você pode criar uma página inicial para um app do Chat que aparece na guia Início das mensagens diretas individuais com o app do Chat.
Se você estiver estendendo um complemento do Google Workspace para funcionar no Chat, considere os seguintes requisitos de configuração para apps do Chat:
- As configurações de instalação do Google Workspace Marketplace precisam permitir que indivíduos e administradores do Google Workspace instalem o complemento.
- Todas as configurações comuns no manifesto (
addons.common) do complemento são ignoradas no Chat. Para configurar o complemento para funcionar no Chat, você precisa ativar e configurar a API Chat. Para conferir as etapas, consulte Configurar a API Google Chat. - Para implantar e testar um complemento no Chat, use a configuração de Visibilidade da API Chat. Todas as configurações de visibilidade ou teste configuradas no SDK do Google Workspace Marketplace são ignoradas. Para implantar uma versão de teste do complemento no Chat, consulte Testar recursos interativos para apps do Google Chat.
- Se o complemento estiver publicado no Google Workspace Marketplace, não será possível salvar um rascunho de mudanças nas configurações da API Google Chat. Quando você atualiza as configurações de configuração da API Chat, o app atualizado fica disponível imediatamente para todos os usuários atuais. Para atualizar suas informações do produto no Marketplace, você pode criar um rascunho antes de enviar qualquer mudança.
Temas relacionados
- Visão geral da documentação da API Google Chat
- Receber e responder a interações do usuário
- Escolher uma arquitetura de app do Google Chat
- Teste uma amostra:
- Agendar reuniões pelo Google Chat
- Integrar conceitos básicos de IA aos apps do Chat
- Planejar viagens com um agente de IA acessível em todo o Google Workspace
- Crie agentes do Gemini Enterprise que são totalmente integrados aos repositórios de dados, APIs e apps de chat do Workspace
- Crie agentes da Vertex AI que sejam totalmente integrados aos repositórios de dados, APIs e apps de chat do Workspace
Apps do Chat que não são complementos: crie um app interativo do Google Chat
Os apps do Chat que não são complementos do Google Workspace são criados como
apps somente para o Chat que recebem
eventos de interação da API Chat (Event)
em vez de
objetos de evento de complementos do Google Workspace (EventObject)
e ações.
Se você mantém um app do Chat que não é um complemento, é possível:
- Converter seu app do Chat que não é um complemento em um complemento do Google Workspace que estende o Google Chat. Consulte Converter um app do Google Chat em um complemento do Google Workspace.
- Consulte as seções expansíveis Apps de chat que não são complementos na parte de baixo de cada guia de recursos interativos neste conjunto de documentação para formatos de solicitação e resposta.