Visão geral

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

Para facilitar a colaboração em equipe, o Google Chat oferece 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 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 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, texto ou cards no app do Chat, 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 do Chat seguem um formato definido, em que cada mensagem consiste em um objeto JSON com componentes que 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 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.
  • 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 grande 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

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

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

Criar apps do Chat interativos

Muitos apps do Chat permitem que os usuários enviem mensagens e interajam diretamente com o app Chat. 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 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 da conversa.

Para interagir com os usuários, seu app do Chat precisa 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.

Criar apps do 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 envia uma mensagem em um espaço, mas os usuários não podem responder a ele. Esse tipo de arquitetura do app do Chat é útil para relatórios de alarme, por exemplo. Para mais informações, consulte a visão geral da API Google Chat.

Criar apps do Chat orientados a eventos

Um app do Chat pode se inscrever em eventos sobre recursos do Chat usando a API Google Workspace Events. Com uma assinatura, seu app do Chat pode receber informações sobre eventos, que representam mudanças em um recurso inscrito do Google Workspace. 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. Para mais informações, consulte Inscrever-se em eventos do Google Chat.

Escolher uma arquitetura de app do Chat

A API Chat oferece várias maneiras de integrar seus apps nos espaços do Chat, mas não fornece ou ditar nenhuma maneira específica de implementar a lógica do app do Chat. É possível criar um app do Chat orientado por comando ou usar qualquer tipo de processamento de linguagem e serviços ou módulos de IA que quiser. É possível fazer isso 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 do 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 autenticação.

  • Por padrão, os apps do 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 aplicativo. 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.
  • Em apps do Chat que préviam links, o app do Chat pode ler URLs adicionados à mensagem que correspondem aos padrões de URL configurados do 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 peça 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.