Depois de criar um app de chat, você poderá publicá-lo para que ele fique disponível para pessoas ou grupos selecionados, para todos na sua organização do Google Workspace ou para qualquer usuário do Google Chat que tenha uma conta do Google Workspace.
Como os usuários descobrem e usam os apps do Google Chat
Os usuários podem descobrir e começar a usar os apps do Chat de algumas maneiras diferentes:
- Pesquisando apps no Google Chat
- Interação com um app adicionado a um espaço do Chat
- Descobrir o app no painel de mensagens diretas depois que um administrador do Google Workspace instalou o app em nome dele.
Para começar a usar um app, os usuários do Google Chat podem iniciar uma mensagem direta com o app ou adicioná-lo a um espaço escolhendo-o na lista de destinatários da proposta, conforme mostrado abaixo:
Os usuários também podem restringir a lista de destinatários propostos mencionando o app pelo nome. Por exemplo, se você publicar um app chamado "Bot do programador" e um usuário na sua organização digitar "@sch", o Google Chat sugerirá 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 na 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 de apps de chat na organização do Google Workspace. Se você estiver desenvolvendo um app Chat para uma organização que usa listas de permissões, solicite que um administrador o adicione à lista de permissões para que os usuários possam encontrá-lo e usá-lo. Para mais informações, consulte a documentação da Ajuda do administrador do Google Workspace, Permitir que os usuários instalem apps de chat.
Configurar e publicar seu app de chat usando o Console do Google Cloud
Para publicar o app Chat e disponibilizá-lo para outras pessoas, geralmente é necessário seguir estas etapas:
- Ative e configure a API Google Chat. Ao configurar a API, você concede a outros usuários do Google Chat acesso ao seu app para testes.
- Publique seu app com o SDK do Google Workspace Marketplace. Você pode configurar o app de chat para ser disponibilizado aos usuários na sua organização do Google Workspace ou a todos os usuários do Google Chat.
- Se a organização do Google Workspace gerencia o acesso aos apps de chat, solicite que o administrador do Google Workspace adicione o app à lista de permissões.
Configurações de visibilidade e publicação do app Chat
A tabela a seguir explica como definir as configurações da API Google Chat e do SDK do Google Workspace Marketplace com base no público do seu app Chat:
. . . .| Estou criando um app de chat... | Método de autenticação | Configurações da API Google Chat | Configurações do SDK do Google Workspace Marketplace | Onde meu app Chat é publicado? |
|---|---|---|---|---|
| ...Para minha pequena equipe | Autentique-se como um usuário ou um app. | Na configuração Visibilidade, especifique as pessoas e/ou os Grupos do Google que podem acessar o app.
Se sua conta do Google Workspace exigir que os apps sejam incluídos na lista de permissões, só será possível especificar até cinco endereços de e-mail. Não é possível especificar Grupos do Google. |
Não é necessário configurar o SDK do Google Workspace Marketplace para seu app Chat. | Os membros da equipe podem encontrar e usar o app Chat no Google Chat. |
| ...Para minha equipe grande | Autentique-se como um usuário ou um app. | Na configuração Visibilidade, especifique pessoas e/ou Grupos do Google para testar o app Chat.
Após o teste, publique o app Chat na sua organização do Google Workspace com as configurações do SDK do Google Workspace Marketplace. |
Defina a Visibilidade do app como Particular. Defina Configurações de instalação como Individual + Admin. Caso sua conta do Google Workspace exija que os apps sejam incluídos na lista de permissões, solicite que um administrador adicione seu app de chat à lista de permissões para que os usuários possam encontrá-lo e usá-lo. Para mais informações, consulte a documentação da Ajuda do administrador do Google Workspace, Como permitir que os usuários instalem apps de chat. |
Qualquer pessoa da sua organização do Google Workspace pode encontrar e instalar o app Chat no Google Chat e ver o app no Google Workspace Marketplace. Os usuários e administradores do Google Workspace podem instalar seu app no Marketplace. |
| ...para minha organização do Google Workspace | Autentique-se como um usuário ou um app. | Na configuração Visibilidade, especifique pessoas e/ou Grupos do Google para testar o app Chat.
Após o teste, publique o app Chat na sua organização do Google Workspace com as configurações do SDK do Google Workspace Marketplace. |
Defina a Visibilidade do app como Particular. Defina Configurações de instalação como Individual + Admin. |
Qualquer pessoa da sua organização do Google Workspace pode encontrar e instalar o app Chat no Google Chat e ver o app no Google Workspace Marketplace. Somente os administradores do Google Workspace podem instalar seu app no Marketplace. |
| ...para todos (app de chat público) | Autentique-se como um app. | Na configuração Visibilidade, especifique pessoas e/ou Grupos do Google para testar o app Chat.
Após o teste, publique o app Chat publicamente nas configurações do Google Workspace Marketplace. |
Defina Visibilidade do aplicativo como Público. Defina as Configurações de instalação como Individual + administrador. |
Qualquer usuário do Google Workspace pode encontrar e instalar o app Chat no Google Chat e visualizar o app no Google Workspace Marketplace. Somente os administradores do Google Workspace podem instalar seu app no Marketplace. |
Ativar e configurar a API Google Chat
Configure um projeto para seu app no Google API Console e ative a API Google Chat.
- Use o botão abaixo para criar um novo projeto (ou selecionar um existente) e adicionar uma conta de serviço a ele. Atribua à conta de serviço o papel Proprietário do projeto.
Ativar a API - Salve a chave JSON salva. O app pode usar essa chave para autenticar mensagens enviadas para espaços de maneira assíncrona.
- Abra seu projeto no API Console. Na lista de APIs, clique em API Google Chat.
- Selecione a guia Configuração e insira as informações do aplicativo, conforme descrito na tabela a seguir.
Quando você salva a configuração do app, ele fica disponível para os usuários especificados na sua organização do Google Workspace.
Configurações da API Google Chat
| Campo | Descrição |
|---|---|
| Nome do app | O nome que as pessoas usam ao interagir com seu aplicativo. |
| URL do avatar | Um URL HTTPS que aponta para uma imagem gráfica quadrada (por exemplo, PNG ou JPEG), pelo menos 128 x 128, 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 aplicativo:
|
| Configurações de conexão | O ponto de extremidade do aplicativo, que é um dos seguintes:
|
| Comandos de barra | Comandos que podem ser exibidos aos usuários no Google Chat Permite que os usuários vejam as principais ações do seu 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 Unfurl. |
| visibilidade | Até cinco pessoas ou um ou mais Grupos do Google podem ver e instalar seu app de chat. Use este campo para testar o app ou para compartilhar o app com sua equipe. Saiba mais em Configurações de visibilidade e publicação do app Chat. |
Conceder permissões de configuração do app
Você pode conceder a usuários específicos acesso à página de configuração do aplicativo. Para isso, use os papéis do IAM 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 aplicativo por meio do painel APIs e serviços, mas podem acessar a página de configuração ao acessar 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 fazer o seguinte:
- Publique seu app publicamente e permita que qualquer usuário do Google Chat adicione seu app a um espaço.
- Publique o aplicativo no seu domínio.
- Torne seu app visível para os administradores do Google Workspace para que eles possam instalá-lo para os usuários na organização. Para ficar visível aos 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:
- Instale o app de chat para testá-lo. Verifique se o app é totalmente funcional e não está em trabalho em andamento.
- Revise os requisitos de publicação e verifique se o app atende a todos eles. Consulte Áreas de revisão.
- Registre o número da versão do app. Você precisará dele para configurar o SDK do Google Workspace Marketplace.
Quando estiver pronto para publicar, consulte Visão geral: publicar um app.
Desativar o app Chat
Depois que você salvar a página de configuração, um campo "Status do aplicativo" será exibido. Esse campo permite controlar se o app ficará Ativo ou Desativado.
Para desativar um app de chat:
- Abra o Console do Google Cloud.
- Se necessário, selecione o projeto do Google Cloud que hospeda o
app Chat:
- Ao lado de "Google Cloud", clique na seta para baixo . Uma caixa de diálogo lista os projetos atuais é exibida.
- Selecione o projeto que hospeda o app Chat migrado.
- Clique em Open.
- Pesquise "API Google Chat" e clique em API Google Chat.
- Selecione Gerenciar.
- Clique em Configuração.
- Na seção "Status do app", selecione Desativado.
- Clique em Salvar.