Esta página ofrece una descripción general sobre cómo crear complementos de Google Workspace que amplíen Google Chat.
Los complementos de Google Workspace que amplían las funcionalidades de Chat pueden ayudar a los usuarios a realizar cualquiera de las siguientes acciones:
- Previsualiza los enlaces de los mensajes de chat y actúa sin abandonar la conversación.
- Automatice o realice tareas en las aplicaciones de Google Workspace.
- Recibir alertas o notificaciones sobre herramientas o servicios externos
Cómo funcionan los complementos de Google Workspace en Chat
En Chat, los complementos aparecen para los usuarios como apps de Google Chat. Para interactuar con los usuarios, las apps de Chat pueden hacer lo siguiente:
- Enviar mensajes que contengan texto, tarjetas y elementos de la IU interactivos
- Responder a comandos rápidos
- Responder a comandos de barra
- Abrir diálogos para ayudar a los usuarios a completar procesos de varios pasos, como completar datos de formularios
- Vista previa de enlaces en los mensajes adjuntando tarjetas con información útil que permiten a los usuarios realizar acciones directamente desde la conversación.
Comenzar
Para comenzar a crear complementos de Google Workspace que funcionen en Chat, consulta la siguiente documentación:
- Prueba una guía de inicio rápido para compilar una app de Chat básica con Google Apps Script o un servicio HTTP.
- Configura una app de Chat y sus funciones interactivas con la API de Chat.
- Obtén información sobre las formas en que puedes crear interfaces de Chat con activadores, acciones y objetos de eventos de complementos.
Limitaciones y problemas conocidos
Las siguientes funciones de Chat y complementos no están disponibles:
- Las arquitecturas de la app de chat Dialogflow, Pub/Sub y AppSheet no están disponibles. En cambio, debes compilar la app de Chat con Apps Script o un servicio HTTP.
- Card Service de Apps Script Para usar acciones de chat y compilar tarjetas, devuelve objetos JSON. Para ver ejemplos, consulte Abrir diálogos interactivos y Vista previa de enlaces.
- Tarjetas de autorización personalizadas Para autenticar y otorgar autorización a tu servicio desde Chat, la app de Chat debe devolver una tarjeta de autorización básica.
- Páginas de inicio de complementos en la barra lateral de Chat. Si configuraste un activador de página principal para tu complemento, la página principal solo aparecerá en la barra lateral de las otras aplicaciones de Google Workspace que extiende tu complemento.
- Páginas principales de las apps de Chat, que aparecen en la pestaña Página principal de los mensajes directos con la app de Chat
Si actualizas un complemento existente de Google Workspace, 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.
- Cualquier configuración común en el manifest (
addons.common) del complemento se ignora en Chat. Para configurar el complemento de modo que funcione en Chat, debes habilitar y configurar la API de Chat. Para conocer los pasos, consulte Configurar una aplicación 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 parámetro de configuración de visibilidad o 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 las apps de Google Chat en la documentación de la API de Chat.
- Si tus complementos se publicaron en Google Workspace Marketplace, no puedes 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 cualquier cambio.
Temas relacionados
- Descripción general de la documentación de la API de Google Chat
- Prueba una muestra: