Informações gerais

Crie apps do Google Chat que levem seus serviços e recursos diretamente para o Google Chat, permitindo que os usuários recebam informações e realizem ações sem sair da conversa.

O Google Chat oferece suporte à colaboração em equipe com os seguintes recursos:

  • Mensagens diretas entre usuários.
  • Conversas agrupadas em espaços
  • Espaços do Chat que permitem dedicar espaço de discussão por projeto, equipe ou outra base.
  • Apps do Chat que podem participar de espaços ou responder a mensagens diretas.

Mensagens e espaços

As interações entre o Google Chat e os apps do Chat ocorrem usando mensagens no contexto de espaços específicos. Por exemplo, um app do Chat pode enviar uma mensagem de texto (um tipo de mensagem) para um espaço específico do Chat.

As mensagens incluem interações, textos ou cards do app do Chat, e os espaços incluem salas de chat e mensagens diretas.

O diagrama anterior mostra os diferentes tipos de interações e contextos disponíveis para mensagens e espaços:

  • As mensagens entre o Google Chat e um app do Chat seguem um formato definido, em que cada uma consiste em um objeto JSON com componentes que especificam o ID do usuário, o estilo, o conteúdo e outros aspectos. Os apps de chat podem enviar estes tipos de mensagens:

    • As mensagens de texto contêm conteúdo de texto simples com formatação limitada.
    • As mensagens de cards definem o formato, o conteúdo e o comportamento dos cards a serem exibidos em um espaço. Por exemplo, uma mensagem de card pode incluir um botão com um link que abre uma caixa de diálogo para coletar informações do usuário.


      Crie e visualize cards com o Criador de cards.

      Abra o Criador de cards.

  • No Google Chat, os espaços podem ter os seguintes contextos:

    • Um espaço nomeado ou de grupo fica visível para vários usuários.
    • Ela só fica visível para o usuário no espaço.

Casos de uso

A adição de apps do Chat a uma plataforma de conversação como o Chat permite que as pessoas façam perguntas e emitam comandos sem mudar o contexto. No back-end, um app do Chat pode acessar outros sistemas, atuando como intermediário deles.

Essa capacidade de fornecer acesso a uma ampla variedade de recursos e ferramentas, mantendo uma experiência cognitiva unificada, pode fornecer um framework para muitos tipos de aplicativos, incluindo os seguintes:

  • Gerenciamento do fluxo de trabalho
  • Configuração
  • Geração de pedidos
  • Pesquisar
  • Coleta de dados

Alguns exemplos do que você pode pedir a um app do Chat no espaço do Chat:

  • Procurar informações: um app do Chat pode recuperar informações com base em consultas de texto estruturadas ou livres inseridas pelo usuário.
  • Tíquetes de arquivos: um app do Chat pode gerar relatórios de incidentes ou outros artefatos usando as informações fornecidas pelo usuário.
  • Coordenar os esforços: um app do Chat pode melhorar a maneira como os membros da equipe interagem uns com os outros, por exemplo, fornecendo "memória da equipe" ou agendando recursos.

Criar apps de chat

Esta seção explica alguns dos tipos de apps do Chat que podem ser criados.

Para cada app do Chat criado, é necessário criar um projeto separado do Google Cloud no console do Google Cloud. Para implantar e compartilhar seu app do Chat com outros usuários do Google Chat, publique e liste esses usuários no Google Workspace Marketplace. Para detalhes, consulte Criar e gerenciar implantações para seu app do Chat.

Apps interativos do Chat

Muitos apps do Chat permitem que os usuários enviem mensagens e interajam diretamente com ele. Os apps de chat interativos podem fazer o seguinte:

  • Responda a @menções, comandos de barra ou mensagens diretas com uma mensagem de texto ou card.
  • Abra uma caixa de diálogo para ajudar os usuários a concluir processos de várias etapas, como preencher dados de formulários.
  • Visualize links anexando cards com informações úteis que permitem que os usuários realizem ações diretamente na conversa.

Para interagir com os usuários, seu app do Chat precisa ser capaz de receber e responder a eventos de interação. Para criar um app do Chat interativo, consulte Receber e responder a eventos de interação no app do Google Chat.

Apps de chat não interativos

Os apps do Google Chat também podem ser não interativos quando os usuários não podem interagir diretamente com o app do Chat, mas ele chama a API Google Chat de forma direta. Por exemplo, você pode criar um app do Chat que envie uma mensagem em um espaço, mas os usuários não possam responder ao app do Chat. Esse tipo de arquitetura do app do Chat é útil para coisas como relatórios de alarme. Para mais informações, consulte a Visão geral da API Google Chat.

Apps do Chat orientados por eventos

Um app do Chat pode se inscrever em eventos sobre recursos do Chat usando a API Events do Google Workspace. Com uma assinatura, seu app do Chat pode receber informações sobre eventos, que representam alterações em um recurso do Google Workspace inscrito. Por exemplo, um app do Chat pode responder a mudanças em um espaço em que o app do Chat está inscrito, como enviar uma mensagem de boas-vindas a novos membros adicionados ao espaço. Confira mais informações em Inscrever-se em eventos do Google Chat.

Escolher uma arquitetura para o app do Chat

A API Chat oferece várias maneiras de integrar seus apps em espaços do Chat, mas não fornece ou ditam nenhuma maneira específica de implementar a lógica do app do Chat. É possível criar um app do Chat baseado em comando ou usar qualquer tipo de processamento de linguagem e serviços ou módulos de IA que você quiser. Isso pode ser feito em várias plataformas, incluindo as seguintes:

  • AppSheet
  • Google Apps Script
  • Pub/Sub
  • Google Cloud ou um servidor HTTP local

Para mais informações, consulte Escolher uma arquitetura de apps de chat.

Acesso do app aos dados do usuário

Quando um app do Chat é invocado, ele precisa saber quem o está invocando, em qual contexto e como abordar o invocador. Para acessar dados além desses dados básicos de identidade, o app do Chat precisa receber acesso por meio de autenticação.

  • Por padrão, os apps do Chat só podem ler a identidade básica dos usuários que os invocam ou usuários sendo @mencionados na mesma mensagem que invoca o app. Essas informações incluem o nome de exibição, ID do usuário, endereço de e-mail e imagem do avatar.
  • Apps do Chat que visualizam links podem ler os URLs adicionados à mensagem que correspondem aos padrões de URL configurados no app do Chat.

  • Se um app do Chat precisar acessar outros dados para fornecer recursos aprimorados aos usuários, como ler todas as mensagens ou a lista de membros em um espaço, configure a autenticação para que ele possa acessar esses dados. Ao acessar os dados do usuário, o app do Chat solicita que o usuário solicite o acesso, e o usuário precisa concedê-lo. Para saber mais, consulte Conectar um app do Chat a outros serviços e ferramentas.

Quer conferir a API Google Chat em ação?
O canal Google Workspace Developers tem vídeos com dicas, truques e recursos mais recentes.