Compila una app de Google Chat con Google Apps Script

Crea una app de Google Chat a la que puedas enviar mensajes directamente y que responda con una repetición de tus mensajes.

En el siguiente diagrama, se muestran el patrón de arquitectura y mensajería:

Arquitectura de una app de Chat implementada con Apps Script

En el diagrama anterior, un usuario que interactúa con una app de chat de Apps Script tiene el siguiente flujo de información:

  1. Un usuario envía un mensaje a una app de Chat, ya sea en un mensaje directo o en un espacio de Chat.
  2. La lógica de la app de Chat que se implementa en Apps Script, que reside en Google Cloud, recibe y procesa el mensaje.
  3. De manera opcional, la lógica de la app de Chat se puede integrar en los servicios de Google Workspace, como Hojas de cálculo o Calendario, o bien otros servicios de Google, como Google Maps o YouTube.
  4. La lógica de la app de Chat envía una respuesta al servicio de la app de Chat en Chat.
  5. La respuesta se entrega al usuario.

Objetivos

  • Configurar el entorno
  • Configura la secuencia de comandos.
  • Publica la app de Chat.
  • Prueba la app de Chat.

Requisitos previos

Configura tu entorno

Abre tu proyecto de Cloud en la consola de Google Cloud.

Si aún no está abierto, abre el proyecto de Cloud que deseas usar para esta muestra:

  1. En la consola de Google Cloud, ve a la página Seleccionar un proyecto.

    Selecciona un proyecto de Cloud

  2. Selecciona el proyecto de Google Cloud que deseas usar. O bien, haz clic en Crear proyecto y sigue las instrucciones en pantalla. Si creas un proyecto de Google Cloud, es posible que debas activar la facturación para el proyecto.

Activa la API de Chat

Antes de usar las APIs de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más APIs en un solo proyecto de Google Cloud.

Todas las apps que usan OAuth 2.0 requieren una configuración de la pantalla de consentimiento. Si configuras la pantalla de consentimiento de OAuth de tu app, se define qué se muestra a los usuarios y los revisores de la app, y se registra la app para que puedas publicarla más adelante.

  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. Por ahora, puedes omitir la adición de permisos y hacer clic en Guardar y continuar. En el futuro, cuando crees una app para usarla fuera de tu organización de Google Workspace, deberás agregar y verificar los permisos de autorización que requiera tu app.

  5. 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.
  6. 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.

Configura la secuencia de comandos

Para configurar la secuencia de comandos, usa una plantilla y, luego, configura tu proyecto de Cloud en Apps Script.

Crea la secuencia de comandos a partir de la plantilla

  1. Ve a la página Primeros pasos de Apps Script.
  2. Haz clic en la plantilla App de Chat. Es posible que tengas que desplazarte hacia abajo para ver esta plantilla.
  3. Haz clic en Proyecto sin título, escribe Quickstart app y haz clic en Cambiar nombre.

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 proyecto de Cloud del proyecto de Apps Script

  1. En el proyecto de Apps Script de la app de Chat, haz clic en Configuración del proyecto El ícono de la configuración del proyecto.
  2. En Proyecto de Google Cloud Platform (GCP), haz clic en Cambiar proyecto.
  3. En el número de proyecto de GCP, pega el número del proyecto de Google Cloud.
  4. Haz clic en Establecer el proyecto.

Ahora tienes el código de la app que funciona y que puedes probar (como se describe en los siguientes pasos) y, luego, personalizar para cumplir con tus requisitos.

Cuando abras la plantilla de Apps Script, asegúrate de haber accedido a la Cuenta de Google correcta. A veces, la cuenta actual puede cambiar a tu cuenta predeterminada sin que te des cuenta.

Crea una implementación de prueba

Necesitas un ID de implementación para este proyecto de Apps Script de modo que puedas usarlo en el siguiente paso.

Para obtener el ID de implementación principal, haz lo siguiente:

  1. En el proyecto Apps Script de la app de Chat, haz clic en Implementar > Implementaciones de prueba.
  2. Copia el ID de implementación del encabezado para usarlo en un paso posterior y haz clic en Listo.

Publica la app de Chat

Publica la app de Chat desde la consola de Google Cloud.

  1. En la consola de Google Cloud, busca Google Chat API y haz clic en API de Google Chat.
  2. Haz clic en Administrar.
  3. Haz clic en Configuración y configura la app de Chat:

    1. En el campo Nombre de la app, ingresa Quickstart app.
    2. En el campo URL del avatar, ingresa https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. En el campo Descripción, ingresa Quickstart app.
    4. En Funcionalidad, selecciona Recibir mensajes 1:1 y Unirse a espacios y conversaciones grupales.
    5. En Configuración de la conexión, selecciona Proyecto de Apps Script y pega el ID de implementación en el campo.
    6. En Visibilidad, selecciona Personas y grupos específicos de tu dominio y, luego, ingresa tu correo electrónico.
  4. Haz clic en Guardar y actualiza la página.

  5. En la página de configuración, en Estado de la app, configura el estado como En vivo: disponible para los usuarios.

  6. Haz clic en Guardar.

La app de Chat está lista para responder mensajes.

Prueba la app de Chat

  1. Abre Chat.
  2. Envía un nuevo mensaje directo a la app haciendo clic en Iniciar un chat > Buscar apps.
  3. En la página Buscar apps, busca Quickstart App.
  4. Junto a Guía de inicio rápido, haz clic en Chat.
  5. En el nuevo mensaje directo con la app, escribe Hello y presiona enter.

La app de Chat te agradece por agregarla y repite tu mensaje.

Si quieres agregar verificadores de confianza y obtener más información para probar las funciones interactivas, consulta Prueba las funciones interactivas en las apps de Google Chat.

Próximos pasos

  • Crea tarjetas interactivas: Los mensajes de tarjetas admiten un diseño definido, elementos de IU interactivos, como botones, y rich media, como imágenes. Usa mensajes de tarjetas para presentar información detallada, recopilar información de los usuarios y guiarlos a dar el siguiente paso.
  • Compatibilidad con comandos de barra: Los comandos de barra te permiten registrar y anunciar comandos específicos que los usuarios pueden darle a tu app escribiendo un comando que comience con una barra diagonal (/), como /help.
  • Diálogos de lanzamiento: Los diálogos son interfaces con ventanas basadas en tarjetas que tu app puede abrir para interactuar con un usuario. Se pueden combinar varias tarjetas de forma secuencial, lo que ayuda a los usuarios a completar procesos de varios pasos, como completar datos de formularios.