Publicar apps do Google Chat

Depois de criar um app de chat, você pode publicá-lo para que ele fique disponível para pessoas ou grupos selecionados, todos na sua organização ou qualquer usuário do Google Chat.

Para publicar o app de chat e disponibilizá-lo para outras pessoas, siga estas etapas:

  1. Ativar e configurar a API Google Chat. Ao configurar a API, você pode adicionar até cinco endereços de e-mail para acessar seu app de chat para testes.
  2. Publicar o app com o SDK do Google Workspace Marketplace. Você pode configurar o app de chat para que seja disponibilizado apenas para usuários da sua organização do Google Workspace ou para todos os usuários do Google Chat.
  3. Caso sua organização do Google Workspace gerencie o acesso aos apps do Chat, peça para o administrador do Google Workspace adicionar o app à lista de permissões.

Como os usuários usam ou instalam os apps do Chat

Depois que você publicar seu app Chat, os usuários do Google Chat poderão iniciar uma mensagem direta com o app ou adicioná-lo a um espaço escolhendo-o na lista de destinatários propostos, conforme mostrado abaixo.

Os usuários também podem restringir a lista de destinatários propostos mencionando o app por nome. Por exemplo, se você publicar um app chamado "Bot de programador" e um usuário na sua organização digitar "@sch", o Google Chat vai propor seu app como uma das opções de preenchimento automático.

Como alternativa, os administradores do Google Workspace podem encontrar apps de chat no Google Workspace Marketplace e instalar os apps para os usuários da organização. Quando os administradores instalam um app de chat, ele aparece no painel de mensagens diretas dos usuários.

Os administradores do Google Workspace também podem gerenciar e autorizar o uso dos apps de Chat na organização. Se você estiver desenvolvendo um app de chat para uma organização que usa listas de permissões, precisará solicitar que um administrador o adicione à lista de permissões para que os usuários possam encontrar e usar o app. Para mais informações, consulte a documentação da Ajuda do administrador do Google Workspace em Permitir que os usuários instalem apps de chat.

Ativar e configurar a API Google Chat

Configure um projeto para o app no Google API Console e ative a API Google Chat.

  1. Use o botão abaixo para criar um novo projeto (ou selecionar um atual) e adicionar uma conta de serviço a ele. Atribua à conta de serviço o papel de Proprietário do projeto.
    Ativar a API
  2. Salve a chave JSON salva. O app pode usar essa chave para autenticar mensagens que são enviadas a espaços de forma assíncrona.
  3. Abra seu projeto no API Console. Na lista de APIs, clique em API Google Chat.
  4. Selecione a guia Configuração e insira as informações do app, conforme descrito abaixo.

Quando você salva a configuração do app, ele fica disponível para os usuários especificados na sua organização.

Sobre a configuração do app

Campo Descrição
Nome do app O nome que as pessoas usam ao interagir com seu app.
URL do avatar Um URL HTTPS que aponta para uma imagem quadrada de gráficos (por exemplo, PNG ou JPEG), pelo menos 128x128, que aparecerá como o avatar do seu aplicativo.
Descrição Uma descrição da funcionalidade do app que aparece abaixo do nome dele.
Funcionalidade Um conjunto de campos que determinam quais eventos podem acionar o app:
  • Receber mensagens individuais: os usuários podem encontrar e enviar mensagens para o app diretamente no Google Chat.
  • Receber eventos da instalação do administrador: receba eventos ADDED_TO_SPACE ou REMOVED_FROM_SPACE do Chat quando um administrador do Google Workspace instalar ou desinstalar o app na organização. Por padrão, o app não recebe esses eventos, a menos que você os ative porque isso pode resultar em consultas mais altas por segundo.
  • Participar de espaços e conversas em grupo: o app pode participar de espaços e conversas em grupo quando eles são adicionados.
Configurações de conexão O endpoint do app, que pode ser um dos seguintes:
  • URL do app: um endpoint HTTPS em que a implementação do app está hospedada.
  • Projeto do Apps Script: um código de implantação para um projeto do Apps Script que implementa um app.
  • Nome do tópico do Cloud Pub/Sub: um tópico do Cloud Pub/Sub que o app assina como um endpoint.
  • Dialogflow: registra o aplicativo com uma integração do Dialogflow. Para mais informações, consulte a documentação do Dialogflow sobre a integração com o Google Chat.
Comandos de barra Comandos que podem ser exibidos aos usuários no Google Chat. Permite que os usuários vejam as principais ações para o app no Google Chat e escolham uma ação específica.
Extensão de link Padrões de URL que o app reconhece e fornece mais conteúdo para quando os usuários enviarem links. Para mais informações, consulte Links do Unfurl.
Visibilidade As permissões de instalação e visibilidade do usuário especificadas pelo desenvolvedor para o app. É possível adicionar até cinco pessoas ou grupos para ver e instalar o app Chat. Para que ele fique visível e possa ser instalado por mais de cinco usuários, publique-o com o SDK do Google Workspace Marketplace.

Conceder permissões de configuração para apps

Você pode conceder a usuários específicos acesso à página de configuração do app. Para isso, use os papéis do IAM de Proprietário de apps de chat e Leitor de apps de chat. Os usuários com esses papéis não podem navegar até a página de configuração do app pelo painel de APIs e serviços, mas podem acessar a página de configuração navegando até o console do projeto da seguinte maneira:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=your-project-id

Publicar o app com o SDK do Google Workspace Marketplace

Use o SDK do Google Workspace Marketplace para:

  • Publique seu app publicamente e permita que qualquer usuário do Google Chat o adicione a um espaço.
  • Publique o app na sua organização.
  • Torne seu app visível para os administradores do Google Workspace para que eles possam instalar o app para os usuários da organização. Para ficar visível para os administradores do Google Workspace, seu app precisa exibir mensagens diretas.

Antes de publicar seu app usando o SDK do Google Workspace Marketplace, siga estas etapas:

  1. Para testar o app Chat, instale-o pelo Chat. Verifique se o app é totalmente funcional e não está em trabalho em andamento.
  2. Revise os requisitos de publicação e verifique se o app atende a todos eles. Consulte Áreas de revisão.
  3. Registre o número da versão do app. Você precisa dele para configurar o SDK do Google Workspace Marketplace.

Quando estiver pronto para publicar, consulte Visão geral: publicar um app.

Desativar seu app

Depois que você salva a página de configuração, um campo "Status do aplicativo" é exibido. Esse campo permite controlar se o app será Ativo ou Desativado.

Para desativar um app do Chat:

  1. Abra o Console do Google Cloud.
  2. Se necessário, selecione o projeto do Google Cloud que hospeda o app Chat:
    1. Ao lado de "Google Cloud", clique na seta para baixo . Uma caixa de diálogo listando os projetos atuais é exibida.
    2. Selecione o projeto que hospeda o app Chat migrado.
    3. Clique em Open.
  3. Pesquise "API Google Chat" e clique em API Google Chat.
  4. Selecione Gerenciar.
  5. Clique em Configuração.
  6. Na seção "Status do app", selecione Desativado.
  7. Clique em Salvar.