Crie apps do Google Chat que levam 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.
Para ajudar na 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 de 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 do Chat específico.
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 de mensagem definido, em que cada mensagem consiste em um objeto JSON com componentes que especificam ID do usuário, estilo, conteúdo e outros aspectos da mensagem. Esses apps podem enviar estes tipos de mensagens:
- As mensagens de texto contêm conteúdo de texto simples com formatação limitada.
- As mensagens dos cards definem o formato, o conteúdo e o comportamento dos cards que serão mostrados 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.
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
Adicionar apps de 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, agindo como intermediário deles.
Essa capacidade de oferecer acesso a uma grande variedade de recursos e ferramentas, ao mesmo tempo que mantém 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
Veja alguns exemplos de ações que você pode pedir a um app do Chat no espaço do Chat:
- Procurar informações: um app de chat pode recuperar informações com base em consultas de texto estruturadas ou livres inseridas pelo usuário.
- Registrar tíquetes: um app do Chat pode gerar relatórios de incidentes ou outros artefatos usando as informações fornecidas pelo usuário.
- Coordenar esforços: um app do Chat pode melhorar a maneira como os membros da equipe interagem entre si, por exemplo, fornecendo "memória da equipe" ou agendamento de recursos.
Criar apps do Chat interativos
Muitos apps de chat permitem que os usuários enviem mensagens e interajam diretamente com o app do 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 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.
- Links de prévia: anexa 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 de 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 do app do Google Chat.
Criar apps do Chat não interativos
Os apps do Google Chat também não podem ser interativos, ou seja, os usuários não podem interagir diretamente com o app do Chat, mas o app do Chat 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 de 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 baseados em eventos
Um app do Chat pode se inscrever em eventos dos 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 assinado 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 do Chat oferece várias maneiras de integrar seus apps nos espaços do Chat, mas não fornece ou determina 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 você quiser. É possível fazer isso em várias plataformas, entre elas:
- AppSheet
- Google Apps Script
- Pub/Sub
- Google Cloud ou um servidor HTTP local
Para ver 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 usuários sendo @mencionados na mesma mensagem que invoca o app. Essas informações incluem o nome de exibição, o ID do usuário, o endereço de e-mail e a imagem do avatar.
No caso de apps do Chat que visualizam links, ele pode ler os URLs adicionados à mensagem que correspondam aos padrões de URL configurados.
Se um app de chat precisar acessar outros dados para oferecer recursos aprimorados aos usuários, como ler todas as mensagens ou a lista de membros de 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.
Temas relacionados
Se você estiver pronto para criar seu primeiro app do Chat, use este guia de início rápido:
Se você estiver pronto para criar um app do Chat com IA, tente o tutorial Responder a incidentes.
Para aprender a criar apps de chat que ajudam e agradam os usuários, consulte Planejar o design do seu app do Chat.
Se você não tiver certeza sobre a melhor abordagem para criar um app do Chat, consulte Escolher uma arquitetura de app do Chat.
 |
Quer conferir a API Google Chat em ação?
O canal Google Workspace Developers inclui vídeos com dicas,
truques e recursos mais recentes.
|