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

Crea una app de Google Chat a la que puedas enviarle mensajes directamente y que responde con el eco de tus mensajes.

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

Arquitectura de una app de Chat implementada con Apps Script

En el diagrama anterior, se muestra cómo un usuario interactúa con una secuencia de comandos de Apps Script. La app de Chat 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 servicios de Google Workspace, como una app de Calendario Hojas de cálculo y otros servicios de Google, como Google Maps o YouTube.
  4. La lógica de la app de Chat envía una respuesta 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 quieres 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 para el proyecto.

Activar 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 aplicaciones que usan OAuth 2.0 requieren una configuración de pantalla de consentimiento. Configurando La pantalla de consentimiento de OAuth de tu app define lo que se muestra a los usuarios y a la app. revisores y registra la app para que puedas publicarla más tarde.

  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. En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.
  3. Completa el formulario de registro de apps y, luego, haz clic en Guardar y continuar.
  4. Por ahora, puedes omitir el paso de agregar 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, debes cambiar el Tipo de usuario a Externo y, luego, agregar los permisos de autorización que requiere tu app.

  5. Revisa el resumen del registro de tu app. Para realizar cambios, haz clic en Editar. Si la aplicación el registro parece estar bien, haz clic en Volver al panel.

Configura la secuencia de comandos

Para configurar la secuencia de comandos, debes usar una plantilla y, a continuación, establecer la de Google Cloud en Apps Script.

Crea la secuencia de comandos a partir de la plantilla

  1. Ve a la sección 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 Proyecto sin título, escribe Quickstart app y Haz clic en Cambiar nombre.

Copia el número del proyecto de la nube

  1. En la consola de Google Cloud, ve a Menú > IAM y Administrador > Configuración.

    Ir a IAM y Configuración del administrador

  2. Copia el valor en el campo Número del proyecto.

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 configuración del proyecto.
  2. En Proyecto de Google Cloud Platform (GCP), haz 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 el proyecto.

Ahora tienes código de app que funciona y que puedes probar (como se describe en el los siguientes pasos) y personalízalos para que cumplan con tus requisitos.

Asegúrate de haber accedido a la Cuenta de Google correcta cuando abras el Plantilla de Apps Script. En ocasiones, 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 podrás usarla 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. > Implementaciones de prueba.
  2. Copia el ID de implementación principal 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. Únete a espacios y conversaciones grupales.
    5. En Configuración de la conexión, selecciona Proyecto de Apps Script.
    6. En el campo ID de implementación, pega el ID de implementación de la cabeza se copió anteriormente.
    7. En Visibilidad, selecciona Personas y grupos específicos de tu dominio y, luego, ingresa tu correo electrónico.
  4. Haz clic en Guardar.

La app de Chat está lista para responder mensajes.

Prueba la app de Chat

Para probar tu app de Chat, abre un espacio de mensaje directo con la app de Chat y envía un mensaje:

  1. Abre Google Chat con la cuenta de Google Workspace que que se proporcionan cuando te agregaste como verificador de confianza.

    Ir a Google Chat

  2. Haz clic en Nuevo chat.
  3. En el campo Add 1 or more people, escribe el nombre de tu App de Chat
  4. Selecciona tu app de Chat en los resultados. Un se abrirá un mensaje.

  5. En el nuevo mensaje directo con la app, escribe Hello. presiona enter.

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

Para agregar verificadores de confianza y obtener más información para probar funciones interactivas, consulta Prueba funciones interactivas para Apps de Google Chat.

Solucionar problemas

Cuando una app de Google Chat o card muestra un error, el En la interfaz de Chat, aparece un mensaje que dice “Se produjo un error”. o "No se pudo procesar la solicitud". A veces, la IU de Chat no muestra ningún mensaje de error, pero la app de Chat la tarjeta produce un resultado inesperado; Por ejemplo, es posible que un mensaje de tarjeta no para que aparezca la opción.

Aunque es posible que no aparezca un mensaje de error en la IU de Chat, Hay mensajes de error descriptivos y datos de registro disponibles para ayudarte a corregir errores. Cuando se activa el registro de errores de las apps de Chat. Para obtener ayuda sobre la visualización, la depuración y la corrección de errores, consulta Soluciona problemas y corrige errores de Google Chat.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por el recursos usados en este instructivo, te recomendamos que borres el Cloud.

  1. En la consola de Google Cloud, ve a la página Administrar recursos. Haz clic en Menú > IAM y Administrador > Administrar recursos.

    Ir a Resource Manager

  2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borra .
  3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo. el proyecto.

Próximos pasos

  • Crea tarjetas interactivas – Tarjeta mensajes admiten un diseño definido, elementos interactivos de la interfaz de usuario, como botones, y como imágenes, rich media. Usa mensajes de tarjeta para presentar información detallada, recopilar información de los usuarios y guiarlos a dar el siguiente paso.
  • Compatibilidad con los comandos de barra: los comandos de barra te permiten Registrar y anunciar comandos específicos que los usuarios pueden dar a su aplicación escribiendo un comando que comience con una barra diagonal (/), como /help.
  • Diálogos de inicio: Los diálogos se organizan en ventanas y se basan en tarjetas. interfaces que tu app puede abrir para interactuar con un usuario. Varias tarjetas se pueden combinar de forma secuencial, lo que ayuda a los usuarios a completar procesos, como completar formularios.
  • Codelab: Todo listo para compilar una experiencia más avanzada App de Chat Ver los comentarios App de Chat del codelab Compila apps para Google Chat con Gemini.