Cómo migrar tu app de Google Chat

Si fusionas organizaciones de Google Workspace, es posible que debas migrar tu app de Chat para que siga funcionando.

Antes de migrar tu app de Chat, consulta con el administrador de tu organización para ver si la configuración administrativa la está afectando. Si cambias un parámetro de configuración administrativo, es posible que se restablezca la funcionalidad completa de tu app de Chat y que no sea necesaria la migración. Por ejemplo, es posible que el administrador de Google Workspace tenga que agregar tu app de Chat a una lista de entidades permitidas o permitir que los usuarios instalen apps de Chat. Para obtener más información, consulta Cómo determinar si las apps de Google Chat deben migrar después de fusionar organizaciones de Google Workspace.

Después de determinar que necesitas migrar tu app de Chat, completa el siguiente proceso de tres pasos:

  1. Para configurar el entorno de tu app de Chat, crea un proyecto de Google Cloud en la organización fusionada, habilita las APIs y, posiblemente, configura la pantalla de consentimiento de OAuth 2.0.
  2. Vuelve a implementar tu app de Chat desde el nuevo proyecto de Cloud.
  3. Agrega la app de Chat recreada a los espacios o conversaciones de Chat y desactiva la app de Chat original.

Crea un proyecto de Cloud en la organización fusionada y habilita las APIs

Crear un proyecto de Cloud nuevo y habilitar las APIs de la app de Chat en la organización de Google Workspace fusionada garantiza que los usuarios y los grupos a los que les permites acceder a la app de Chat puedan hacerlo sin errores.

Crea un proyecto de Cloud

Consola de Google Cloud

  1. En la consola de Google Cloud, ve a Menú > IAM y administración > Crear un proyecto.

    Ir a Crear un proyecto

  2. En el campo Nombre del proyecto, ingresa un nombre descriptivo para tu proyecto.

    Opcional: Para editar el ID del proyecto, haz clic en Editar. El ID del proyecto no se puede cambiar después de que se crea el proyecto. Por lo tanto, elige un ID que abarque tus necesidades durante todo el ciclo de vida del proyecto.

  3. En el campo Ubicación, haz clic en Explorar para mostrar las posibles ubicaciones de tu proyecto. Luego, haga clic en Seleccionar.
  4. Haz clic en Crear. La consola de Google Cloud navega a la página Panel y se crea tu proyecto en pocos minutos.

gcloud CLI

En uno de los siguientes entornos de desarrollo, accede a Google Cloud CLI (gcloud):

  • Cloud Shell: Para usar una terminal en línea con la CLI de gcloud ya configurada, activa Cloud Shell.
    Activar Cloud Shell
  • Shell local: Para usar un entorno de desarrollo local, instala e inicializa la CLI de gcloud.
    Para crear un proyecto de Cloud, usa el comando gcloud projects create: 
    gcloud projects create PROJECT_ID
     Para reemplazar PROJECT_ID, configura el ID del proyecto que deseas crear.

Habilita las APIs

Todas las apps de Chat deben tener habilitada la API de Google Chat. Según cómo se compila tu app de Chat, es posible que necesites habilitar otras APIs. Por ejemplo, si compartiste tu app de Chat con Google Cloud Functions, habilita la API de Cloud Build, la API de Cloud Functions, la API de Pub/Sub, la API de Cloud Logging, la API de Artifact Registry y la API de Cloud Run. Como práctica recomendada, para asegurarte de que la app migrada funcione, habilita las mismas APIs en el nuevo proyecto de Cloud que están habilitadas en el proyecto de Cloud anterior.

Para habilitar una API, haz lo siguiente:

Consola de Google Cloud

  1. En la consola de Google Cloud, ve a Menú > Más productos > Google Workspace > Biblioteca de productos.

    Ir a la biblioteca de productos

  2. Haz clic en la API que quieres activar.
  3. Haz clic en Habilitar.
  4. Para habilitar más APIs, repite estos pasos.

Google Cloud CLI

  1. Instala o abre la interfaz de línea de comandos (CLI) de Google Cloud.

  2. Ejecuta el comando services enable y especifica qué servicio de API quieres habilitar.

    gcloud services enable API_SERVICE_ID

Configura la API de Chat

En tu nuevo proyecto de Cloud, debes usar la API de Chat para especificar el nombre, la descripción y el ícono de tu app de Chat. Para configurar estos detalles, consulta Configura la API de Chat.

Es posible que debas configurar la pantalla de consentimiento de OAuth para tu proyecto de Cloud. Si usaste OAuth 2.0 para la autorización anteriormente, usa los mismos permisos de acceso de autorización.

  1. En la consola de Google Cloud, ve a Menú > APIs y servicios > Pantalla de consentimiento de OAuth.

    Ir a la pantalla de consentimiento de OAuth

  2. Selecciona el tipo de usuario de tu app y, luego, haz clic en Crear.
  3. Completa el formulario de registro de la app y, luego, haz clic en Guardar y continuar.

  4. Si creas una app para usar fuera de tu organización de Google Workspace, haz clic en Agregar o quitar permisos. Recomendamos las siguientes prácticas recomendadas cuando selecciones los permisos:

    • Selecciona los permisos que proporcionan el nivel mínimo de acceso que requiere tu app. Para obtener una lista de los permisos disponibles, consulta Alcances de OAuth 2.0 para las APIs de Google.
    • Revisa los permisos que se enumeran en cada una de las tres secciones: permisos no sensibles, permisos sensibles y permisos restringidos. En el caso de los permisos que se enumeran en las secciones "Tus permisos sensibles" o "Tus permisos restringidos", intenta identificar permisos alternativos que no sean sensibles para evitar revisiones adicionales innecesarias.
    • Algunos permisos requieren revisiones adicionales por parte de Google. En el caso de las apps que solo usa internamente tu organización de Google Workspace, los permisos no se incluyen en la pantalla de consentimiento, y el uso de permisos restringidos o sensibles no requiere una revisión adicional por parte de Google. Para obtener más información, consulta Categorías de alcance.
  5. Después de seleccionar los permisos necesarios para tu app, haz clic en Guardar y continuar.
  6. Si seleccionaste Externo como el tipo de usuario, agrega usuarios de prueba:
    1. En Usuarios de prueba, haz clic en Agregar usuarios.
    2. Ingresa tu dirección de correo electrónico y los demás usuarios de prueba autorizados, y haz clic en Guardar y continuar.
  7. Revisa el resumen del registro de tu app. Para realizar cambios, haz clic en Editar. Si el registro de la app parece correcto, haz clic en Volver al panel.

Vuelve a implementar tu app de Chat en el nuevo proyecto de Cloud

Según si tu app de Chat se compiló con Apps Script, AppSheet o con otro tipo de conexión, como Python o Java, la reinstalación de la app de Chat difiere un poco. En cualquier caso, no es necesario que vuelvas a crear todo el código, pero sí debes realizar algunos cambios.

Migra la lógica de la app de Chat

Según la arquitectura de tu app de Chat, es posible que debas migrar otros servicios al nuevo proyecto de Cloud:

  • En el caso de las apps HTTP, también debes migrar el resto de la lógica de la app que se compiló con Cloud Functions, Cloud Run o App Engine.
  • En el caso de las apps de chat conversacional que usan lenguaje natural, también debes migrar los agentes de Dialogflow.
  • En el caso de las apps de Chat compiladas detrás de un firewall, también debes migrar los temas de Pub/Sub.

Configura funciones interactivas en el nuevo proyecto de Cloud

Para volver a implementar tu app de Chat compilada con un lenguaje como Python o Java, configúrala en tu nuevo proyecto de Cloud.

Para configurar funciones interactivas, consulta Cómo recibir y responder a las interacciones de los usuarios.

Vuelve a implementar una app de chat de Apps Script

Para volver a implementar tu app de Chat compilada con Apps Script, cambia el número de proyecto de Cloud con el que está asociado el proyecto de Apps Script al número de proyecto que pertenece a tu nuevo proyecto de Cloud. Luego, copia el ID de implementación de Apps Script y pégalo en la página de configuración de la app de Chat en la consola de Google Cloud.

Copia el número de proyecto de Cloud

  1. En la consola de Google Cloud, ve a Menú > IAM y administración > Configuración.

    Ir a Configuración de IAM y administrador

  2. En el campo Número del proyecto, copia el valor.

Establece el número de proyecto de Google Cloud en tu proyecto de Apps Script

  1. Ve a Apps Script.

    Ve a Apps Script.

  2. En el proyecto de Apps Script de la app de Chat, haz clic en Configuración del proyecto .

  3. En Proyecto de Google Cloud Platform (GCP), haz clic en Cambiar proyecto.

  4. En Número de proyecto de GCP, pega el número de proyecto de Google Cloud.

  5. Haz clic en Establecer el proyecto.

Copia el ID de implementación de tu proyecto de Apps Script

  1. En la esquina superior derecha de Apps Script, haz clic en Implementar > Administrar implementaciones.
  2. En ID de implementación, haz clic en Copiar.
  3. Haz clic en Listo.

Cómo volver a configurar y a implementar tu app de Chat

  1. En la consola de Google Cloud, busca "API de Google Chat" y haz clic en API de Google Chat. Luego, haz clic en Administrar.

    Ir a la API de Chat

  2. Haz clic en la pestaña Configuración y, luego, ingresa la siguiente información obligatoria:

    • Nombre de la app: Es el nombre que las personas usan cuando interactúan con tu app de chat.
    • URL del avatar: Es una URL HTTPS que dirige a una imagen gráfica cuadrada (por ejemplo, PNG o JPEG), de al menos 128 × 128, que aparece como el avatar de tu app de Chat.
    • Descripción: Es una descripción del propósito previsto de la app de Chat que aparece debajo del nombre de la app.

  3. Para activar las funciones interactivas, haz clic en el botón de activación Habilitar funciones interactivas que permite a los usuarios interactuar con tu app de Chat:

  4. En Configuración de conexión, selecciona Proyecto de Apps Script.

  5. En el campo ID de implementación, pega el ID de implementación que copiaste antes.

  6. Para completar el resto de la configuración, consulta la tabla en Cómo configurar la app de Chat en el nuevo proyecto de Cloud.

  7. Haz clic en Guardar.

Vuelve a implementar una app de Chat de AppSheet

Para volver a implementar la app de Chat compilada con AppSheet en tu nuevo proyecto de Cloud, cópiala en el nuevo proyecto de Cloud.

Actualiza la cuenta de servicio

Si tu app de Chat se autentica como una app y usa una cuenta de servicio para realizar llamadas a las APIs de Google, actualiza los detalles de la cuenta de servicio de la app de Chat. Para obtener más información, consulta Cómo autenticar una app de Chat.

Cómo compartir tu app de Chat

Antes de que la app de Chat esté disponible para los usuarios de la organización nueva, es posible que el administrador deba permitir el acceso a la app de Chat de forma manual. Para obtener más información, consulta Cómo instalan las apps de Chat los administradores de Google Workspace.

Cambia a la nueva app de Chat

Ahora que la app de Chat se migró a la nueva organización, es hora de publicarla. Agrega la app a los espacios de Chat o a los mensajes directos y, luego, quítales la app de Chat anterior para que las personas solo envíen mensajes a la app de Chat migrada.

Agrega la nueva app de Chat a los espacios de Chat

  1. Ve a Chat.

    Ve a Chat

  2. Haz clic en un mensaje directo o un espacio.

  3. Haz clic en el menú desplegable junto al nombre del espacio o la persona y, luego, selecciona Apps e integraciones.

  4. Haz clic en Agregar apps.

  5. Ingresa el nombre de la app, selecciónala de la lista y, luego, haz clic en Agregar.

  6. Repite estos pasos para cada espacio o mensaje directo al que quieras agregar la app de Chat.

Cómo quitar la app de Chat anterior de los espacios de Chat

  1. Ve a Chat.

    Ve a Chat

  2. Haz clic en un mensaje directo o un espacio.

  3. Haz clic en el menú desplegable junto al nombre del espacio o la persona y, luego, selecciona Apps e integraciones.

  4. Junto a la app de Chat anterior que no se migró, haz clic en Más opciones y, luego, en Quitar del espacio.

  5. Repite estos pasos para cada espacio o mensaje directo del que quieras quitar la app de Chat anterior.

Cómo desactivar la app de Chat anterior

Para evitar que los usuarios usen la app de Chat anterior y alentarlos a usar la nueva, desactiva la app de Chat anterior y despublícala de Google Workspace Marketplace.