Esta página explica cómo crear una página de inicio para tu App de Google Chat La página principal de la app es una interfaz de tarjetas personalizable que envía una app de Chat a un usuario cuando este abre un mensaje con la app de Chat.
Por ejemplo, puedes configurar el mensaje de la tarjeta de la página principal de la app para incluir sugerencias para interactuar con App de Chat con comandos de barra. Para los usuarios finales, la página principal de la app es disponible solo en los mensajes directos de una app de Chat desarrollador de apps habilita la función.
Usa Card Builder para diseñar mensajes de tarjetas JSON y obtener una vista previa de ellos para apps de Chat:
Abre el Creador de tarjetasRequisitos previos
Python
Una app de Google Chat habilitada para funciones interactivas. Para crear un app de Chat interactiva con un servicio HTTP, completa esta guía de inicio rápido.
Apps Script
Una app de Google Chat habilitada para funciones interactivas. Para crear un app de Chat interactiva en Apps Script, completa esta guía de inicio rápido.
Node.js
Una app de Google Chat habilitada para funciones interactivas. Para crear un app de Chat interactiva con un servicio HTTP, completa esta guía de inicio rápido.
Java
Una app de Google Chat habilitada para funciones interactivas. Para crear un app de Chat interactiva con un servicio HTTP, completa esta guía de inicio rápido.
Configura la API de Chat
Para admitir la página principal de la app, debes actualizar la configuración de la API de Chat en la consola de Google Cloud.
Python
En la consola de Google Cloud, ve a Menú > Más productos > Google Workspace > Biblioteca de productos > API de Google Chat.
Haz clic en Administrar y, luego, en la pestaña Configuración.
Selecciona la casilla de verificación Support App Home.
Agrega una URL en el campo URL de la página principal de la app. Este valor suele ser el mismo de destino como la URL de la aplicación. Esta URL se llama Eventos
APP_HOME
.Haz clic en Guardar.
Apps Script
En la consola de Google Cloud, ve a Menú > Más productos > Google Workspace > Biblioteca de productos > API de Google Chat.
Haz clic en Administrar y, luego, en la pestaña Configuración.
Selecciona la casilla de verificación Support App Home.
Haz clic en Guardar.
Node.js
En la consola de Google Cloud, ve a Menú > Más productos > Google Workspace > Biblioteca de productos > API de Google Chat.
Haz clic en Administrar y, luego, en la pestaña Configuración.
Selecciona la casilla de verificación Support App Home.
Agrega una URL en el campo URL de la página principal de la app. Este valor suele ser el mismo de destino como la URL de la aplicación. Esta URL se llama Eventos
APP_HOME
.Haz clic en Guardar.
Java
En la consola de Google Cloud, ve a Menú > Más productos > Google Workspace > Biblioteca de productos > API de Google Chat.
Haz clic en Administrar y, luego, en la pestaña Configuración.
Selecciona la casilla de verificación Support App Home.
Agrega una URL en el campo URL de la página principal de la app. Este valor suele ser el mismo de destino como la URL de la aplicación. Esta URL se llama Eventos
APP_HOME
.Haz clic en Guardar.
Cómo compilar la página principal de la app
La tarjeta de la página principal de la app se inicia cuando un usuario abre un mensaje directo desde la App de Chat y se puede actualizar como respuesta a un evento interactivo, como un clic en un botón, el envío de un formulario o el cierre de un diálogo.
En el siguiente ejemplo, la app de Chat muestra una tarjeta inicial de la app principal que muestra la hora en que se creó la tarjeta un botón. Cuando un usuario hace clic en el botón, la app de Chat devuelve una tarjeta actualizada con la hora en que se creó la tarjeta actualizada.
Crea la tarjeta inicial para la página principal de la app
Para crear la página principal de la app, la app de Chat debe controlar
Eventos de interacción APP_HOME
y muestran una instancia de
RenderActions
con la navegación de pushCard
.
Python
Apps Script
Implementa la función onAppHome
a la que se llama después de todos los eventos APP_HOME
:
En este ejemplo, se envía un mensaje de tarjeta mostrando JSON de la tarjeta. También puedes usar Servicio de tarjetas de Apps Script.
Node.js
Java
Actualiza la tarjeta de la página principal de una app
Si la tarjeta inicial de la página principal de la app contiene widgets interactivos, como botones
o entradas de selección, tu app de Chat debe controlar
los eventos de interacción relacionados mostrando una instancia de
RenderActions
con la navegación de updateCard
. Para obtener más información sobre el manejo de
widgets, consulta
Procesa la información que ingresan los usuarios.
Python
Apps Script
En este ejemplo, se envía un mensaje de tarjeta mostrando JSON de la tarjeta. También puedes usar Servicio de tarjetas de Apps Script.
Node.js
Java
Limitaciones
En general,
navigation
es
no disponible para apps de Chat. No puedes devolver una pila de tarjetas.
Solo se permite el uso de pushCard
(para la respuesta inicial) y updateCard
(para las actualizaciones)
disponibles para las apps de Chat.
Temas relacionados
- Consulta ejemplos de la app de Chat que usan la página principal de la app.
Para abrir un diálogo, usa la interacción
OPEN_DIALOG
. Para obtener más información, ver Abre un diálogo en respuesta a una tarjeta de la página principal de la app.Si quieres cerrar un diálogo, usa la interacción
CLOSE_DIALOG
. y vuelve a la tarjeta de la página principal de la app, o bien usaCLOSE_DIALOG_EXECUTE
interacción para cerrar el diálogo y actualizar la tarjeta de la página principal de la app. Para más información, consulta Cómo responder a un diálogo de la tarjeta de la página principal de la app.Para ver un ejemplo de cómo usar la página principal de la app, consulta la app de Chat de administración de problemas en el codelab Compila apps para Google Chat con Gemini.