Cómo migrar tu app de Google Chat

Si combinas organizaciones de Google Workspace, es posible que debas migrar la 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 afecta. Si cambias un parámetro de configuración administrativo, es posible que se restablezca la funcionalidad completa de la app de Chat y que la migración no sea necesaria. Por ejemplo, es posible que el administrador de Google Workspace deba agregar tu app de Chat a una lista de entidades permitidas o que tenga que permitir que los usuarios instalen apps de Chat. Para obtener más información, consulta Determina si las apps de Google Chat deben migrarse después de combinar organizaciones de Google Workspace.

Después de que determines que necesitas migrar la app de Chat, completa este proceso de tres pasos:

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

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

Crear un nuevo proyecto de Cloud y habilitar las APIs para la app de Chat en la organización combinada de Google Workspace garantiza que los usuarios y grupos que otorgues acceso 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, por lo que debes elegir un ID que satisfaga tus necesidades durante todo el ciclo de vida del proyecto.

  3. En el campo Ubicación, haz clic en Explorar para mostrar las ubicaciones posibles del proyecto. Luego, haga clic en Seleccionar.
  4. Haz clic en Crear. La consola de Google Cloud navega a la página Panel y tu proyecto se crea en unos 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 initialize la CLI de gcloud.
    Para crear un proyecto de Cloud, usa el comando “gcloud projects create”: 
    gcloud projects create PROJECT_ID
    Reemplaza PROJECT_ID mediante la configuración del 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 compile tu app de Chat, es posible que debas habilitar otras APIs. Por ejemplo, si creaste 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 proyecto de Cloud nuevo 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 quieras 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 deseas habilitar.

    gcloud services enable API_SERVICE_ID

Es posible que sea necesario configurar la pantalla de consentimiento de OAuth para tu proyecto de Cloud. Si usaste OAuth 2.0 para la autorización, 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 Create.
  3. Completa el formulario de registro de la app y, luego, haz clic en Save and Continue.

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

    • Selecciona los permisos que proporcionan el nivel de acceso mínimo que requiere tu app. Si quieres obtener una lista de los permisos disponibles, consulta Permisos de OAuth 2.0 para las API de Google.
    • Revisa los permisos enumerados en cada una de las tres secciones: permisos no sensibles, permisos sensibles y permisos restringidos. En el caso de los permisos enumerados en las secciones “Tus permisos sensibles” o “Tus permisos restringidos”, intenta identificar permisos no sensibles alternativos para evitar revisiones adicionales innecesarias.
    • Algunos permisos requieren revisiones adicionales de Google. En el caso de las apps que tu organización de Google Workspace usa de manera interna, los permisos no se enumeran 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 permiso.
  5. Después de seleccionar los permisos que necesita tu app, haz clic en Save and Continue.
  6. Si seleccionaste Externo como 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 cualquier otro usuario de prueba autorizado. Luego, 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 es correcto, haz clic en Volver al panel.

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

Según si tu app de Chat está compilada con Apps Script, AppSheet o algún otro tipo de conexión, como Python o Java, volver a implementar la app de Chat es algo diferente. En cualquier caso, no necesitas volver a crear todo tu código, pero debes realizar algunos cambios.

Cómo migrar 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:

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

Configura la app de Chat en el nuevo proyecto de Cloud

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

  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 requerida:

    • Nombre de la app: Es el nombre que usan las personas 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 objetivo previsto de la app de Chat que aparece debajo del nombre de esta.

  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 y usar la siguiente tabla para finalizar la configuración:

    Campo Descripción
    Funcionalidad Un conjunto de campos que determinan cómo la app de Chat puede interactuar con los usuarios:
    • Recibir mensajes 1:1: Los usuarios pueden buscar y enviar mensajes a la app de Chat directamente en Google Chat.
    • Unirse a espacios y conversaciones grupales: Los usuarios pueden agregar la app de Chat a espacios y conversaciones grupales.
    Configuración de conexión El extremo de la app de Chat, que es uno de los siguientes:
    • URL de la app: Es un extremo HTTPS que aloja la implementación de la app de Chat.
    • Proyecto de Apps Script: Es un ID de implementación para un proyecto de Apps Script que implementa una app de Chat.
    • Nombre del tema de Cloud Pub/Sub: Es un tema de Pub/Sub al que se suscribe la app de Chat como un extremo.
    • Dialogflow: Registra la app de Chat con una integración de Dialogflow. Para obtener más información, consulta Compila una app de Google Chat de Dialogflow que comprenda el lenguaje natural.
    Comandos de barra Comandos que se pueden mostrar a los usuarios en Google Chat. Permite que los usuarios vean las acciones principales de tu app de Chat en Google Chat y elijan una acción específica con la que quieren interactuar. Para obtener más información, consulta Responde a comandos de barra como una app de Chat.
    Vistas previas de vínculos Patrones de URL que la app de Chat reconoce y para los que proporciona contenido adicional cuando los usuarios envían vínculos Si quieres obtener más información, consulta Cómo obtener una vista previa de los vínculos.
    Visibilidad Hasta 5 personas o uno o más Grupos de Google que puedan ver e instalar tu app de Chat. Usa este campo para probar la app de Chat o compartir la app de Chat con tu equipo. Para obtener más información, consulta Configuración de visibilidad y publicación de tu app de Chat.

  4. Para registrar errores en Cloud Logging cada vez que la app de Chat muestre un error, selecciona la casilla de verificación Registrar errores en Logging. Para obtener más información, consulta los registros de errores de consultas de las apps de Chat.

  5. Haz clic en Guardar. Cuando guardas la configuración de la app de Chat, esta se encuentra disponible para los usuarios especificados de tu organización de Google Workspace.

Vuelve a implementar una app de chat de Apps Script

Para volver a implementar la app de Chat compilada con Apps Script, cambia el número del proyecto de Cloud con el que está asociado el proyecto de Apps Script por el número del proyecto que pertenece al nuevo proyecto de Cloud. Luego, copia tu 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 del 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 administración

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

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

  1. Ve a Apps Script.

    Ir 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 el número de proyecto de GCP, pega el número del 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.

Vuelve a configurar y, luego, implementar la 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 requerida:

    • Nombre de la app: Es el nombre que usan las personas 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 objetivo previsto de la app de Chat que aparece debajo del nombre de esta.

  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 la 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 la página sobre 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 que se compiló con AppSheet en tu nuevo proyecto de Cloud, copia la app 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 Autentícate como una app de Chat.

Comparte tu app de Chat

Antes de que la app de Chat esté disponible para los usuarios en 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 los administradores de Google Workspace instalan apps de Chat.

Cambia a la nueva app de Chat

Ahora que la app de Chat se migró a la organización nueva, es hora de publicitarla. Agrégala a los espacios o mensajes directos de Chat y, luego, quita 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.

    Ir 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 Integraciones y apps.

  4. Haz clic en Agregar apps.

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

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

Quita la app de Chat anterior de los espacios de Chat

  1. Ve a Chat.

    Ir 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 Integraciones y apps.

  4. Junto a la app de Chat anterior sin migrar, 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.

Desactiva la app de Chat anterior

Para impedir que los usuarios usen la app de Chat anterior y motivarlos a usar la nueva app de Chat, desactiva la app de Chat anterior y anula su publicación en Google Workspace Marketplace.