En esta página, se proporciona una descripción general para compilar complementos de Google Workspace que extiendan Google Chat.
Los complementos de Google Workspace que extienden Chat pueden ayudar a los usuarios a realizar cualquiera de las siguientes acciones:
- Obtén una vista previa de los vínculos de los mensajes de Chat y realiza acciones sin abandonar 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:
- Envía mensajes que contengan texto, tarjetas y elementos interactivos de la IU.
- Responder a los comandos de barra
- Abre diálogos para ayudar a los usuarios a completar procesos de varios pasos, como completar datos de formularios.
- Obtén una vista previa de los vínculos en los mensajes adjuntando tarjetas con información útil que permita a los usuarios realizar acciones directamente desde la conversación.
Comenzar
Para comenzar a compilar 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 Apps Script de Google 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 compilar 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:
- Dialogflow y Pub/Sub. Debes compilar complementos que extiendan Chat con Apps Script o un servicio HTTP.
- Servicio de tarjetas de Apps Script Para usar acciones de chat y compilar tarjetas, muestra objetos JSON en su lugar. Para ver ejemplos, consulta Abrir diálogos interactivos y 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 mostrar una tarjeta de autorización básica.
- Páginas principales de los complementos en la barra lateral de Chat. Si configuraste un activador de la página principal para tu complemento, la página principal solo aparecerá en la barra lateral de las otras aplicaciones de Google Workspace a las que se extiende el complemento.
- Páginas principales de la app 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 para 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. - Si compilas con un servicio HTTP, debes habilitar la
API de complementos de Google Workspace. Los recursos REST
deployment
yproject
solo se aplican a las implementaciones de complementos en otras aplicaciones de Google Workspace. - Para implementar y probar un complemento en Chat, debes usar la configuración de visibilidad de la API de Chat. Se ignora cualquier configuración de visibilidad o pruebas que hayas configurado 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 en la documentación de la API de Chat.
- Si tus complementos se publican 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 mercado, puedes crear un borrador antes de enviar los cambios.