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:
- Envie mensagens com texto, cards e elementos interativos da interface.
- Mostrar uma página inicial na guia Início das mensagens diretas individuais com o app Chat.
- Responder a comandos rápidos.
- Responder a comandos de barra.
- Abra 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 aos usuários realizar ações diretamente da conversa.
Primeiros passos
Para começar a criar complementos do Google Workspace que funcionam no Chat, consulte a seguinte documentação:
- Confira 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 como 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 do complemento não estão disponíveis:
- AppSheet A arquitetura do app de chat não está disponível. Em vez disso, crie o app do Chat usando um serviço HTTP, Apps Script, Dialogflow ES ou Dialogflow CX, ou Pub/Sub.
- Cartões de autorização personalizados. Para autenticar e conceder autorização ao seu serviço no Chat, o app precisa retornar um card de autorização básica.
- Páginas iniciais de complementos na barra lateral do Chat. Se você configurou um gatilho de página inicial no manifesto, a página inicial só vai aparecer na barra lateral dos outros aplicativos do Google Workspace que o complemento estende. Em vez disso, você pode configurar uma página inicial para o Chat que aparece na guia Início das mensagens diretas com o app 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
(
addons.common) do complemento 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 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 do Chat, o app do Chat atualizado fica disponível imediatamente para todos os usuários atuais. Para atualizar suas informações do produto no Marketplace, crie um rascunho antes de enviar qualquer mudança.
Temas relacionados
- Visão geral da documentação da API 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