Migrar o app Google Chat

Se você mesclar organizações do Google Workspace, talvez seja necessário migrar o app Chat para que ele continue funcionando.

Antes de migrar o app Chat, verifique com o administrador da sua organização se as configurações administrativas estão afetando o app. Mudar uma configuração administrativa pode restaurar a funcionalidade total do app Chat e tornar a migração desnecessária. Por exemplo, o administrador do Google Workspace pode adicionar o app do Chat a uma lista de permissões ou permitir que os usuários instalem apps do Chat. Para mais informações, consulte Determinar se os apps do Google Chat precisam ser migrados após a fusão de organizações do Google Workspace.

Depois de determinar que você precisa migrar seu app Chat, siga estas três etapas:

  1. Configure o ambiente para seu app de chat criando um projeto do Google Cloud na organização mesclada, ativando APIs e talvez configurando a tela de consentimento do OAuth 2.0.
  2. Implante o app Chat novamente no novo projeto do Cloud.
  3. Adicione o app de chat recriado aos espaços ou conversas do Chat e desative o app original.

Crie um projeto do Cloud na organização combinada e ative as APIs

Criar um novo projeto do Cloud e ativar APIs para o app Chat na organização do Google Workspace mesclada garante que os usuários e grupos que você permitir acessar o app Chat possam fazer isso sem erros.

Criar um projeto do Cloud

Console do Google CloudCLI da gcloud
  1. No console do Google Cloud, acesse Menu > IAM e administrador > Criar um projeto.

    Acessar "Criar um projeto"

  2. No campo Nome do projeto, insira um nome descritivo.

    Opcional: para editar o ID do projeto, clique em Editar. O ID do projeto não pode ser alterado após a criação do projeto. Portanto, escolha um ID que atenda às suas necessidades durante a vida útil do projeto.

  3. No campo Local, clique em Procurar para mostrar possíveis locais para seu projeto. Em seguida, clique em Selecionar.
  4. Clique em Criar. O console do Google Cloud navega até a página "Painel", e seu projeto é criado em alguns minutos.

Em um dos seguintes ambientes de desenvolvimento, acesse a CLI do Google Cloud (gcloud):

  • Cloud Shell: para usar um terminal on-line com a CLI gcloud já configurada, ative o Cloud Shell.
    Ativar o Cloud Shell
  • Shell local: para usar um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud.
    Para criar um projeto do Cloud, use o comando gcloud projects create: 
    gcloud projects create PROJECT_ID
     Substitua PROJECT_ID definindo o ID do projeto que você quer criar.

Ativar APIs

Todos os apps de chat precisam ter a API Google Chat ativada. Dependendo de como o app de chat foi criado, talvez seja necessário ativar outras APIs. Por exemplo, se você criou seu app de chat usando o Google Cloud Functions, ative as APIs Cloud Build, Cloud Functions, Pub/Sub, Cloud Logging, Artifact Registry e Cloud Run. Como prática recomendada, para garantir que o app migrado funcione, ative as mesmas APIs no novo projeto do Cloud que estão ativadas no projeto antigo.

Para ativar uma API, faça o seguinte:

Console do Google CloudGoogle Cloud CLI
  1. No console do Google Cloud, acesse Menu > Mais produtos > Google Workspace > Biblioteca de produtos.

    Acessar a biblioteca de produtos

  2. Clique na API que você quer ativar.
  3. Clique em Ativar.
  4. Para ativar mais APIs, repita essas etapas.
  1. Instale ou abra a interface de linha de comando (CLI) do Google Cloud.

  2. Execute o comando services enable, especificando qual serviço de API ativar.

    gcloud services enable API_SERVICE_ID

Configurar a API Chat

No novo projeto do Cloud, use a API Chat para especificar o nome, a descrição e o ícone do app. Para configurar esses detalhes, consulte Configurar a API Chat.

Talvez seja necessário configurar a tela de consentimento do OAuth para seu projeto da nuvem. Se você já usou o OAuth 2.0 para autorização, use os mesmos escopos de acesso de autorização.

  1. No console do Google Cloud, acesse Menu > > Marca.

    Acessar "Branding"

  2. Se você já tiver configurado o , poderá configurar as seguintes configurações da tela de consentimento do OAuth em Marca, Público-alvo e Acesso a dados. Se você receber a mensagem ainda não configurado, clique em Começar:
    1. Em Informações do app, em Nome do app, insira um Nome do app.
    2. Em E-mail para suporte do usuário, escolha um endereço de e-mail de suporte para que os usuários entrem em contato com você se tiverem dúvidas sobre o consentimento.
    3. Clique em Próxima.
    4. Em Público, selecione o tipo de usuário do app.
    5. Clique em Próxima.
    6. Em Dados de contato, insira um endereço de e-mail para receber notificações sobre as mudanças no projeto.
    7. Clique em Próxima.
    8. Em Concluir, analise a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a política de dados do usuário dos serviços de API do Google.
    9. Clique em Continuar.
    10. Clique em Criar.
    11. Se você selecionou Externo como tipo de usuário, adicione usuários de teste:
      1. Clique em Público-alvo.
      2. Em Test users, clique em Add users.
      3. Insira seu endereço de e-mail e os outros usuários de teste autorizados. Depois, clique em Salvar.

  3. Se você estiver criando um app para uso fora da sua organização do Google Workspace, clique em Acesso a dados > Adicionar ou remover escopos. Recomendamos as seguintes práticas recomendadas ao selecionar escopos:

    • Selecione os escopos que fornecem o nível mínimo de acesso exigido pelo app. Para uma lista de escopos disponíveis, consulte Escopos do OAuth 2.0 para APIs do Google.
    • Analise os escopos listados em cada uma das três seções: escopos não sensíveis, sensíveis e restritos. Para todos os escopos listados nas seções "Seus escopos sensíveis" ou "Seus escopos restritos", tente identificar escopos alternativos não sensíveis para evitar revisões adicionais desnecessárias.
    • Alguns escopos exigem análises adicionais do Google. Para apps usados apenas internamente pela sua organização do Google Workspace, os escopos não são listados na tela de consentimento, e o uso de escopos restritos ou sensíveis não exige mais análises do Google. Para mais informações, consulte Categorias de escopo.
  4. Depois de selecionar os escopos necessários para o app, clique em Salvar.

Para mais informações sobre como configurar o consentimento OAuth, consulte Começar a usar o .

Implantar o app Chat no novo projeto do Cloud

Dependendo se o app de chat foi criado com o Apps Script, o AppSheet ou outro tipo de conexão, como Python ou Java, a reimplantação do app de chat é um pouco diferente. Em ambos os casos, não é necessário recriar todo o código, mas é necessário fazer algumas mudanças.

Migrar a lógica do app Chat

Dependendo da arquitetura do app de chat, talvez seja necessário migrar outros serviços para o novo projeto do Cloud:

  • Para apps HTTP, você também precisa migrar o restante da lógica do app que foi criada usando o Cloud Functions, o Cloud Run ou o App Engine.
  • Para apps de chat de conversação que usam linguagem natural, você também precisa migrar os agentes do Dialogflow.
  • Para apps de chat criados atrás de um firewall, também é necessário migrar os tópicos do Pub/Sub.

Configurar recursos interativos no novo projeto do Cloud

Para reimplantar o app Chat criado com uma linguagem como Python ou Java, configure o app Chat no seu novo projeto do Cloud.

Para configurar recursos interativos, consulte Receber e responder a interações do usuário.

Implantar novamente um app do Chat do Apps Script

Para reimplantar o app de chat criado com o Apps Script, mude o número do projeto do Cloud associado ao projeto do Apps Script para o número do projeto do novo projeto do Cloud. Em seguida, copie o ID de implantação do Apps Script e cole na página de configuração do app Chat no console do Google Cloud.

Copiar o número do projeto do Cloud

  1. No console do Google Cloud, acesse Menu > IAM e administrador > Configurações.

    Acessar as configurações do IAM e do administrador

  2. No campo Número do projeto, copie o valor.

Definir o número do projeto do Google Cloud no projeto do Apps Script

  1. Acesse o Apps Script.

    Acessar o Apps Script

  2. No projeto do Apps Script do app Chat, clique em Configurações do projeto .

  3. Em Projeto do Google Cloud Platform (GCP), clique em Mudar projeto.

  4. Em Número do projeto do GCP, cole o número do projeto do Google Cloud.

  5. Clique em Configurar projeto.

Copiar o ID de implantação do seu projeto do Apps Script

  1. No canto superior direito do Apps Script, clique em Implantar > Gerenciar implantações.
  2. Em ID da implantação, clique em Copiar.
  3. Clique em Concluído.

Reconfigurar e reimplantar o app do Chat

  1. No console do Google Cloud, pesquise "API Google Chat" e clique em API Google Chat e em Gerenciar.

    Acessar a API Chat

  2. Clique na guia Configuração e insira as seguintes informações necessárias:

    • Nome do app: o nome que as pessoas usam ao interagir com seu app de chat.
    • URL do avatar: um URL HTTPS que aponta para uma imagem gráfica quadrada (por exemplo, PNG ou JPEG), com pelo menos 128 x 128, que aparece como o avatar do seu app de chat.
    • Descrição: uma descrição da finalidade do app Chat, que aparece abaixo do nome dele.

  3. Para ativar os recursos interativos, clique no botão Ativar recursos interativos que permite que os usuários interajam com o app do Chat:

  4. Em "Configurações de conexão", selecione Projeto do Apps Script.

  5. No campo ID da implantação, cole o ID da implantação que você copiou anteriormente.

  6. Para concluir o restante da configuração, consulte a tabela em Configurar o app Chat no novo projeto do Cloud.

  7. Clique em Salvar.

Implantar novamente um app do Chat do AppSheet

Para implantar novamente o app Chat criado com o AppSheet no novo projeto do Cloud, copie o app para o novo projeto do Cloud.

Atualizar a conta de serviço

Se o app de chat for autenticado como um app e usar uma conta de serviço para fazer chamadas para as APIs do Google, atualize os detalhes da conta de serviço do app de chat. Para mais informações, consulte Autenticar como um app de chat.

Compartilhar seu app de chat

Antes que o app de chat fique disponível para os usuários na nova organização, talvez o administrador precise permitir o acesso manualmente. Para mais informações, consulte Como os administradores do Google Workspace instalam apps do Chat.

Mudar para o novo app Chat

Agora que o app Chat foi migrado para a nova organização, é hora de divulgá-lo. Adicione-o aos espaços do Chat ou às mensagens diretas e remova o app Chat antigo deles para que as pessoas enviem mensagens apenas para o app Chat migrado.

Adicionar o novo app do Chat aos espaços do Chat

  1. Acesse o Chat.

    Acessar o Chat

  2. Clique em uma mensagem direta ou um espaço.

  3. Clique no menu suspenso ao lado do nome do espaço ou da pessoa e selecione Apps e integrações.

  4. Clique em Adicionar apps.

  5. Digite o nome do app, selecione-o na lista e clique em Adicionar.

  6. Repita essas etapas para cada espaço ou mensagem direta em que você quer adicionar o app do Chat.

Remover o app Chat antigo dos espaços do Chat

  1. Acesse o Chat.

    Acessar o Chat

  2. Clique em uma mensagem direta ou um espaço.

  3. Clique no menu suspenso ao lado do nome do espaço ou da pessoa e selecione Apps e integrações.

  4. Ao lado do app antigo do Chat que não foi migrado, clique em Mais opções e em Remover do espaço.

  5. Repita essas etapas para cada espaço ou mensagem direta que você quer remover o app antigo do Chat.

Desativar o app Chat antigo

Para impedir que os usuários usem o app Chat antigo e incentivar o uso do novo, desative o app antigo e despublice-o no Google Workspace Marketplace.