En esta página, se proporciona una descripción general sobre cómo crear complementos de Google Workspace que extiendan Google Chat.
Los complementos de Google Workspace que extienden Chat pueden ayudar a los usuarios a hacer lo siguiente:
- Obtener una vista previa de los vínculos de los mensajes de Chat y realizar acciones sin salir de la conversación
- Automatizar o realizar 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 interactivos de la IU
- 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
- Vínculos de vista previa en los mensajes, ya que adjuntan 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 las apps 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, consulta Cómo abrir diálogos interactivos y Cómo obtener una vista previa de los vínculos.
- 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 principales de los 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 de Google Workspace existente, 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 de modo que funcione en Chat, debes habilitar y configurar la API de Chat. Para conocer los pasos, consulta Cómo configurar una app 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.