Visão geral

Crie apps do Google Chat que levem seus serviços e recursos diretamente para o Google Chat, para 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 nos espaços.
  • Espaços de chat que permitem que você dedique um espaço de discussão por projeto, equipe ou outra base.
  • Apps de 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 acontecem usando mensagens no contexto de espaços específicos. Por exemplo, um app de chat pode enviar um texto (um tipo de mensagem) para um espaço específico do Chat.

As mensagens incluem interações com o app Chat, textos ou cards, enquanto 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 de chat seguem um formato de mensagem definido, em que cada mensagem consiste em um objeto JSON cujos componentes especificam o ID do usuário, o estilo, o conteúdo e outros aspectos da mensagem. Os apps de chat podem enviar os seguintes tipos de mensagens:

    • As mensagens de texto têm conteúdo de texto simples com formatação limitada.

    • As mensagens de card definem o formato, o conteúdo e o comportamento dos cards que vão ser 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 de um usuário.

      Use o Card Builder para criar e visualizar interfaces do usuário e mensagens de apps de chat:

      Abrir 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.
    • Uma mensagem direta só fica visível para o usuário nesse espaço.

Casos de uso

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

Essa capacidade de fornecer acesso a uma ampla gama de recursos e ferramentas, mantendo uma experiência cognitiva unificada, pode fornecer uma estrutura para muitos tipos de aplicativos, incluindo:

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

Confira alguns exemplos de coisas que você pode pedir a um app de chat no espaço do Chat:

  • Pesquisar informações: um app de chat pode recuperar informações com base em consultas estruturadas ou de texto livre inseridas pelo usuário.
  • Gerar tíquetes de arquivo: um app de chat pode gerar relatórios de incidentes ou outros artefatos usando informações fornecidas pelo usuário.
  • Coordenação de esforços: um app de chat pode melhorar a maneira como os membros da equipe interagem entre si, como fornecer "memória da equipe" ou agendar recursos.

Criar apps de chat

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

Para cada app de chat criado, você precisa criar um projeto do Google Cloud separado no console do Google Cloud. Para implantar e compartilhar seu app de chat com outros usuários, publique e liste-o no Google Workspace Marketplace. Para mais detalhes, consulte Criar e gerenciar implantações do seu app Chat.

Apps de chat interativo

Muitos apps de chat permitem que os usuários enviem mensagens e interajam com o app de chat diretamente. Os apps de chat interativo podem fazer o seguinte:

  • Responda a @menções, comandos de barra ou mensagens diretas com uma mensagem de texto ou de 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 interativo do Chat, consulte Receber e responder a eventos de interação do app do Google Chat.

Apps de chat não interativos

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

Apps de chat baseados em eventos

Um app do Chat pode se inscrever em eventos sobre recursos do Chat usando a API Google Workspace Events. Uma assinatura permite que o app do Chat receba informações sobre eventos, que representam mudanças em um recurso do Google Workspace assinado. Por exemplo, um app do Chat pode responder a mudanças em um espaço em que ele está inscrito, como enviar uma mensagem de boas-vindas para novos participantes adicionados ao espaço. Para mais informações, consulte Assinar eventos do Google Chat.

Escolher uma arquitetura de app de chat

A API Chat oferece várias maneiras de integrar seus apps aos espaços do Chat, mas não fornece nem determina uma maneira específica de implementar a lógica do app do Chat. É possível criar um app de chat orientado a comandos ou usar qualquer tipo de processamento de linguagem e serviços ou módulos de IA que você goste. Você pode fazer isso em várias plataformas, incluindo:

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

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

Acesso do app aos dados do usuário

Quando um app de chat é invocado, ele precisa saber quem está fazendo a invocação, em qual contexto e como se referir ao invocador. Para acessar dados além desses dados de identidade básicos, o app de chat precisa ter acesso por meio de autenticação.

  • Por padrão, os apps de chat só podem ler a identidade básica dos usuários que os invocam ou dos usuários que são mencionados na mesma mensagem que invoca o app. Essas informações incluem o nome de exibição, o ID, o endereço de e-mail e a imagem do avatar do usuário.

  • Para apps de chat que mostram uma prévia de links, o app de chat pode ler URLs adicionados à mensagem que correspondem aos padrões de URL configurados do app de chat.

  • Se um app de chat precisar acessar outros dados para oferecer recursos avançados aos usuários, como a leitura de todas as mensagens ou a lista de membros em um espaço, configure a autenticação para que ele possa acessar esses dados. Se o app de chat estiver acessando dados do usuário, ele vai pedir o acesso, e o usuário terá que conceder esse acesso. Saiba mais em Conectar um app de chat a outros serviços e ferramentas.

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