Esta página oferece uma visão geral sobre como criar complementos do Google Workspace que estendem o Google Chat.
Os complementos do Google Workspace que estendem o Chat podem ajudar os usuários a fazer o seguinte:
- Visualizar links de mensagens do Chat e realizar ações sem sair da conversa.
- Automatizar ou realizar tarefas em 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 com texto, cards e elementos interativos da interface.
- 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 gatilhos, ações e objetos de evento de complementos.
Limitações e problemas conhecidos
Os seguintes recursos do Chat e complementos não estão disponíveis:
- As arquiteturas de apps de chat Dialogflow, Pub/Sub e AppSheet estão indisponíveis. Em vez disso, crie o app do Chat usando o Apps Script ou um serviço HTTP.
- Serviço de cardápio do Apps Script. Para usar ações de chat e criar cards, retorne objetos JSON. Para exemplos, consulte Abrir caixas de diálogo interativas e Visualizar links.
- Cards 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 para seu complemento, a página inicial só vai aparecer na barra lateral dos outros aplicativos do Google Workspace que seu complemento estende.
- Páginas iniciais dos apps do Chat, que aparecem na guia Início das 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 de 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 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 das mudanças nas configurações da API Google Chat. Quando você atualiza as configurações de configuração da API Chat, o app Chat atualizado fica imediatamente disponível para todos os usuários atuais. Para atualizar sua página de detalhes do Marketplace, crie um rascunho antes de enviar as mudanças.