Documentación: Nodo de Espera (Wait)¶
Descripción General¶
El Nodo de Espera (Wait) introduce una pausa configurable en el flujo de la automatización. Cuando la ejecución llega a este nodo, se detiene durante el tiempo indicado (en segundos) antes de continuar al siguiente nodo. Resulta útil para limitar frecuencia de acciones, secuencias programadas o dar tiempo a que sistemas externos completen una acción.
¿Cuándo usar este nodo?¶
Utiliza este nodo cuando necesites:
- Introducir una pausa entre dos acciones (por ejemplo, esperar antes de enviar un segundo aviso)
- Respetar límites de frecuencia de APIs o dispositivos externos
- Dar tiempo a que un dispositivo o sistema termine una operación antes del siguiente paso
- Construir secuencias temporales (por ejemplo: abrir puerta → esperar 5 segundos → cerrar puerta)
- Espaciar reintentos o acciones repetidas
Configuración del Nodo¶
El nodo tiene dos vistas de configuración: Form (Formulario) y JSON Editor. Puedes configurar la espera mediante el formulario visual o editando el JSON directamente.
Vista Formulario¶
Duración¶
- En el campo "Duration" (Duración), ingresa el número de segundos que la automatización debe esperar
- Usa el selector de unidad a la derecha para elegir la unidad de tiempo (por ejemplo Seconds, Minutes, Hours). El valor se almacena en segundos en los datos del nodo
- El flujo se pausará durante esta duración antes de continuar al siguiente nodo
Ejemplos:
- 10 segundos → pausa corta entre pasos
- 144000 segundos (40 horas) → pausa larga para flujos programados o periódicos
Note
La propiedad duration en el JSON del nodo siempre se expresa en segundos, con independencia de la unidad elegida en el formulario. El formulario convierte el valor que ingresas a segundos al guardar.
Vista JSON Editor¶
Puedes cambiar a la pestaña JSON Editor para ver o editar la configuración en JSON.
Estructura JSON¶
{
"duration": 144000
}
Campos Requeridos¶
| Campo | Tipo | Descripción |
|---|---|---|
duration |
number | Tiempo de espera en segundos antes de continuar el flujo |
Ejemplos de Valores¶
| Duración (segundos) | Equivalencia aproximada |
|---|---|
| 5 | 5 segundos |
| 60 | 1 minuto |
| 3600 | 1 hora |
| 86400 | 1 día |
| 144000 | 40 horas |
Ejemplos de Uso¶
Ejemplo 1: Pausa corta entre acciones¶
Caso de uso: Enviar una notificación, esperar 10 segundos y luego enviar un recordatorio.
Configuración:
- Duration: 10 segundos
JSON:
{
"duration": 10
}
Ejemplo 2: Secuencia abrir puerta y cerrar¶
Caso de uso: Abrir una puerta, esperar el paso (por ejemplo 15 segundos) y luego cerrar.
Configuración:
- Duration: 15 segundos
JSON:
{
"duration": 15
}
Ejemplo 3: Pausa larga (flujo programado o periódico)¶
Caso de uso: Pausar el flujo durante un periodo largo (por ejemplo 40 horas) antes del siguiente paso.
Configuración:
- Duration: 144000 segundos (40 horas)
JSON:
{
"duration": 144000
}
Solución de Problemas¶
El flujo parece continuar de inmediato¶
Causa: La duración puede estar en 0 o en un valor muy bajo.
Solución: Comprueba el valor de Duration en el formulario o el valor de duration en el JSON. Debe ser un número positivo (en segundos).
La espera no tiene la longitud esperada¶
Causa: Confusión entre unidades (segundos, minutos, horas).
Solución: Recuerda que el nodo siempre almacena y usa segundos. Si usas el selector de unidad del formulario (por ejemplo Minutes), el valor que ingresas se convierte a segundos al guardar. En JSON, indica siempre duration en segundos.
Buenas Prácticas¶
- Usar esperas razonables: Esperas muy largas (días) pueden mantener la ejecución de la automatización ocupada; valora usar disparadores programados o dividir flujos cuando convenga.
- Documentar el propósito: En el nombre del nodo o de la automatización, indica brevemente por qué está la espera (por ejemplo: “Esperar cierre de puerta”, “Límite de tasa antes de siguiente llamada API”).
- Combinar con condiciones: Usa el nodo de Espera junto con nodos condicionales cuando necesites lógica basada en tiempo o reintentos.