Los flujos permiten que los usuarios de Google Workspace automaticen tareas en los servicios combinando una serie de pasos sin escribir código. Cuando extiendes los flujos, permites que los usuarios activen flujos de trabajo a partir de los eventos de tu app y agreguen las funciones de tu app como pasos.
Por ejemplo, los usuarios pueden clasificar y asignar preguntas de clientes entrantes con un flujo que hace lo siguiente:
- Recibe un correo electrónico de un cliente.
- Solicita a Gemini que clasifique el correo electrónico.
- Crea una tarea para hacer un seguimiento con el equipo de Ventas o Asistencia.
En estos documentos, se explica cómo extender la funcionalidad de Google Workspace Studio mediante la creación de activadores y pasos personalizados que los flujos pueden ejecutar.
Para comenzar, explora la guía de inicio rápido, los codelabs y las guías para desarrolladores en Comienza.
Conceptos de Workspace Studio
Los siguientes términos y conceptos definen los componentes clave de Workspace Studio:
- Flows
Los usuarios crean
flujos en Workspace Studio para automatizar tareas en Google Workspace y más allá. Los flujos tienen una integración profunda del sistema, reconocimiento contextual y pueden usar IA de forma opcional.
- Step
Un solo paso en el proceso automatizado de un flujo. Esencialmente, es una sola tarea en una secuencia de tareas que siguen un evento inicial. Cada paso se ejecuta de forma síncrona, lo que significa que completa su operación antes de que comience el siguiente paso de la secuencia. Los usuarios establecen el orden de los pasos, lo que les permite personalizar el flujo lógico de las tareas. Los pasos pueden tener entradas y salidas, pero no son obligatorias. Entre los pasos de ejemplo, se incluyen "enviar un correo electrónico", "publicar en un espacio de Chat" y "preguntar a Gemini". Los pasos pueden incluir tareas fuera de Google Workspace, como crear un cliente potencial de CRM.
- Starter
- El punto de entrada del proceso automatizado de un flujo. En la IU,
se presenta a los usuarios como un Starter, mientras que, en el esquema del manifiesto y
la API de Google Workspace Studio, se define como un
workflowTrigger. Mientras que un Step ejecuta una acción síncrona en medio de una secuencia, un Starter se encuentra al comienzo del flujo y escucha un evento (ya sea de las apps de Google Workspace o de webhooks de terceros). Una vez que se activa, captura los detalles del evento, genera las variables de datos iniciales y lanza la ejecución del flujo. - Input variable
- Las variables de entrada son recibidas por los pasos. El usuario las establece en la tarjeta de configuración de un paso mientras lo configura. Por ejemplo, recopila una dirección de correo electrónico, una fecha y hora o una instrucción de Gemini.
- Output variable
- Las variables de salida se muestran en los pasos y se pueden enviar a otro paso. Por ejemplo, usas una variable de salida para pasar una dirección de correo electrónico a otro paso que la usa para especificar el destinatario de un correo electrónico.
- Dynamic variable
- Una variable cuyos datos solo se pueden determinar cuando el usuario configura el flujo. Por ejemplo, los Formularios de Google tienen diferentes preguntas y respuestas. La cantidad de preguntas y respuestas (y su contenido) no se puede determinar hasta que un formulario específico inicia un flujo. Las variables dinámicas tienen en cuenta este caso.
- Custom resource
- Una estructura de datos personalizada que puedes definir para agrupar varias variables. Por ejemplo, para crear un cliente potencial de CRM, pasa un recurso personalizado que contenga una dirección de correo electrónico, una dirección postal y un nombre.
- Card
Componente básico para las interfaces de usuario en complementos. Las tarjetas admiten un diseño definido, elementos interactivos de la IU, como botones, y contenido multimedia enriquecido, como imágenes. Las tarjetas tienen funciones especiales para crear flujos:
IncludeVariables: Una propiedad que permite la inclusión de variables dinámicas.Type: Define el tipo de datos que esperan las variables de entrada.
- Activity log
- Describe lo que sucede cuando se ejecuta un flujo. De forma predeterminada, los registros de actividad incluyen el nombre del activador o el paso definido de forma estática en el manifiesto. Puedes proporcionar registros de actividad personalizados.
Comenzar
Los flujos se compilan en la plataforma de complementos de Google Workspace. Si ya tienes un complemento, puedes extender su funcionalidad para incluir flujos actualizando su manifiesto para que contenga una sección específica del flujo.
Si comienzas desde cero, explora la siguiente guía de inicio rápido, los codelabs y las guías para desarrolladores.
Guía de inicio rápido
Sigue la guía de inicio rápido para compilar y probar tu primer paso personalizado:
Prueba la guía de inicio rápido
Codelabs
Para ver ejemplos de extremo a extremo que implementan activadores y pasos, explora estos codelabs:
Codelab: Compila activadores y pasos de acción personalizados de Workspace Studio
Codelab: Compila activadores y pasos de acción personalizados de Workspace Studio con Node.js
Guías para desarrolladores
Para seguir compilando y personalizando los activadores y pasos de tu flujo, consulta las siguientes guías: