Guía de personalización de la app de Lara AI en Google Chat

En este artículo vamos a ver cómo crear en Google Cloud una app de Google Chat propia, con el nombre y el avatar que elija la organización, para que Lara AI converse con los colaboradores desde ahí. El proceso tiene seis pasos: crear el proyecto, configurar la pantalla de consentimiento, habilitar Google Chat API, configurar la app, habilitar Google Workspace Marketplace SDK y publicar la app.

Está pensado para la persona o el equipo de IT que administra Google Workspace: quien haga la configuración necesita ser administrador de Google Workspace (idealmente superadministrador) y tener permiso para crear proyectos en Google Cloud dentro de la organización.

Dónde se hace: Consola de Google Cloud.

Requisitos previos

• Una cuenta de Google Workspace.
• Una cuenta de Google Cloud.
• La imagen de perfil del bot publicada en internet (lo habitual es subirla a la web de la empresa o a un servidor propio), con su link a mano. Es la foto que los colaboradores van a ver junto al nombre en Google Chat. Google no permite subir el archivo, sino que la toma desde un link, que tiene que cumplir tres condiciones:
  • Ser público: cualquiera tiene que poder abrirlo sin iniciar sesión.
  • Apuntar directo a la imagen: al abrirlo en el navegador se tiene que ver solo la imagen, idealmente con una dirección terminada en .png o .jpg. Los links para compartir de Google Drive no sirven, porque abren una vista previa y no la imagen.
  • Ser cuadrada y de al menos 256 × 256 px, porque Google la muestra recortada en un círculo.
• Las imágenes para la ficha de la app en el Marketplace, que se cargan en el paso 6:
  • Ícono de la app en 32 × 32 px y 128 × 128 px (obligatorios). También se puede cargar en 48 × 48 px y 96 × 96 px, que son opcionales.
  • Card banner de 220 × 140 px (obligatorio): es la imagen de portada que aparece en la tarjeta de la app dentro de Google Workspace Marketplace, donde los colaboradores la buscan para instalarla.

Paso 1: Crear el proyecto en Google Cloud

1. Entrar a la consola de Google Cloud y crear un proyecto nuevo desde https://console.cloud.google.com/projectcreate.
2. Poner como nombre del proyecto lara-google-chat.

   

3. Una vez creado, seleccionar el proyecto.

   

   

Paso 2: Configurar la pantalla de consentimiento (OAuth)

1. En el menú de navegación, entrar a OAuth consent screen.

   

2. Clickear en Get Started.

   

3. Completar los datos de la app y clickear en Next:

   

   • App name: el nombre del bot.
   • User support email: el mail del equipo o la persona de IT.
4. En la siguiente pantalla, seleccionar Internal y clickear en Next.

   

5. Después, completar el mail del equipo o la persona de IT.

   

6. Aceptar los términos y condiciones y clickear en Continue y luego en Create.

   

Paso 3: Habilitar Google Chat API y crear la Service Account

1. En el menú de navegación, entrar a APIs & Services → Enabled APIs & services.

   

2. Clickear en + ENABLE APIS AND SERVICES.

   

3. Buscar Google Chat API y habilitarla.

   

   

4. Se abrirá una pantalla similar a esta. En la pestaña CREDENTIALS, clickear en + CREATE CREDENTIALS → Service Account

   
   
   

5. Completar el formulario y clickear en CREATE:
   • Service account name: el nombre del bot.
   • Service account ID: se completa solo a partir del nombre.
   • Service account description, Permissions y Principals with access: dejar vacíos.

6. 

7. Se vuelve a la pantalla anterior, ahora con la Service Account en el listado. Clickear sobre ella.

   

8. En la pestaña Keys, clickear en Add Key → Create new key.

   

9. Elegir el formato JSON. El archivo con la clave se descarga automáticamente.

   

10. Enviar ese archivo a secrets@meetlara.aiy después eliminarlo de la computadora de forma segura.

    
    

Paso 4: Configurar la app de Google Chat

1. Dentro de Google Chat API, entrar a la pestaña CONFIGURATION.

   

2. Desmarcar la opción Build this Chat app as a Workspace add-on. En el aviso que aparece, clickear en Disable.

   

   

3. Completar el formulario con estos datos:
   • App name: el nombre del bot.
   • Avatar URL: el link a la imagen de perfil del bot (ver Requisitos previos).
   • Description: Tu asistente personal de IA.
   • Enable interactive features: habilitado.
   • Functionality → Receive 1:1 messages: habilitado.
   • Functionality → Join spaces and group conversations: deshabilitado.
   • Functionality → Support App Home: deshabilitado.
   • Connection settings: elegir App URL.
   • App URL: cargar el link que envió el equipo de Lara AI. Tiene este formato: https://chats.meetlara.ai/gchat/<uuid>/messages
   • Authentication Audience: elegir HTTP endpoint URL.
   • Slash commands y Link previews: dejar vacíos.
   • Visibility → Make this Chat app available to specific people and groups: deshabilitado.
   • Logs → Log errors to Logging: deshabilitado.
   • Clickear en SAVE.

     

     

     

Paso 5: Habilitar Google Workspace Marketplace SDK

1. En el menú de navegación, volver a APIs & Services → Enabled APIs & services.

   

2. Clickear en + ENABLE APIS AND SERVICES.

   

3. Buscar Google Workspace Marketplace SDKy habilitarlo.

   

   

4. Se abrirá una pantalla similar a esta, donde aparece la credencial creada en el paso 3:

   

5. Entrar a la pestaña APP CONFIGURATION.

   

6. Completar el formulario con estos datos:
   • App visibility: Private.
   • Unlisted: deshabilitado.
   • Installation settings: Individual + Admin Install.
   • App Integration: habilitar solo Chat App.
   • OAuth Scopes: dejar los que vienen definidos (https://www.googleapis.com/auth/userinfo.email y https://www.googleapis.com/auth/userinfo.profile).
   • Developer Name: Lara AI.
   • Developer Website URL: https://meetlara.ai
   • Developer Email: tech@meetlara.ai
   • Application website URL: https://meetlara.ai
7. Clickear en SAVE.

   

   

   

Paso 6: Completar la ficha de la app y publicarla

1. Entrar a la pestaña STORE LISTING.

   

2. En App details, abrir el desplegable English - Lara AI y cambiarlo a Spanish. Copiar la Short description en Detailed description y clickear en DONE. Si hace falta, se puede repetir con otros idiomas.
3. Completar el resto del formulario:
   • Pricing: Free of charge.
   • Category: HR and Legal.
   • Graphic assets: subir los íconos y el card banner (ver Requisitos previos).
   • Screenshots: subir estas tres imágenes: captura 1, captura 2 y captura 3.
   • YouTube promo videos: dejar vacío.
   • Terms of service URL: https://meetlara.ai/terms-eng/
   • Privacy policy URL: https://meetlara.ai/privacy-eng/
   • Support URL: https://help.meetlara.ai/
   • Setup URL, Admin config URL, Help URL y Report issue URL: dejar vacíos.
   • Distribution → All regions: marcado.
4. Clickear en PUBLISH.

   

   

   

5. Si todo está bien, aparecerá la URL de la app en el Marketplace, desde donde se va a poder instalar en Google Chat.

   

6. Al abrir esa URL se verá la app lista para instalar.

   

⚠️ Importante: no instalar la app todavía

Antes de instalarla, el equipo de Lara AI tiene que terminar la configuración y registrar las credenciales de su lado.

Ante cualquier duda o inconveniente, por favor contactarse con soporte@meetlara.ai.