Esta página fornece uma visão geral de como criar complementos do Google Workspace que ampliam o Google Chat.
Os complementos do Google Workspace que ampliam o Chat podem ajudar os usuários a fazer qualquer uma das seguintes coisas:
- Visualize links em mensagens do Chat e execute ações sem sair da conversa.
- Automatize ou execute tarefas em vários aplicativos do Google Workspace.
- Receber alertas ou notificações sobre ferramentas ou serviços externos.
Como funcionam os complementos do Google Workspace no Chat
No Chat, os complementos aparecem para os usuários como aplicativos 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.
- Responder a comandos rápidos.
- Responder aos comandos barra.
- Abra dialogs para ajudar os usuários a concluir processos de várias etapas, como preencher dados de formulário.
- Links de pré-visualização em mensagens anexando cartões 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 funcionem 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 aplicativo de bate-papo e seus recursos interativos usando a API de bate-papo.
- Aprenda sobre as maneiras de criar interfaces de bate-papo usando gatilhos, ações e objetos de evento adicionais.
Limitações e problemas conhecidos
Os seguintes recursos de bate-papo 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 do Apps Script. Para usar ações de chat e criar cards, retorne objetos JSON. Por exemplo, consulte Abrir caixas de diálogo interativas e Prévia de links.
- Cartões de autorização personalizados. Para autenticar e conceder autorização ao seu serviço a partir do Chat, o aplicativo Chat deve retornar um cartão 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ó aparecerá na barra lateral dos outros aplicativos do Google Workspace que seu complemento estende.
- Páginas iniciais do aplicativo de bate-papo, que aparecem na guia Início de mensagens diretas com o aplicativo de bate-papo.
Se você estiver atualizando um complemento do Google Workspace, considere os seguintes requisitos de configuração para apps do Chat:
- OConfigurações de instalação do Google Workspace Marketplace Deve permitir que tanto usuários individuais quanto 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 ver 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 seus complementos forem publicados no Google Workspace Marketplace, você não poderá salvar um rascunho de nenhuma alteração.Configurações da API do Google Chat . Ao atualizar as configurações da API de Chat, o aplicativo de Chat atualizado fica imediatamente disponível para todos os usuários existentes. Para atualizar seu anúncio no Marketplace, você pode criar um rascunho antes de enviar quaisquer alterações.
Temas relacionados
- Visão geral da documentação da API do Google Chat
- Teste uma amostra: