Guía de inicio rápido de la app de Chat de Google Apps Script

Crea una app de Google Chat a la que puedas enviar mensajes y que responda con un eco de los mensajes.

Objetivos

• Configurar el entorno
• Configure la secuencia de comandos.
• Publica la app.
• Ejecuta la secuencia de comandos.

Requisitos previos

• Una cuenta de Google Workspace con acceso a Chat
• Un proyecto de Google Cloud

Configure su entorno

Abre tu proyecto de Cloud en Google Cloud Console

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 Selecciona un proyecto.

   Selecciona un proyecto de Cloud

2. Selecciona el proyecto de Google Cloud que deseas usar. También puedes hacer clic en Crear proyecto y seguir las instrucciones en pantalla. Si creas un proyecto de Google Cloud, es posible que debas activar la facturación del proyecto.

Activa la API de Chat

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

• En la consola de Google Cloud, habilita la API de Google Chat.

  Habilitar la API

Cómo configurar la pantalla de consentimiento de OAuth

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

1. En la consola de Google Cloud, ve al menú menu > API y servicios > Pantalla de consentimiento de OAuth.

   Ir a la pantalla de consentimiento de OAuth

2. Seleccione el tipo de usuario para su aplicación y, luego, haga clic en Crear.
3. Complete el formulario de registro de la aplicación y, luego, haga clic en Guardar y continuar.

4. Por ahora, puedes omitir el agregado 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 requiere tu app.

5. Si seleccionaste Externo para 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 cualquier otro usuario de prueba autorizado. Luego, haz clic en Guardar y continuar.
6. Revisa el resumen de 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.

Configure la secuencia de comandos

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

Cree la secuencia de comandos a partir de la plantilla

1. Ve a la página Cómo comenzar de Apps Script.
2. Haz clic en la plantilla App de chat. Es posible que debas desplazarte para ver esta plantilla.
3. Haz clic en Untitled project, escribe Quickstart app y haz clic en Rename.

Copia el número de proyecto de Cloud

1. Ve a tu proyecto de Cloud en Google Cloud Console.
2. Haz clic en Configuración y utilidades more_vert > Configuración del proyecto.
3. Copia el Número de proyecto.

Configura el proyecto de Cloud de Apps Script

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

Ahora tienes un código de la app en funcionamiento que puedes probar (como se describe en los siguientes pasos) y, luego, personalizarlo para que cumpla con tus requisitos.

Asegúrate de haber accedido a la Cuenta de Google correcta cuando abras la plantilla de Apps Script. 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 a fin de poder usarlo en el siguiente paso.

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

1. En el proyecto de Apps Script de la app de Chat, haz clic en Implementar > Implementaciones de prueba.
2. Copie el ID de implementación principal para usarlo en un paso posterior y haga 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 Connection settings, selecciona Apps Script project y pega el ID de implementación en el campo.
   6. En Permisos, selecciona Personas y grupos específicos y, luego, ingresa tu correo electrónico.

4. Haga clic en Guardar y actualice la página.

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

6. Haz clic en Guardar.

La app de Chat está lista para responder mensajes.

Ejecuta la secuencia de comandos:

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

La aplicación le agradece por agregarla y repite su mensaje.

Próximos pasos

• Crea tarjetas interactivas: Los mensajes de las 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 un paso más.
• Admite comandos de barra: Los comandos de barra te permiten registrar y anunciar comandos específicos que los usuarios pueden dar a tu app si escribes un comando que comienza con una barra diagonal (/), como /help.
• Diálogos de lanzamiento: Los diálogos son interfaces basadas en tarjetas y con ventanas que tu app puede abrir para interactuar con un usuario. Se pueden unir varias tarjetas de manera secuencial, lo que ayuda a los usuarios a completar procesos de varios pasos, como completar datos de formularios.