Crear un flujo de trabajo

Al abrir una automatización, el constructor toma toda la pantalla: un lienzo de nodos a la derecha, una paleta o un inspector a la izquierda y una barra de herramientas en la parte superior. Se mantiene abierto sobre tu espacio de trabajo; no hay una página ni una pestaña aparte.

Vistazo rápido

1. Crea o abre una automatización para entrar en el constructor.
2. Arrastra un nodo desde la paleta al lienzo.
3. Arrastra desde el conector de un nodo hasta el siguiente nodo para enlazarlos.
4. Haz clic en un nodo para abrir sus ajustes en el panel izquierdo.
5. Haz clic en Validate y luego en Test para ejecutarlo una vez, o en Activate para ponerlo en vivo.

Referencia detallada

Diseño

Región	Qué contiene
Carril de iconos (extremo izquierdo)	Tres vistas: Flow (el lienzo), Settings (opciones por automatización), Activity (historial de ejecuciones).
Panel izquierdo	La paleta de nodos cuando no hay nada seleccionado, o los ajustes del nodo seleccionado cuando lo hay. Ambos se intercambian en el mismo sitio.
Lienzo	El grafo en sí: un fondo de cuadrícula, desplazamiento y zoom, un minimapa y controles de zoom.
Barra de herramientas	Salir, el nombre de la automatización y su estado de guardado automático, deshacer y rehacer, Validate, una píldora de estado y Test / Activate / Pause.

La paleta de nodos

La paleta del panel izquierdo tiene un cuadro de búsqueda y tres pestañas que coinciden con el catálogo de nodos: Triggers, Actions y Rules, cada una agrupada en subcategorías más pequeñas (por ejemplo Design, AI o Notification dentro de Actions). Arrastra cualquier nodo al lienzo para colocarlo; consulta Nodos para ver el catálogo completo.

Conectar nodos

Arrastra desde el conector inferior de un nodo hasta la parte superior del siguiente nodo para enlazarlos. Un desencadenante no tiene entrada; un nodo de salida no tiene salida. Los nodos de tipo condición (como If) exponen dos conectores, uno por cada rama, así que cableas una ruta de "sí" y una de "no" por separado.

Configurar un nodo

Haz clic en un nodo para cambiar el panel izquierdo a su inspector: un título, una breve descripción y sus campos.

Tipo de campo	Se muestra como
Text	Una entrada de una sola línea
Textarea	Una entrada de varias líneas, para prompts y contenido más largo
Number	Una entrada numérica, con mínimo y máximo cuando corresponde
Select	Un desplegable; algunos (como las carpetas) cargan datos en vivo de tu espacio de trabajo
Boolean	Un interruptor de activación
Part picker	Un botón que abre el selector de partes descrito más abajo

Elegir una parte de un proyecto

Algunos nodos de acción, empezando por Pick a part, necesitan una pieza concreta de un proyecto en lugar de un diseño entero. El selector es una superposición de dos pasos sobre el constructor: primero eliges un proyecto y luego una parte dentro de él, una página, un marco o una diapositiva, con una miniatura de previsualización en vivo por proyecto. Una vez elegida, un enlace Open in editor salta directamente a esa parte exacta.

Manejo de errores por nodo

El inspector de cada nodo tiene dos pestañas: Parameters, los campos ya descritos, y Settings, que solo muestra opciones para los nodos de tipo acción (los desencadenantes y los nodos de lógica no tienen nada que configurar aquí, ya que no tienen ningún efecto secundario que reintentar):

Ajuste	Qué hace
On error	Continue se traga el fallo y sigue adelante, Stop the run hace fallar toda la ejecución, Route to an error output añade un segundo conector rojo "Hata" que sale del nodo para que puedas cablear una ruta de fallo dedicada
Retry (0-5)	Reintenta el mismo paso esta cantidad de veces antes de recurrir al comportamiento de On error
Wait (ms)	Cuánto pausar entre intentos de reintento
Note	Una nota de texto libre en el nodo, para tu propia referencia; no afecta a la ejecución

Un nodo dejado en el valor por defecto Continue simplemente registra un paso error y hace avanzar la ejecución como si nada hubiera pasado, así que un webhook inalcanzable o un correo rebotado no detiene por sí solo el resto del grafo.

La vista Settings

La vista Settings del carril de iconos contiene opciones para toda la automatización, guardadas con el borrador:

Grupo	Ajuste	Qué hace
Execution	Concurrency	Free (muchas ejecuciones a la vez), Single at a time, Skip if busy, o Queue hasta un tope
Execution	Max concurrent	El tope de la cola, solo se muestra en el modo Queue
Execution	Max run duration	Una ejecución más antigua que esta cantidad de segundos falla automáticamente, incluso a mitad de una espera
Execution	Priority	Las ejecuciones de las automatizaciones de mayor prioridad se adelantan cuando el motor tiene una acumulación
Error	Default on-error behavior	Continue o Stop, usado por cualquier nodo que no haya definido su propio On error
Error	Error notifications	In-app, email o Slack, se envían cuando una ejecución falla
Error	Error automation	Otra automatización que arrancar (sin esperar respuesta) cada vez que esta falla
Error	Circuit breaker	Pausa automáticamente la automatización después de que esta cantidad de ejecuciones falle de forma seguida
Scheduling	Quiet hours	Una ventana horaria de inicio y fin (en la zona horaria de la automatización) durante la cual los desencadenantes se aplazan en lugar de dispararse
Scheduling	Debounce	Un intervalo mínimo forzado entre disparos, además de cualquier debounce definido en el propio nodo desencadenante
Data & retention	Save execution data	Todos los registros de pasos, solo errores, o ninguno, un equilibrio entre privacidad y almacenamiento
Data & retention	Run history retention	Las ejecuciones terminadas más antiguas que esta cantidad de días se eliminan automáticamente; en blanco conserva todo

Nada de esto lo comprueba Validate, solo el grafo en sí; un ajuste sin sentido (como un tope de Queue de 0) simplemente se comporta de forma conservadora en lugar de bloquear Activate.

Controles de la barra de herramientas

Control	Qué hace
Exit	Cierra el constructor y vuelve al resumen.
Nombre + texto de estado	Muestra el nombre de la automatización y si está guardada, guardándose o si falló al guardar.
Undo / Redo	Retrocede y avanza por tus ediciones del grafo.
Validate	Comprueba el grafo y lista errores y avisos en línea, bajo la barra de herramientas.
Píldora de estado	Draft, Active, Paused o Error, de un vistazo.
Test	Guarda y luego ejecuta el grafo una vez de inmediato. Consulta Ejecutar y supervisar.
Activate / Pause	Publica y pone en vivo, o deja de escuchar sin perder el borrador.

Atajos de teclado

Atajo	Acción
Delete / Backspace	Eliminar el nodo seleccionado (y sus aristas conectadas)
Ctrl/Cmd + Z	Deshacer
Ctrl/Cmd + Shift + Z (o Ctrl+Y)	Rehacer
Ctrl/Cmd + C / V	Copiar y pegar el nodo seleccionado
Ctrl/Cmd + D	Duplicar el nodo seleccionado

Los nodos arrastrados se ajustan a una cuadrícula, y arrastrar sobre el lienzo vacío selecciona varios nodos a la vez con un recuadro.

Paso a paso

Estos construyen automatizaciones completas y reales a partir de nodos que se ejecutan de verdad hoy (consulta Nodos para ver cuáles). Los anclajes de abajo están enlazados desde otras páginas.

Recorrido: un resumen de IA programado, por correo

1. Arrastra un desencadenante Scheduled al lienzo (pestaña Triggers, grupo Zaman). Abre su inspector y define Frequency: elige Weekly para un día fijo, Interval más un valor "Every (minutes)" para una cadencia ajustada, o Cron con una expresión cron en bruto y una zona horaria para un control exacto (consulta Desencadenantes).
2. Arrastra un nodo Generate copy desde Actions > AI y conecta el conector del desencadenante a él. Abre su inspector y escribe un prompt, por ejemplo "Write 3 short social post ideas for this week, one line each." Este paso se ejecuta a través de la clave del proveedor de IA que hayas conectado en Settings > AI; sin una, registra un paso omitido en lugar de hacer fallar la ejecución.
3. Arrastra un nodo Send email desde Actions > Notification y conecta Generate copy a él. Pon To en tu dirección, Subject en algo como "This week's post ideas" y Body en {{ context.__aiText }} para que lleve la salida del paso de IA.
4. Haz clic en Validate, corrige lo que marque (uno común: To o Subject en blanco) y luego haz clic en Test. Abre la vista Activity y confirma que el paso de IA produjo texto y que el paso de correo muestra ok (o un motivo de omisión claro si aún no hay conexión SMTP ni clave de IA configuradas).
5. Haz clic en Activate. Ahora se ejecuta por sí solo según la programación que configuraste; no necesitas mantener la app abierta.

Recorrido: recepción por webhook con una respuesta de IA

1. Arrastra un desencadenante Incoming webhook al lienzo. Su URL entrante se construye a partir del propio id de la automatización (/api/workflow/hook/<automation id>); todavía no hay un botón de copiar URL en el constructor, así que encuentra el id a partir de las peticiones de red que la página ya hace (por ejemplo las herramientas de desarrollo del navegador con el constructor abierto) en lugar de esperar que aparezca impreso en el nodo. Opcionalmente, define un secreto HMAC para que solo se acepten las peticiones que lleven una firma válida.
2. Apunta una herramienta externa de formularios, un CRM o un widget de chat a esa URL como su destino de webhook, con un cuerpo JSON como { "email": "...", "message": "..." }.
3. Arrastra un nodo Set a variable después del desencadenante para normalizar un campo que reutilizarás, por ejemplo la clave customerEmail, con valor {{ context.email }}.
4. Arrastra un nodo Generate copy después con un prompt como Write a short, friendly reply to: {{ context.message }}.
5. Arrastra un nodo Slack / Discord, pega la URL del webhook entrante de tu canal y define el mensaje como New submission from {{ context.customerEmail }}: {{ context.__aiText }}.
6. Valida y luego prueba con un cuerpo JSON de ejemplo (cualquier cliente HTTP, o el propio botón "send test event" de tu herramienta sirve, ya que solo necesita hacer un POST a la URL del webhook). Revisa Activity y luego activa.

Recorrido: ramificar según una condición tras un guardado

1. Empieza desde un desencadenante Design updated; de los desencadenantes de eventos de diseño y espacio de trabajo, este es el que la app dispara automáticamente hoy, cada vez que se guarda un diseño (consulta Desencadenantes).
2. Arrastra un Pick a part para que los pasos posteriores tengan algo concreto sobre lo que actuar; abre el selector de partes y elige un proyecto, y luego una página, un marco o una diapositiva dentro de él.
3. Arrastra un nodo Condition (yes/no). Su inspector construye una regla (un campo, una comparación como es igual o contiene, y un valor) en lugar de una expresión escrita en bruto; cualquiera de los dos lados de la regla puede tomar del contexto de la ejecución.
4. En la rama yes, añade una In-app notification que avise a tu equipo de que la parte está lista para revisar. En la rama no, añade un paso Write an audit entry para que el caso de paso directo también quede registrado.
5. Valida y luego prueba; Test se ejecuta de inmediato independientemente del desencadenante, así que puedes probar ambas ramas sin guardar de verdad un diseño. Confirma que ambas rutas aparecen correctamente en Activity y luego activa.

Solución de problemas

• La pestaña Settings de un nodo parece vacía. Solo los nodos de tipo acción tienen una pestaña On error / Retry / Note. Los desencadenantes y los nodos de lógica (Condition, Filter, Delay, Set a variable y similares) no tienen ningún efecto secundario que reintentar, así que su pestaña Settings no tiene más que el campo Note.
• Puse "Route to an error output" pero no hay dónde conectar la ruta de fallo. Un segundo conector rojo solo aparece en el propio nodo después de que actives ese ajuste; mira de nuevo la parte inferior del nodo; el nuevo controlador "Hata" se sitúa junto a la salida normal.
• Copiar/pegar (Ctrl/Cmd+C/V) parece no haber hecho nada. La copia pegada cae un poco desplazada del original, con una pequeña variación aleatoria, no exactamente encima; mira justo debajo y a la derecha del nodo de origen.
• Validate está limpio pero Activate sigue fallando. Activate revalida y publica en un solo paso; si un campo depende de datos en vivo (como una carpeta que se ha eliminado desde entonces), puede fallar en ese momento aunque Validate se viera bien un minuto antes. Vuelve a abrir el inspector del nodo que falla y vuelve a elegir el valor.
• Un campo obligatorio muestra un error que no encuentro. El mensaje de Validate nombra el nodo y el campo, pero el inspector solo muestra los campos cuya condición displayIf se cumple actualmente; un campo puede ser obligatorio y estar oculto si otro campo controla su visibilidad (por ejemplo, el cuerpo del nodo HTTP solo aparece una vez que se elige un método que lleva cuerpo).

Consejos

Valida antes de activar

La validación detecta un grafo vacío, más de un desencadenante, un campo obligatorio en blanco, una conexión colgando o una rama sin cablear, antes de que intentes ponerlo en vivo.

Los cambios se guardan solos

Las ediciones se guardan automáticamente un momento después de que dejes de escribir o de mover algo; el texto de estado de la barra de herramientas lo confirma. No hay un botón de guardar aparte.

Eliminar un nodo quita sus aristas

No hay un paso aparte para limpiar las conexiones; eliminar un nodo se lleva con él cualquier arista que lo toque.

Relacionado

• Nodos
• Desencadenantes
• Ejecutar y supervisar
• Todo consciente de las partes