Trigger: Manual (manual_trigger)¶
Este trigger inicia una automatización al instante, de forma manual, haciendo click en el botón "Test Automation" dentro del editor de automatizaciones. No depende de ningún evento externo ni de una programación horaria: se ejecuta exactamente cuando el usuario lo decide. Es el trigger de referencia para probar y depurar flujos antes de activarlos con un trigger real.
¿Cuándo usarlo?¶
- Cuando estás construyendo o ajustando un flujo y querés ejecutarlo de inmediato para ver si los nodos funcionan correctamente.
- Cuando necesitás verificar que una acción (enviar un Telegram, actualizar un estado, escribir en Google Sheets) está configurada bien antes de conectar el trigger definitivo.
- Cuando querés demostrarle a alguien cómo funciona una automatización sin tener que esperar a que se dispare un evento real.
- Cuando el flujo final va a tener un trigger de evento o schedule, pero necesitás iterarlo rápidamente durante el desarrollo.
- Cuando querés disparar un flujo puntualmente sin configurar un schedule ni esperar un evento del sistema.
Este trigger está pensado principalmente para pruebas y desarrollo. Para automatizaciones en producción que deban iniciarse a horario usá Trigger: Schedule; para que reaccionen a eventos del sistema usá Trigger: Event o Trigger: State Change; para disparos desde sistemas externos usá Trigger: Webhook.
Cómo configurarlo¶
Este nodo no tiene configuración.¶
A diferencia de otros triggers, el nodo Manual no tiene campos que completar. No existe formulario de parámetros — simplemente arrastralo al canvas y conectalo al resto del flujo.
Cómo ejecutarlo¶
Una vez que el nodo está en el canvas y el flujo está armado:
- Asegurate de que el flujo esté guardado (botón Guardar en la barra del editor).
- Hacé click en el botón "Test Automation" (ícono de tubo de ensayo) en la barra superior del editor.
- La automatización se ejecuta de inmediato desde el nodo Manual hacia adelante.
- Para detener una ejecución en curso, hacé click en "Stop Test" (el mismo botón cambia de color a rojo).
El botón "Test Automation" solo está disponible dentro del editor de automatizaciones, no desde el listado general de automatizaciones.
Buenas prácticas¶
- Siempre guardá antes de probar: los cambios no guardados no se ejecutan al hacer "Test Automation".
- Reemplazalo antes de publicar: si el flujo va a producción, reemplazá el nodo Manual por el trigger correcto (Schedule, Event, Webhook, etc.) antes de activarlo.
- Combinalo con el visor de ejecuciones: después de hacer click en "Test Automation", revisá el panel de ejecuciones para ver el resultado de cada nodo y detectar errores.
- No uses Manual en producción si el flujo debe reaccionar automáticamente: el nodo Manual solo se dispara cuando alguien hace click en el botón — no reacciona a eventos del sistema.
- Útil para validar acciones con efectos reales: antes de activar un trigger que enviará SMS o correos masivos, usá el nodo Manual para ejecutar el flujo una sola vez y confirmar el resultado.
Troubleshooting (problemas comunes)¶
- El botón "Test Automation" no hace nada al hacer click
- Verificá que el flujo tenga al menos el nodo Manual conectado a algún otro nodo.
- Guardá el flujo antes de probar.
-
Revisá que no haya una ejecución previa aún en curso (el botón mostraría "Stop Test" en ese caso).
-
El flujo se ejecuta pero no veo resultados
- Abrí el panel de ejecuciones del editor para ver el estado de cada nodo.
-
Si algún nodo quedó en estado de error, revisá su configuración.
-
Quiero que el flujo se dispare automáticamente, no solo con el botón
-
El nodo Manual no dispara automáticamente. Reemplazalo por el trigger adecuado según el caso:
- Eventos del sistema → Trigger: Event
- Horarios → Trigger: Schedule
- GPS / zonas → Trigger: GPS Zone
- HTTP externo → Trigger: Webhook
- Mensajes de chat → Trigger: Chat
-
"Stop Test" no detiene la ejecución de inmediato
- Algunos nodos pueden tardar en completarse (por ejemplo, nodos que esperan respuesta de una API). "Stop Test" cancela la escucha de resultados, pero la ejecución ya enviada puede continuar en el backend hasta completarse.
Configuración avanzada (JSON Editor) — solo usuarios expertos¶
El nodo Manual no tiene campos configurables. Su estructura interna es mínima:
{
"ruleSet": {},
"config": {}
}
No hay campos que modificar desde el JSON Editor. Ambos objetos permanecen vacíos.
Guías rápidas (recetas)¶
Receta A — "Probar el envío de alertas antes de activar el trigger real"¶
- Trigger: Manual
- Flujo: Manual → Action: Send Telegram Message
- Uso: Verificar que el mensaje llega correctamente al grupo de operadores antes de conectar el trigger de evento
Receta B — "Validar una secuencia de acciones complejas"¶
- Trigger: Manual
- Flujo: Manual → Condition: If → (rama verdadera) Action 1 → Action 2 / (rama falsa) Action 3
- Uso: Recorrer el flujo completo a mano para verificar que cada rama se ejecuta correctamente
Receta C — "Demostrar el flujo a un cliente o supervisor"¶
- Trigger: Manual
- Flujo: Manual → [cualquier combinación de nodos del flujo final]
- Uso: Mostrar en vivo cómo funciona la automatización sin tener que esperar a que ocurra el evento real
Receta D — "Ejecutar una tarea puntual una única vez"¶
- Trigger: Manual
- Flujo: Manual → Action: HTTP Request (para notificar a un sistema externo)
- Uso: Disparar una acción de una sola vez sin programar un schedule ni depender de un evento
Receta E — "Iterar rápidamente el prompt de un agente de IA"¶
- Trigger: Manual
- Flujo: Manual → Agent Model (Claude, GPT, etc.) → Action: Send result to Telegram
- Uso: Probar y ajustar el prompt del agente múltiples veces haciendo click en "Test Automation" hasta obtener la respuesta deseada
Referencias internas (para ubicarlo en el editor)¶
- Key del nodo:
manual_trigger - Clase:
trigger - Campos requeridos: ninguno
- Configuración: sin parámetros — no tiene formulario ni JSON Editor relevante
- Cómo se dispara: exclusivamente con el botón "Test Automation" en el editor de automatizaciones
- Icono: ratón (mouse)