Trigger programado

Un trigger programado lanza una ejecución automáticamente, a la hora o frecuencia que definas con una expresión cron. Es lo que convierte una automatización en algo que de verdad se ejecuta solo: cada noche, cada lunes, cada 15 minutos, sin que nadie tenga que acordarse.

Crear un trigger programado

1. Elige el ambiente arriba a la derecha y abre Centro › Robots › Disparadores.
2. Haz clic en Nuevo disparador. Se abre un asistente de cuatro pasos:
   • Qué ejecuta: Un proceso (o Un flujo) y cuál.
   • Cuándo corre: Un horario. Elige la frecuencia (Todos los días, Lunes a viernes, Ciertos días de la semana, Una vez al mes, Cada cierto número de horas, Cada cierto número de minutos o Personalizado (expresión cron)) y la zona horaria. El panel Próximas ejecuciones te muestra cuándo correrá.
   • Dónde corre: la máquina y la sesión de robot, y si quieres, la duración máxima de cada ejecución.
   • Revisar y crear: ponle un nombre (ej. Conciliación nocturna) y pulsa Crear disparador. Queda activo al crearlo.

A partir de ahí, Zoan Cloud crea una ejecución cada vez que el reloj coincide con la expresión cron, en la zona horaria elegida.

La expresión cron

La expresión cron define el horario. Por ejemplo, 0 8 * * 1-5 significa “lunes a viernes a las 8:00 a.m.”. Tienes la referencia completa con ejemplos en Expresiones cron.

Zona horaria

El horario se interpreta en la zona horaria que selecciones, no en UTC por defecto. Elegir la correcta es esencial para que el proceso se ejecute cuando esperas.

Colombia

Usa America/Bogota (UTC-5, sin horario de verano).

Cuidado con el horario de verano (DST)

Si tu zona aplica cambio de horario de verano, una ejecución programada a una hora concreta puede saltarse o repetirse el día del cambio. Para procesos críticos, evita programarlos en la franja horaria donde ocurre el ajuste (normalmente de madrugada).

Activar y desactivar

Puedes activar o desactivar un trigger en cualquier momento desde la lista, sin eliminarlo. Un trigger desactivado no genera ejecuciones aunque llegue su hora programada — útil para pausar un proceso durante un mantenimiento o mientras corriges algo, sin perder su configuración.

¿Qué conviene programar?

Programa por horario los procesos que deben ocurrir solos, de forma recurrente y en un momento conocido — sin que nadie tenga que acordarse de lanzarlos.

Buen candidato a programar	Ejemplo
Tareas recurrentes de calendario	Conciliación bancaria cada noche; reporte de ventas cada lunes 8 a.m.
Procesos que dependen de un cierre o corte	Facturación al cierre de mes; nómina quincenal
Sondeos periódicos	Revisar una bandeja de correo o una carpeta cada 15 minutos
Alimentar una cola (dispatcher)	Encolar las facturas del día a las 6 a.m. para que los bots las procesen
Mantenimientos fuera de horario	Limpieza o respaldos de madrugada, cuando los sistemas están libres

No lo programes si el proceso se dispara por una acción concreta (lo lanza una persona cuando lo necesita → ejecución manual; lo llama otro sistema → trigger por webhook) o si depende de un evento externo impredecible en lugar del reloj.

Programar vs. cola

No son excluyentes, se combinan: el trigger programado decide cuándo empieza el trabajo; la cola reparte ese trabajo entre varios bots. El patrón típico es un trigger que, a una hora fija, lanza el proceso dispatcher que llena la cola.

Buenas prácticas

• Verifica primero con una ejecución manual que el proceso se ejecuta bien, y solo entonces prográmalo.
• Asegura que haya un agente online en la franja programada. Si el proceso se ejecuta a las 2 a.m., el agente (idealmente un servicio desatendido) debe estar encendido y conectado a esa hora.
• No solapes ejecuciones: si un proceso puede tardar más que el intervalo entre ejecuciones (ej. cada 5 min pero a veces tarda 8), tenlo en cuenta para no acumular ejecuciones.
• Una zona horaria explícita evita sorpresas; no dependas de valores por defecto.

Siguientes pasos

• Iniciar casos de un flujo — un disparador programado también puede iniciar un flujo.
• Expresiones cron — sintaxis y ejemplos.
• Monitoreo de agentes — garantizar disponibilidad a la hora programada.
• Logs de ejecución — revisar que las ejecuciones automáticas funcionan.