Compila una app de Google Chat con Google Apps Script

En esta página, se explica cómo compilar una app de Google Chat con Google Apps Script. La app de Chat te permite enviar mensajes directos 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 puede integrarse 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 la app de Chat.
• Prueba la app de Chat.

Requisitos previos

• Una cuenta de Google Workspace de Business o Enterprise 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 lo hiciste, abre el proyecto de Cloud que usarás 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. 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.

• 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 la 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 registras tu app para que puedas publicarla más adelante.

1. En la consola de APIs de Google, ve a Menú > Plataforma de Google Auth > Desarrollo de la marca.

   Ir a Información de la marca

2. Si ya configuraste Google Auth Platform, puedes establecer los siguientes parámetros de configuración de la pantalla de consentimiento de OAuth en Desarrollo de la marca, Público y Acceso a los datos. Si ves un mensaje que indica que Google Auth Platform aún no se configuró, haz clic en Comenzar:
1. En Información de la app, en Nombre de la app, ingresa un nombre para la app.
2. En Correo electrónico de asistencia del usuario, elige una dirección de correo electrónico de asistencia para que los usuarios se comuniquen contigo si tienen preguntas sobre su consentimiento.
3. Haz clic en Siguiente.
4. En Público, selecciona Interno.
5. Haz clic en Siguiente.
6. En Información de contacto, ingresa una dirección de correo electrónico en la que puedas recibir notificaciones sobre cualquier cambio en tu proyecto.
7. Haz clic en Siguiente.
8. En Finalizar, revisa la Política de Datos del Usuario de los Servicios de las APIs de Google y, si estás de acuerdo, selecciona Acepto la Política de Datos del Usuario de los Servicios de las APIs de Google.
9. Haz clic en Continuar.
10. Haz clic en Crear.
3. Por ahora, puedes omitir agregar permisos. En el futuro, cuando crees una app para usarla fuera de tu organización de Google Workspace, deberás cambiar el Tipo de usuario a Externo. Luego, agrega los permisos de autorización que requiere tu app. Para obtener más información, consulta la guía completa Configura el consentimiento de OAuth.

Configura la secuencia de comandos

Para configurar la secuencia de comandos, usa la plantilla de la app de Chat de la página Getting Started de Apps Script.

Crea el proyecto de Apps Script

1. En la página Cómo comenzar de Apps Script, ve a Activadores para los complementos de Google Workspace y haz clic en la plantilla App de Chat:

   Abrir la plantilla de la app de Chat

2. En el nuevo proyecto de Apps Script que se abre, asígnale el siguiente nombre:

   1. Haz clic en Proyecto sin título.

   2. En Project title, escribe Quickstart app.

   3. Haga clic en Cambiar nombre.

En el futuro, si quieres usar ciertas APIs de Google o publicar tu app, debes asociar tu proyecto de Cloud con tu proyecto de Apps Script. Para esta guía, no es necesario que lo hagas. Para obtener más información, consulta la guía de proyectos de Google Cloud.

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 > Implementaciones de prueba.
2. Copia el ID de implementación principal para usarlo en un paso posterior y haz clic en Listo.

Configura la app de Chat

Sigue estos pasos para configurar la app de Google Chat:

1. En la Consola de APIs, 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/workspace/chat/images/quickstart-app-avatar.png.
   3. En el campo Descripción, ingresa Quickstart app.
   4. En Funcionalidad, selecciona Unirse 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 principal que copiaste antes.
   7. En Visibilidad, selecciona Personas y grupos específicos de tu dominio y escribe 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 Agrega 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 APIs de Google.

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.

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

Solucionar problemas

Cuando una app de Google Chat o una tarjeta devuelven un error, la interfaz de Chat muestra el mensaje "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 de Chat o la tarjeta producen un resultado inesperado; por ejemplo, es posible que no aparezca un mensaje de tarjeta.

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 para las apps de Chat. Para obtener ayuda con la visualización, la depuración y la corrección de 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 de proyecto personalizados. 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 utilizan 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 APIs de Google, ve a la página Administrar recursos. Haz clic en Menú > IAM y administración > Administrar recursos.

   Ir al Administrador de recursos

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

Próximos pasos

• Crea tarjetas interactivas: Los mensajes de tarjeta admiten un diseño definido, elementos interactivos de la IU, como botones, y contenido multimedia enriquecido, como imágenes. Usa los mensajes de tarjeta para presentar información detallada, recopilar información de los usuarios y guiarlos para que den el siguiente paso.
• Responde a los comandos: Los comandos ayudan a los usuarios a descubrir y usar las funciones clave de tu app de Chat.
• Iniciar diálogos: Los diálogos son interfaces basadas en tarjetas con ventanas que tu app puede abrir para interactuar con un usuario. Se pueden encadenar varias tarjetas de forma secuencial, lo que ayuda a los usuarios a completar procesos de varios pasos, como completar los datos de un formulario.
• Codelab: ¿Todo listo para compilar una app de Chat más avanzada? Consulta la app de Chat de comentarios del codelab Compila apps para Google Chat con Gemini.

Apps de Chat que no son complementos: Compila una app de Google Chat con Google Apps Script

Para compilar una app de Chat que no sea un complemento de Google Workspace con Apps Script, sigue estos pasos para crear la secuencia de comandos a partir de la plantilla y configurar la app de Chat que no sea un complemento.

Crea la secuencia de comandos a partir de la plantilla

1. Abrir la plantilla de la app de Chat

2. Haz clic en Proyecto sin título, escribe Quickstart app y, luego, haz clic en Cambiar nombre.

   En el futuro, si quieres usar ciertas APIs de Google o publicar tu app, debes asociar tu proyecto de Cloud con tu proyecto de Apps Script. Para esta guía, no es necesario que lo hagas. Para obtener más información, consulta la guía de proyectos de Google Cloud.

3. En el proyecto de Apps Script de la app de Chat, haz clic en Implementar > Implementaciones de prueba.

4. Copia el ID de implementación principal para usarlo en el siguiente paso y haz clic en Listo.

Configura la app de Chat que no es un complemento

Configura la app de Chat que no es un complemento desde la Consola de APIs:

1. En la Consola de APIs, 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 que no sea un complemento:

   1. Borra Crea esta app de Chat como complemento de Google Workspace. Se abrirá un cuadro de diálogo en el que se te pedirá que confirmes la acción. En el diálogo, haz clic en Inhabilitar.
   2. En el campo Nombre de la app, ingresa Quickstart app.
   3. En el campo URL del avatar, ingresa https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
   4. En el campo Descripción, ingresa Quickstart app.
   5. En Funcionalidad, selecciona Unirse a espacios y conversaciones grupales.
   6. En Configuración de conexión, selecciona Apps Script.
   7. En el campo ID de implementación, pega el ID de implementación principal que copiaste antes.
   8. En Visibilidad, selecciona Personas y grupos específicos de tu dominio y escribe tu correo electrónico.

4. Haz clic en Guardar.