En esta página, se explica cómo compilar un complemento de Google Workspace que funcione en Google Chat con Google Apps Script.
La app de Chat te permite enviar mensajes directos y responde con la repetición de tus mensajes.
En el siguiente diagrama, se muestran 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:
- Un usuario envía un mensaje a una app de Chat, ya sea en un mensaje directo o en un espacio de Chat.
- La lógica de la app de Chat que se implementa en Apps Script, que reside en Google Cloud, recibe y procesa el mensaje.
- De manera opcional, la lógica de la app de Chat se puede integrar con los servicios de Google Workspace, como Calendar o Hojas de cálculo, o con otros servicios de Google, como Google Maps o YouTube.
- La lógica de la app de Chat envía una respuesta al servicio de la app de Chat en Chat.
- 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 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 está abierto, abre el proyecto de Cloud que deseas usar para esta muestra:
- En la consola de Google Cloud, ve a la página Seleccionar un proyecto.
- 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.
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. Configurar 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 adelante.
- En la consola de APIs de Google, ve a Menú > Plataforma de autenticación de Google > Información de la marca.
- Si ya configuraste la plataforma de autenticación de Google, puedes configurar los siguientes parámetros de configuración de la pantalla de consentimiento de OAuth en Información de la marca, Público y Acceso a los datos. Si ves un mensaje que dice Aún no se configuró la plataforma de autenticación de Google, haz clic en Comenzar:
- En Información de la aplicación, en Nombre de la app, ingresa un nombre para la app.
- En Correo electrónico de asistencia al usuario, elige una dirección de correo electrónico de asistencia en la que los usuarios puedan comunicarse contigo si tienen preguntas sobre su consentimiento.
- Haz clic en Siguiente.
- En Público, selecciona Interno.
- Haz clic en Siguiente.
- 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.
- Haz clic en Siguiente.
- 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.
- Haz clic en Continuar.
- Haz clic en Crear.
- Por ahora, puedes omitir la adición de permisos. En el futuro, cuando crees una app para usar fuera de tu organización de Google Workspace, debes 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 guide.
Configura la secuencia de comandos
Para configurar la secuencia de comandos, usa la plantilla de la app de Chat de la página Comenzar de Apps Script.
Crea el proyecto de Apps Script
En la página Comenzar de Apps Script, ve a Iniciadores de complementos de Google Workspace y haz clic en la plantilla App de Chat:
En el nuevo proyecto de Apps Script que se abre, asigna un nombre al proyecto:
Haz clic en Proyecto sin título.
En Título del proyecto, escribe
Add-on Chat app.Haga clic en Cambiar nombre.
En el futuro, si deseas 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 implementación principal, haz lo siguiente:
- En el proyecto de Apps Script de la app de Chat, haz clic en Implementar > Implementaciones de prueba.
- 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:
- En la
consola de APIs, busca
Google Chat API, y haz clic en Google Chat API. - Haz clic en Administrar.
Haz clic en Configuración y configura la app de Chat:
- En el campo Nombre de la app, ingresa
Add-on Chat app. - En el campo URL del avatar, ingresa
https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png. - En el campo Descripción, ingresa
Add-on Chat app. - En Funcionalidad, selecciona Unirse a espacios y conversaciones grupales.
- En Configuración de la conexión, selecciona Proyecto de Apps Script.
- En el campo ID de implementación, pega el ID de implementación principal que copiaste anteriormente.
- En Visibilidad, selecciona Personas y grupos específicos de tu dominio y escribe tu correo electrónico.
- En el campo Nombre de la app, ingresa
Haz clic en Guardar.
La app de Chat está lista para responder a los 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:
Abre Google Chat con la cuenta de Google Workspace que proporcionaste cuando te agregaste como evaluador de confianza.
- Haz clic en Nuevo chat.
- En el campo Agregar 1 o más personas, escribe el nombre de tu app de Chat.
Selecciona tu app de Chat en los resultados. Se abrirá un mensaje directo.
En el nuevo mensaje directo con la app, escribe
Helloy presionaenter.La app de Chat te agradece por agregarla y repite tu mensaje.
Para agregar evaluadores de confianza y obtener más información sobre las pruebas de funciones interactivas, consulta Prueba funciones interactivas para apps de Google Chat.
Solucionar problemas
Cuando una app o tarjeta de Google Chat muestra un error, la interfaz de Chat muestra 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 o tarjeta de Chat produce un resultado inesperado; por ejemplo, es posible que no aparezca un mensaje de tarjeta.
Aunque es posible que no se muestre 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 para ver, depurar y corregir errores, consulta Soluciona y corrige 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.
- En la consola de APIs de Google, ve a la página Administrar recursos. Haz clic en Menú > IAM y administración > Administrar recursos.
- En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar .
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.