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

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

Objetivos

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

Requisitos previos

Configura tu 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 este ejemplo:

  1. Ve a la consola de Google Cloud.
  2. Junto a Google Cloud, haz clic en la flecha hacia abajo . Aparecerá un diálogo en el que se enumeran los proyectos actuales.
  3. Selecciona tu proyecto y haz clic en Open. La consola abre tu proyecto.

Activa la API de Chat

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

Todas las aplicaciones 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 los revisores de apps, y registra tu app para que puedas publicarla más tarde.

  1. En tu proyecto de Google Cloud, ve a Menú > 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 alcances de autorización que requiere tu app.
  5. Si seleccionaste Externo como tipo de usuario, agrega los usuarios de prueba:
    1. En Usuarios de prueba, haga 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 aplicación es satisfactorio, haga clic en Volver al panel de control.

Configure 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 desde la plantilla

  1. Ve a la página de introducción de Apps Script.
  2. Haz clic en la plantilla App de Chat. Es posible que debas desplazarte hacia abajo para ver esta plantilla.
  3. Haz clic en Untitled project, escribe Quickstart app y, luego, haz clic en Rename.

Copia el número del proyecto de Cloud

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

Configure el proyecto de Cloud de su proyecto de Apps Script

  1. En el proyecto de Apps Script de la app de Chat, haz clic en Configuración del proyecto Ícono de la 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, pega el número de proyecto de Google Cloud.
  4. Haz clic en Establecer proyecto.

Ahora tienes código de la app que funciona y que puedes probar (como se describe en los siguientes pasos) y, luego, personalizarlo para cumplir 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 lo notes.

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 de Apps Script de la app de Chat, haz clic en Implementar > Probar implementaciones.
  2. Copie el ID de la implementación principal para utilizarlo en un paso posterior y haga clic en Listo.

Publica la app de Chat

Publique la aplicación de Chat desde Google Cloud Console.

  1. En Google Cloud Console, busca Google Chat API y haz clic en API de Google Chat.
  2. Haz clic en Administrar.
  3. Haga clic en Configuración y configure la aplicación 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 conexión, selecciona Proyecto de Apps Script y pega el ID de implementación en el campo.
    6. En Permisos, 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 App status, establece el estado en Live - available to users.

  6. Haz clic en Guardar.

La app de Chat está lista para responder mensajes.

Ejecuta la secuencia de comandos:

  1. Abra Chat.
  2. Envíe un nuevo mensaje directo a la aplicación haciendo clic en Iniciar un chat > Buscar aplicaciones.
  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 tarjetas admiten un diseño definido, elementos de IU interactivos, como botones, y rich media, como imágenes. Usa los mensajes de tarjeta para presentar información detallada, recopilar información de los usuarios y guiarlos para dar el siguiente paso.
  • Comandos de barra de compatibilidad: Los comandos de barra te permiten registrar y anunciar comandos específicos que los usuarios pueden darle a tu app mediante el uso de un comando que comienza con una barra diagonal (/), como /help.
  • Diálogos de lanzamiento: Los diálogos son interfaces con ventanas y basadas en tarjetas que tu app puede abrir para interactuar con un usuario. Se pueden unir varias tarjetas de forma secuencial, lo que ayuda a los usuarios a completar procesos de varios pasos, como completar datos de formularios.