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:
- Visualize links das mensagens do Chat e realize ações 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 com texto, cards e elementos de interface interativos.
- Responda a comandos rápidos.
- Responda 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ários.
- Visualize links nas mensagens anexando cards com informações úteis que permitem que os usuários realizem ações diretamente na conversa.
Primeiros passos
Para começar a criar complementos do Google Workspace que funcionam no Chat, consulte a documentação a seguir:
- 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 de chat e os recursos interativos dele usando a API Chat.
- Saiba como criar interfaces de chat usando gatilhos, ações e objetos de evento.
Limitações e problemas conhecidos
Os seguintes recursos de chat e complementos estão indisponíveis:
- Dialogflow e Pub/Sub. Você precisa criar complementos que estendem o Chat usando o Apps Script ou um serviço HTTP.
- Serviço de cartão do Apps Script. Para usar ações de chat e criar cards, retorne objetos JSON. Para conferir 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 pelo 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 gatilho da 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 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 do 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. - Se você estiver criando com um serviço HTTP, ative a
API Google Workspace Add-ons. Os recursos REST
deploymenteprojectse aplicam apenas a implantações de complementos em outros aplicativos do Google Workspace. - Para implantar e testar um complemento no Chat, use a configuração Visibilidade da API Chat. Todas as configurações de visibilidade ou teste que você configurou no SDK do Google Workspace Marketplace são ignoradas. Para implantar uma versão de teste do complemento no Chat, consulte Testar recursos interativos em apps do Google Chat na documentação da API Chat.
- Se os seus complementos forem publicados no Google Workspace Marketplace, não será possível salvar um rascunho de mudanças nas configurações da API Chat do Google. Quando você atualiza as configurações da API Chat, o app atualizado fica disponível imediatamente para todos os usuários. Para atualizar sua listagem do Marketplace, crie um rascunho antes de enviar as mudanças.