Compila una app de Google Chat con Google Apps Script

Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.

En esta página, se explica cómo compilar un complemento de Google Workspace que funcione en Google Chat con Google Apps Script. En Google Chat, los complementos aparecen para los usuarios como apps de Google Chat. Para obtener más información, consulta la descripción general de la extensión de Google Chat.

La app de Chat te permite enviar mensajes directamente y responde repitiendo tus mensajes.

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

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 Calendario o Hojas de cálculo, o en 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

• Configura el entorno.
• Configura la secuencia de comandos.
• Configura un complemento de Google Workspace para la app de Chat.
• Prueba la app de Chat.

Requisitos previos

• Una cuenta de Google Workspace para empresas o empresas con acceso a Google Chat
• Un proyecto de Google Cloud, Para crear uno, consulta Crea un proyecto de Google Cloud.

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

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. También puedes hacer clic en Create project y seguir 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.

• 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. Cuando configuras la pantalla de consentimiento de OAuth de tu app, defines lo que se muestra a los usuarios y revisores de apps, y también registras tu 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. En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.
3. Completa el formulario de registro de la app y, luego, haz clic en Guardar y continuar.

4. Por ahora, puedes omitir 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 el registro de la app parece correcto, haz clic en Volver al panel.

Configura la secuencia de comandos

Para configurar la secuencia de comandos, crea una copia del proyecto de la guía de inicio rápido y, luego, configura tu proyecto de Cloud en Apps Script.

Crea una copia del proyecto de la guía de inicio rápido

1. Haz clic en el siguiente botón para abrir el proyecto de Apps Script del complemento en Google Chat.
   Abre el proyecto
2. Haz clic en Descripción general.
3. En la página de descripción general, haz clic en Crear una copia.

4. Asigna un nombre a tu copia del proyecto de Apps Script:

   1. Haz clic en Copia de la app de chat de complementos.

   2. En Título del proyecto, escribe Add-on Chat app.

   3. Haga 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 administrador

2. En el campo Número del 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 .
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 un código de app que funciona y que puedes probar (como se describe en los siguientes pasos) y, luego, personalizar para cumplir con tus requisitos.

Asegúrate de haber accedido a la Cuenta de Google correcta cuando abras el proyecto 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, de modo que puedas 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 > Probar implementaciones.
2. Copia el ID de implementación principal para usarlo en un paso posterior y haz clic en Listo.

Configura el complemento

Con tu implementación de Apps Script, sigue estos pasos para crear un complemento y, luego, implementar la app de Google Chat:

1. En la consola, 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 Add-on Chat app.
   2. En el campo Avatar URL, ingresa https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. En el campo Descripción, ingresa Add-on Chat 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.
   6. En el campo ID de implementación, pega el ID de implementación principal que copiaste 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 mensajes directos con la app de Chat y envía un mensaje:

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

   Ve a Google Chat

2. Haz clic en Nuevo chat.
3. En el campo Agregar 1 o más personas, escribe el nombre de tu app de Chat.

4. Selecciona tu app de Chat en los resultados. Se abrirá un mensaje directo.

   Nota: Si no ves tu app de Chat en la lista de resultados, asegúrate de haber incluido tu cuenta de Google Workspace en la configuración de Visibilidad de la página Configuración de la API de Chat en la consola de Google Cloud.

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

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

Para agregar verificadores de confianza y obtener más información sobre cómo probar funciones interactivas, consulta Cómo probar funciones interactivas para apps de Google Chat.

Solucionar problemas

Cuando una app de Google Chat o una tarjeta muestran un error, la interfaz de Chat muestra un mensaje que dice "Se produjo un error". o "No se puede procesar tu solicitud". A veces, la IU de Chat no muestra ningún mensaje de error, pero la app o la tarjeta de Chat producen un resultado inesperado. Por ejemplo, es posible que no aparezca un mensaje de la tarjeta.

Aunque es posible que no se muestre un mensaje de error en la IU de Chat, los mensajes de error descriptivos y los datos de registro están disponibles para ayudarte a corregir errores cuando se activa el registro de errores de las apps de Chat. Si necesitas ayuda para ver, depurar y corregir errores, consulta Cómo solucionar problemas y corregir errores de Google Chat.

Limpia

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

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• Se borra todo en el proyecto. Si utilizaste un proyecto existente para este instructivo, cuando lo borres, también borrarás cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL en appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de todo el proyecto.

Si planeas explorar varios instructivos y guías de inicio rápido, la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

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

   Ve al Administrador de recursos.

2. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar .
3. En el cuadro de diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo.