En esta página, se proporciona una descripción general de cómo crear una app interactiva de Google Chat. Las apps interactivas de Chat se crean como complementos de Google Workspace que extienden Google Chat.
Las apps de Chat interactivas permiten que los usuarios realicen cualquiera de las siguientes acciones:
- Agregar apps de Chat a espacios de Chat o mensajes directos
- Enviar o recibir mensajes de apps de Chat que contienen texto, tarjetas y elementos de IU interactivos
- Ver la tarjeta de la página principal de la app e interactuar con ella en la pestaña Página principal de los mensajes directos 1:1 con la app de Chat
- Indica a las apps de Chat que usen comandos de barra, comandos rápidos o acciones de mensajes.
- Obtener una vista previa de los vínculos de los mensajes de Chat y tomar medidas sin salir de la conversación
- Enviar información a las apps de Chat, como ingresar texto en un diálogo o un mensaje de tarjeta
- Automatizar o realizar tareas en las aplicaciones de Google Workspace y conectarse a herramientas o servicios externos
Cómo los usuarios descubren y usan las apps interactivas de Chat
En Chat, los complementos que extienden Chat aparecen para los usuarios como apps de Google Chat. Los usuarios pueden descubrir y usar las apps de chat publicadas en Marketplace de muchas maneras, incluidas las siguientes:
- Busca e instala apps de Chat desde Google Chat o Marketplace.
- Interactuar con una app de Chat que se agregó a un espacio de Chat
- Descubrir la app de Chat en el panel de mensajes directos después de que un administrador de Google Workspace la instale en su nombre
Para comenzar a usar una app de Chat, los usuarios de Google Chat pueden iniciar un mensaje directo con la app de Chat o agregarla a un espacio. Los usuarios también pueden agregar la app de Chat con una @mención. Para obtener más información, consulta Cómo usar apps de Chat.
En el siguiente ejemplo, se muestra cómo un usuario menciona con @a una app de Chat para agregarla a un espacio:
Comenzar
Para comenzar a crear una app de Chat interactiva, consulta la siguiente documentación:
- Configura la API de Google Chat y habilita las funciones interactivas para tu app de Chat.
- Obtén información para recibir y responder a las interacciones del usuario con activadores, objetos de eventos y acciones.
- Prueba una guía de inicio rápido para compilar una app de Chat básica para la arquitectura de la app de Google Chat que prefieras.
Configura y crea una app de Chat básica
En la siguiente tabla, se incluye la documentación para configurar la API de Chat y crear una app de Chat interactiva básica para cada arquitectura de la app de Google Chat:
| Arquitectura o tarea | Guía |
|---|---|
| Configura la API de Chat | Configura la API de Google Chat |
| Guías de inicio rápido | |
| Apps Script | Compila una app de Chat con Apps Script |
| Servicio HTTP (Cloud Run Functions) | Crea una app de Chat de HTTP |
| Pub/Sub | Crea una app de Chat con Pub/Sub |
| Dialogflow CX | Compila una app de chat de Dialogflow CX |
| Dialogflow ES | Crea una app de chat de Dialogflow ES |
| Agente de IA del Kit de desarrollo de agentes (ADK) | Crea una app de Chat con un agente de IA del ADK |
| Agente de IA Agent2Agent (A2A) | Crea una app de Chat con un agente de IA de A2A |
| Agente de IA de A2UI | Crea una app de chat con un agente de IA de A2UI |
| Agente de IA de Gemini Enterprise | Compila una app de chat con un agente de IA de Gemini Enterprise |
Crea funciones interactivas
En la siguiente tabla, se muestra la documentación para compilar funciones interactivas de la app de chat:
| Función | Guía |
|---|---|
| Recibir y responder a las interacciones del usuario | Recibir y responder a las interacciones del usuario |
| Enviar mensajes (responder a interacciones o enviar mensajes de forma proactiva) | Responder con un mensaje o Enviar un mensaje con la API de Chat |
| Responder a comandos de barra, comandos rápidos y acciones de mensajes | Cómo responder a comandos |
| Crea diálogos interactivos | Abrir diálogos interactivos |
| Recopila y procesa información de tarjetas y diálogos | Leer los datos del formulario que ingresan los usuarios en las tarjetas |
| Vistas previas de vínculos en mensajes de Chat | Vínculos de vista previa |
| Crea una página principal (página principal de la app) en mensajes directos 1:1 | Crea una página principal para una app de Chat |
| Conectarse a sistemas y herramientas externos | Conecta una app de Chat con otros servicios y herramientas |
Limitaciones y consideraciones de los complementos de Google Workspace
Dado que las apps de Chat se crean como complementos de Google Workspace que extienden Chat, ten en cuenta las siguientes limitaciones de funciones:
- AppSheet La arquitectura de la app de Chat no está disponible cuando se crea como complemento de Google Workspace. En su lugar, compila la app de Chat con un servicio HTTP, Apps Script, Dialogflow ES, Dialogflow CX o Pub/Sub.
- Las tarjetas de autorización personalizadas no son compatibles con Chat. Para autenticar y otorgar autorización a tu servicio desde Chat, la app de Chat debe devolver una tarjeta de autorización básica.
- No se admiten las páginas principales de los complementos en la barra lateral de Chat. Si configuraste un activador de página principal en tu manifiesto (
addons.common.homepageTrigger), la página principal solo aparecerá en la barra lateral de las otras aplicaciones de Google Workspace que extiende tu complemento. En cambio, puedes crear una página principal para una app de Chat que aparezca en la pestaña Página principal de los mensajes directos 1:1 con la app de Chat.
Si vas a extender un complemento existente de Google Workspace para que funcione en Chat, ten en cuenta los siguientes requisitos de configuración para las apps de Chat:
- La configuración de instalación de Google Workspace Marketplace debe permitir que tanto las personas como los administradores de Google Workspace instalen el complemento.
- En Chat, se ignoran todos los parámetros de configuración comunes del manifiesto (
addons.common) del complemento. Para configurar el complemento para que funcione en Chat, debes habilitar y configurar la API de Chat. Para conocer los pasos, consulta Cómo configurar la API de Google Chat. - Para implementar y probar un complemento en Chat, debes usar el parámetro de configuración Visibilidad de la API de Chat. Se ignorará cualquier configuración de visibilidad o de prueba que hayas establecido en el SDK de Google Workspace Marketplace. Para implementar una versión de prueba del complemento en Chat, consulta Cómo probar funciones interactivas para apps de Google Chat.
- Si tu complemento se publicó en Google Workspace Marketplace, no podrás guardar un borrador de los cambios en la configuración de la API de Google Chat. Cuando actualizas la configuración de la API de Chat, la app de Chat actualizada está disponible de inmediato para todos los usuarios existentes. Para actualizar tu ficha de Marketplace, puedes crear un borrador antes de enviar los cambios.
Temas relacionados
- Descripción general de la documentación de la API de Google Chat
- Recibir y responder a las interacciones del usuario
- Elige una arquitectura de app de Google Chat
- Prueba una muestra:
- Cómo programar reuniones desde Google Chat
- Integra conceptos básicos de la IA en apps de Chat
- Planifica viajes con un agente de IA accesible en todo Google Workspace
- Compila agentes de Gemini Enterprise que estén estrechamente integrados con los almacenes de datos, las APIs y las apps de Chat de Workspace
- Compila agentes de Vertex AI que estén estrechamente integrados con los almacenes de datos, las APIs y las apps de Chat de Workspace
Apps de Chat que no son complementos: Compila una app interactiva de Google Chat
Las apps de Chat que no son complementos de Google Workspace se compilan como apps solo para Chat que reciben eventos de interacción de la API de Chat (Event) en lugar de objetos de eventos de complementos de Google Workspace (EventObject) y acciones.
Si mantienes una app de Chat que no es un complemento, puedes hacer lo siguiente:
- Convierte tu app de Chat que no es un complemento en un complemento de Google Workspace que extienda Google Chat. Consulta Cómo convertir una app de Google Chat en un complemento de Google Workspace.
- Consulta las secciones desplegables Apps de chat que no son complementos en la parte inferior de cada guía de funciones interactivas de este conjunto de documentación para conocer los formatos de solicitud y respuesta.