Esta página oferece uma visão geral de como criar complementos do Google Workspace que estendem o Google Chat.
Os complementos do Google Workspace que ampliam o Chat podem ajudar os usuários a fazer o seguinte:
- Visualizar links de mensagens do Chat e tomar medidas sem sair da conversa.
- Automatizar ou realizar tarefas nos aplicativos do Google Workspace.
- Receber alertas ou notificações sobre ferramentas ou serviços externos.
Como os complementos do Google Workspace funcionam no Chat
No Chat, os complementos aparecem para os usuários como apps do Google Chat. Para interagir com os usuários, os apps do Chat podem fazer o seguinte:
- Enviar mensagens que contêm texto, fichas de informações e elementos interativos da interface.
- Responder a comandos rápidos.
- Responder a comandos de barra.
- Abrir caixas de diálogo para ajudar os usuários a concluir processos de várias etapas, como preencher dados de formulário.
- Visualizar links em mensagens anexando cards com informações úteis que permitem que os usuários tomem medidas diretamente na conversa.
Primeiros passos
Para começar a criar complementos do Google Workspace que funcionam no Chat, consulte a seguinte documentação:
- Teste um guia de início rápido para criar um app básico do Chat usando o Google Apps Script ou um serviço HTTP.
- Configure um app do Chat e os recursos interativos dele usando a API Chat.
- Saiba mais sobre as maneiras de criar interfaces do Chat usando acionadores, ações e objetos de evento de complementos.
Limitações e problemas conhecidos
Os seguintes recursos do Chat e de complementos não estão disponíveis:
- AppSheet Em vez disso, crie o app do Chat usando um serviço HTTP, Apps Script, Dialogflow ES ou Dialogflow CX, ou Pub/Sub.
- Cards de autorização personalizados. Para autenticar e conceder autorização ao seu serviço no Chat, o app do Chat precisa retornar um card de autorização básico.
- Páginas iniciais de complementos na barra lateral do Chat. Se você configurou um acionador de página inicial para o complemento, a página inicial só vai aparecer na barra lateral dos outros aplicativos do Google Workspace que o complemento estende.
- Páginas iniciais do app do Chat, que aparecem na guia Início de mensagens diretas com o app do Chat.
Se você estiver atualizando um complemento do Google Workspace, 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 do complemento
(
addons.common) são ignoradas no Chat. Para configurar o complemento para funcionar no Chat, ative e configure a API Chat. Para conferir as etapas, consulte Configurar um app do 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 na documentação da API Chat.
- Se os complementos forem publicados no Google Workspace Marketplace, não será possível salvar um rascunho de nenhuma mudança nas configurações de configuração da API Google Chat. Ao atualizar as configurações de configuração da API Chat, o app do Chat atualizado fica disponível imediatamente para todos os usuários atuais. Para atualizar a listagem do Marketplace, você pode criar um rascunho antes de enviar as mudanças.
Temas relacionados
- Visão geral da documentação da API Google Chat
- Teste uma amostra:
- Agende reuniões pelo Google Chat
- Integrar conceitos básicos de IA aos apps do Chat
- Planejar viagens com um agente de IA acessível no Google Workspace
- Criar agentes do Gemini Enterprise que são integrados aos repositórios de dados, APIs e apps do Chat do Workspace
- Criar agentes da Vertex AI que são integrados aos repositórios de dados, APIs e apps do Chat do Workspace