Los complementos de Google Workspace te permiten extender y personalizar Google Workspace Studio. Además de las acciones integradas de Workspace, puedes usar complementos personalizados para conectar tus flujos a herramientas externas y servicios internos:
- Activadores personalizados: Se inicia un flujo automatizado cuando se produce un evento en tiempo real en una app externa o un servicio personalizado (como un registro nuevo en Airtable, un webhook entrante o una actualización de un ticket de asistencia al cliente).
- Pasos personalizados: Se realiza una acción o tarea dentro de la secuencia de tu flujo (como publicar un mensaje, crear una tarea o enviar un SMS).
Temario
- Cómo crear activadores y pasos personalizados
- Cómo instalar complementos personalizados
- Cómo usar activadores personalizados en los flujos
- Cómo usar pasos personalizados en los flujos
- Cómo administrar el acceso a la cuenta para los complementos
- Recursos relacionados
Cómo crear activadores y pasos personalizados
Puedes crear activadores y pasos personalizados con Google Apps Script o tu lenguaje de programación preferido con complementos HTTP, aquí tienes algunos detalles:
- En el manifiesto del complemento, los desarrolladores definen los activadores con workflowTrigger y los pasos con workflowAction.
- Los activadores personalizados pueden notificar a Workspace Studio de forma asíncrona cada vez que se produce un evento llamando al endpoint de la API de Workspace Studio.
- Los desarrolladores pueden compartir complementos personalizados de forma privada con su equipo a través de implementaciones de prueba o compartirlos de forma pública en Google Workspace Marketplace.
Para obtener especificaciones detalladas para desarrolladores, manifiestos de ejemplo y referencias de la API, consulta los siguientes recursos:
- Crea un activador (Google for Developers): https://developers.google.com/workspace/add-ons/studio/build-a-starter
- Crea un paso (Google for Developers): https://developers.google.com/workspace/add-ons/studio/build-a-step
Cómo instalar complementos personalizados
Puedes instalar complementos que incluyan activadores personalizados, pasos personalizados o ambos, solo sigue estas instrucciones:
Instala desde Google Workspace Marketplace:
- Ve a workspace.google.com/marketplace?host=workflow.
- Este vínculo te lleva a una vista prefiltrada de solo los complementos y las integraciones que funcionan con Workspace Studio.
- Selecciona el complemento que quieras instalar.
- Haz clic en Instalar.
- Sigue los mensajes en pantalla para otorgar permiso al complemento para que acceda a los datos de tu Cuenta de Google y completar la instalación.
Instala una implementación de prueba privada de tu desarrollador: Si un desarrollador de tu organización creó un complemento personalizado que no se publicó en Marketplace, puede compartir contigo un ID de implementación de prueba:
- En Google Workspace, abre la configuración de administración de complementos.
- En "Complementos de desarrollador", ingresa el ID de implementación que te proporcionó el desarrollador.
- Haz clic en Instalar y, luego, autoriza los permisos solicitados.
Nota: Para desinstalar un complemento, regresa a Google Workspace Marketplace, búscalo y haz clic en Desinstalar. Si el administrador instaló el complemento para tu dominio, solo él podrá desinstalarlo.
Cómo usar activadores personalizados en los flujos
Después de instalar un complemento que incluye activadores personalizados, dichos activadores aparecerán en el editor de flujos de Workspace Studio.
- En Workspace Studio, haz clic en Crear flujo.
- En la tarjeta de activador que se encuentra al principio del flujo, haz clic en Agregar un activador.
- En el panel de selección de activadores, busca la sección del complemento instalado y selecciona el activador personalizado.
- En la tarjeta de configuración inicial, establece los parámetros de entrada necesarios (como ingresar un identificador de proyecto, seleccionar un filtro de recursos o acceder a tu cuenta en el servicio externo).
- Agrega pasos posteriores a tu flujo. Las variables de salida del activador (como los nombres de los eventos, las marcas de tiempo o los datos de la carga útil) aparecen en el selector de variables para los pasos posteriores.
- Cuando el flujo esté listo, haz clic en Activar
.
Cómo funciona el ciclo de vida de las suscripciones
- Suscripción automática: Cuando activas o publicas un flujo que contiene un activador personalizado, Workspace Studio registra automáticamente una suscripción con el complemento del desarrollador para que comience a escuchar eventos.
- Cancelación automática de la suscripción: Cuando desactivas o borras el flujo, Workspace Studio notifica automáticamente al complemento del desarrollador para que cancele la suscripción y deje de enviar notificaciones de eventos futuros.
Nota sobre las pruebas: Workspace Studio no admite ejecuciones de pruebas manuales para activadores personalizados. Para probar tu flujo, actívalo y, luego, activa un evento real en la app o el servicio externos.
Cómo usar pasos personalizados en los flujos
Después de instalar un complemento de Workspace Studio, los pasos aparecerán dondequiera que crees y edites flujos, incluidos los siguientes casos:
- En el editor de flujos: En el panel de selección de pasos, desplázate hasta la sección con el nombre del complemento y haz clic en el paso personalizado.
- Con la asistencia de Gemini: En la página Descubre de Studio, describe el flujo que quieres crear en lenguaje natural. Studio puede sugerir y colocar automáticamente pasos de complementos instalados.
Importante: Cuando agregas variables a los pasos de integración de terceros o a los pasos de complementos, es posible que contengan datos de tu Cuenta de Google, como el contenido de un correo electrónico en Gmail, un mensaje en Google Chat o un evento en el Calendario. Por lo tanto, el flujo puede compartir estos datos con el servicio de terceros. Asegúrate de que el servicio de terceros sea de confianza antes de ejecutar el flujo.
Cómo administrar el acceso a la cuenta para los complementos
Si te preocupa el acceso de un complemento a los datos de tu Cuenta de Google, puedes ver y quitar sus conexiones de la siguiente manera:
- Ve a myaccount.google.com/connections.
- Busca el complemento en la lista de apps y servicios de terceros, y selecciónalo.
- Haz clic en Borra todas las conexiones que tengas con [nombre del complemento] y, luego, confirma la acción.
Nota: Si quitas la conexión de un complemento con la cuenta, es posible que dejen de ejecutarse los flujos que usan sus activadores o pasos personalizados. Para volver a conectar el complemento, abre el flujo en Workspace Studio y vuelve a autorizar la conexión cuando se te solicite.