En este instructivo, se muestra cómo compilar una app de Google Chat que ayude Los usuarios de Google Chat administran sus contactos personales y empresariales. Para recopilar la app de Chat les pedirá a los usuarios que completen un formulario de contacto en los mensajes y diálogos de tarjetas.
Mira la app de Chat en acción:
-
Figura 2: El Chat abre un diálogo en el que los usuarios ingresar información sobre un contacto -
Figura 3: El la app de Chat devuelve un diálogo de confirmación que los usuarios puedan revisar y confirmar la información antes en el envío. -
Figura 4: Después de que el usuario envía el formulario, la app de Chat envía un mensaje de texto privado para confirmar el envío. -
Figura 5: El La app de Chat también les solicita a los usuarios que agreguen un contacto desde una tarjeta en un mensaje.
Requisitos previos
- Una empresa o empresa de Google Workspace con acceso a Google Chat.
Objetivos
- Diseña y compila interfaces de usuario (IU) como objetos
card
, y muestra las IUs en mensajes y diálogos. - Recibe y procesa la información que envían los usuarios a través de widgets de entrada de formulario.
- Para responder a los comandos de barra, envía mensajes que contienen texto, tarjetas y widgets de accesorios.
Arquitectura
La app de Chat está integrada Google Apps Script y utiliza eventos de interacción para procesar y responder a los usuarios de Chat.
A continuación, se muestra cómo un usuario podría interactuar normalmente con la App de Chat:
Un usuario abre un mensaje directo con la app de Chat. agrega la app de Chat a un espacio existente.
La app de Chat le solicita al usuario que agregue un contacto crea y muestra un formulario de contacto como
card
. Para presentar el formulario de contacto, la app de Chat responde a los usuarios de las siguientes maneras:- Responde a @menciones y mensajes directos con un mensaje de tarjeta que contiene el formulario de contacto.
- Responde al comando de barra
/addContact
abriendo un diálogo con el formulario de contacto. - Responde al comando de barra
/about
con un mensaje de texto que tiene un botón Agregar un contacto en el que los usuarios pueden hacer clic para abrir un diálogo con el formulario de contacto.
Cuando se le presenta el formulario de contacto, el usuario ingresa la información de contacto. en los siguientes campos y widgets:
- Nombre y apellido: Es un widget
textInput
que acepta cadenas. - Fecha de nacimiento: Es un widget
dateTimePicker
que solo acepta fechas. - Tipo de contacto: Es un widget
selectionInput
de botones de selección que permite a los usuarios seleccionar y enviar un solo valor de cadena (Personal
oWork
). - Botón Revisar y enviar: Es un array
buttonList
con el widgetbutton
en el que el usuario hace clic para enviar los valores que ingresa.
- Nombre y apellido: Es un widget
La app de Google Chat controla un evento de interacción
CARD_CLICKED
para procesar los valores que ingresa el usuario y mostrarlos en una tarjeta de confirmación.El usuario revisa la tarjeta de confirmación y hace clic en el botón Enviar. para finalizar la información de contacto.
La app de Google Chat envía un mensaje de texto privado que confirma el envío.
Prepare el entorno
En esta sección, se muestra cómo crear y configurar un proyecto de Google Cloud para la App de Chat
Crea un proyecto de Google Cloud
Consola de Google Cloud
- En la consola de Google Cloud, ve a Menú > IAM y Administrador > Crear un proyecto.
-
En el campo Nombre del proyecto, ingresa un nombre descriptivo para tu proyecto.
Opcional: Para editar el ID del proyecto, haz clic en Editar. No se puede cambiar el ID del proyecto una vez creado el proyecto, así que elige un ID que se adapte a tus necesidades durante el ciclo de vida del en un proyecto final.
- En el campo Ubicación, haz clic en Explorar para mostrar las posibles ubicaciones de tu en un proyecto final. Luego, haga clic en Seleccionar.
- Haz clic en Crear. La consola de Google Cloud navega a la página Panel y se crea tu proyecto en pocos minutos.
gcloud CLI
En uno de los siguientes entornos de desarrollo, accede a Google Cloud CLI (gcloud
):
-
Cloud Shell: Para usar una terminal en línea con la CLI de gcloud ya configurada, activa Cloud Shell.
Activar Cloud Shell -
Local Shell: Para usar un entorno de desarrollo local,
instalar y
inicializar
con gcloud CLI.
Para crear un proyecto de Cloud, usa el comandogcloud projects create
: Reemplaza PROJECT_ID mediante la configuración del ID del proyecto que deseas crear.gcloud projects create PROJECT_ID
Configura la autenticación y la autorización
Las apps de Google Chat requieren que configures una la pantalla de consentimiento de OAuth para los usuarios pueden autorizar tu app en aplicaciones de Google Workspace, incluidas Google Chat.
En este instructivo, implementarás una app de chat solo para pruebas y uso interno, por lo que está bien usar información de marcador de posición para la pantalla de consentimiento. Antes de publicar la app de Chat, reemplaza la información de los marcadores de posición por información real.
En la consola de Google Cloud, ve a Menú > APIs y Servicios > Pantalla de consentimiento de OAuth.
En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.
En Nombre de la app, escribe
Contact Manager
.En Correo electrónico de asistencia al usuario, selecciona tu dirección de correo electrónico o un Grupo de Google apropiado.
En Información de contacto del desarrollador, ingresa tu dirección de correo electrónico.
Haga clic en Guardar y continuar.
En la página Permisos, haz clic en Guardar y continuar. (El la app de Chat no requiere ningún permiso de OAuth).
Revisa el resumen y, luego, haz clic en Volver al panel.
Crea y, luego, implementa la app de Chat
En la siguiente sección, copiarás y actualizarás un Proyecto de Apps Script que contiene toda la aplicación necesaria de Google Chat para tu app de Chat, de modo que no es necesario copiar y pegar cada archivo.
De manera opcional, puedes ver el proyecto completo en GitHub.
A continuación, se incluye una descripción general de cada archivo:
main.gs
Controla toda la lógica de la app, incluidos los eventos de interacción sobre cuándo los usuarios envían mensajes a la app de Chat, haz clic en botones de un mensaje de la app de Chat o abrir y cerrar diálogos.
Ver código de
main.gs
contactForm.gs
Contiene los widgets que reciben datos de formularios de los usuarios. Ingresa el formulario los widgets se muestran en tarjetas que aparecen en mensajes y diálogos.
Ver código de
contactForm.gs
appsscript.json
El manifiesto de Apps Script que define y configura el proyecto de Apps Script para la app de Chat
Ver código de
appsscript.json
Busca el número y el ID de tu proyecto de Cloud
En la consola de Google Cloud, ve a tu proyecto de Cloud.
Haz clic en Configuración y utilidades > Configuración del proyecto.
Anota los valores de los campos Número de proyecto y ID de proyecto. Los usarás en las siguientes secciones.
Crea el proyecto de Apps Script
Para crear un proyecto de Apps Script y conectarlo a tu Proyecto de Cloud:
- Haz clic en el siguiente botón para abrir el proyecto de Apps Script Administrar contactos en Google Chat.
Abrir el proyecto - Haz clic en Descripción general.
- En la página de descripción general, haz clic en Crear una copia.
Asigna un nombre a tu copia del proyecto de Apps Script:
Haz clic en Copia de Administrar contactos en Google Chat.
En Título del proyecto, escribe
Contact Manager - Google Chat app
.Haga clic en Cambiar nombre.
Configura el proyecto de Cloud del proyecto de Apps Script
- En tu proyecto de Apps Script, Haz clic en Project Settings.
- En Proyecto de Google Cloud Platform (GCP), haz clic en Cambiar proyecto.
- En Número de proyecto de GCP, pega el número de tu proyecto de Cloud.
- Haz clic en Establecer el proyecto. El proyecto de Cloud y Apps Script proyecto están ahora conectados.
Crea una implementación de Apps Script
Ahora que está listo todo el código, implementa Apps Script en un proyecto final. El ID de implementación se usa para configurar App de Chat en Google Cloud.
En Apps Script, abre la ventana de la app de Chat en un proyecto final.
Haz clic en Implementar > Implementación nueva.
Si Complemento aún no está seleccionado, junto a Selecciona el tipo, haz clic en los tipos de implementación y selecciona Complemento.
En Descripción, ingresa una descripción para esta versión, como
Test of Contact Manager
Haz clic en Implementar. Se realizaron correctamente los informes de Apps Script Deployment y proporciona un ID de implementación.
Haz clic en
Copiar para copiar. el ID de implementación y, luego, haz clic en Listo.
Configura la app de Chat en la consola de Google Cloud
En esta sección, se muestra cómo configurar la API de Google Chat en la consola de Google Cloud con información sobre la app de Chat, incluida la ID de la implementación que acabas de crear desde Apps Script en un proyecto final.
En la consola de Google Cloud, haz clic en Menú > Más productos > Google Workspace > Biblioteca de productos > API de Google Chat > Administrar > Configuración.
En Nombre de la app, escribe
Contact Manager
.En URL del avatar, escribe
https://developers.google.com/chat/images/contact-icon.png
.En Description, escribe
Manage your personal and business contacts
.Haz clic en el botón de activación Enable Interactive features.
En Funcionalidad, selecciona las casillas de verificación Recibir mensajes 1:1 y, Únete a espacios y conversaciones grupales.
En Configuración de la conexión, selecciona Apps Script.
En ID de implementación, pega el ID de implementación de Apps Script que copiaste en la sección anterior cuando creaste la implementación de Apps Script.
En Comandos de barra, configura los comandos de barra
/about
y/addContact
:- Haz clic en Agregar un comando de barra para configurar el primer comando de barra.
- En Nombre, escribe
/about
. - En ID de comando, escribe
1
. - En Descripción, escribe
Learn how to use this Chat app to manage your contacts
. - Selecciona Abrir un diálogo.
- Haz clic en Listo.
- Haz clic en Agregar un comando de barra para configurar otro comando de barra.
- En Name, escribe
/addContact
. - En ID de comando, escribe
2
. - En Description, escribe
Submit information about a contact
- Selecciona Abrir un diálogo.
- Haz clic en Listo.
En Visibilidad, selecciona la Haz que esta app de Chat esté disponible para personas y grupos específicos en la casilla de verificación YOUR DOMAIN y, luego, ingresa tu dirección de correo electrónico.
En Registros, selecciona Registrar errores en Logging.
Haz clic en Guardar. Aparecerá un mensaje de configuración guardada.
La app de Chat está lista para instalarse y probarse en Chat.
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 que se proporcionan cuando te agregaste como verificador de confianza.
- Haz clic en Nuevo chat.
- En el campo Add 1 or more people, 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 de la app de Chat, Escribe
/addContact
y presiona Intro.En el diálogo que se abre, ingresa la información de contacto:
- En el campo de texto Nombre y apellido, ingresa un nombre.
- En el selector de fecha Fecha de nacimiento, selecciona una fecha.
- En Tipo de contacto, elige el botón de selección Trabajo o Personal.
Haz clic en Revisar y enviar.
En el diálogo de confirmación, revisa la información que enviaste y Haz clic en Enviar. La app de Chat responde con un mensaje de texto mensaje que dice
✅ CONTACT NAME has been added to your contacts.
También puedes probar y enviar el formulario de contacto de la siguiente manera maneras:
- Usa el comando de barra
/about
. Respuestas de la app de Chat con un mensaje de texto y un botón de widget de accesorios que digaAdd a contact
Puedes hacer clic en el botón para abrir un diálogo con el formulario de contacto. - Envía un mensaje directo a la app de Chat sin un comando de barra, como
Hello
. La app de Chat respuestas con un texto y una tarjeta que contiene el formulario de contacto.
- Usa el comando de barra
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.
- En la consola de Google Cloud, ve a la página Administrar recursos. Haz clic en Menú > IAM y administración > Administrar recursos.
- En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borra .
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo. el proyecto.
Temas relacionados
- Cómo responder a los comandos de barra
- Recopila y procesa información de los usuarios de Google Chat
- Cómo abrir diálogos interactivos
- Explora otras muestras de apps de Google Chat