Disparador: Programado (tiempo / cron)

El disparador Programado ejecuta un workflow según una expresión cron que vos definís — no depende de ningún evento del inbox ni de un contacto, corre en el horario que configures.

Cuándo usarlo

Es el disparador para todo lo recurrente: un resumen diario de conversaciones pendientes, un reporte semanal al equipo, un chequeo periódico de negocios sin actividad, o cualquier automatización que necesite correr "sola" cada cierto tiempo.

Configuración

En el nodo Disparador elegís "Programado" y completás:

• Expresión cron (obligatorio): por ejemplo 0 9 * * 1 para "todos los lunes a las 9am", o 0 8 * * * para "todos los días a las 8am". ⚠️ Esta hora se evalúa en UTC del servidor, no en la zona horaria de tu workspace (ver Consejos).

Variables disponibles

• $scheduled.execution_time (timestamp de la ejecución)
• $scheduled.iteration — ⚠️ hoy siempre vale 0: el sistema no lleva un contador real de ejecuciones por workflow, así que no la uses para lógica de "una vez cada N ejecuciones" como podría sugerir su nombre.

Ejemplo

Workflow "Resumen semanal al Team": Disparador = Programado, cron = 0 9 * * 1. Acción: consultar conversaciones abiertas de la semana y publicar un mensaje resumen en el Espacio "Gerencia" del Team.

Consejos

• El cron corre en UTC del servidor, no en la zona horaria configurada en tu workspace — convertí manualmente la hora que querés (por ejemplo, si tu workspace está en UTC-5 y querés que corra a las 9am hora local, configurá 0 14 * * 1, no 0 9 * * 1).
• Si necesitás un vocabulario más moderno para recetas de CRM/Proyectos, existe el disparador equivalente "Programado (tiempo)" bajo la categoría Tiempo — funciona exactamente igual.
• No uses $scheduled.iteration para lógica de "cada N ejecuciones": hoy siempre llega en 0. Si necesitás ese conteo, llevalo vos con otro mecanismo (por ejemplo, un campo persistente que actualices en cada corrida).

Solución de problemas

• Si el workflow no corre a la hora esperada, revisá la sintaxis cron (5 campos: minuto hora día-mes mes día-semana), confirmá que el workflow esté activo (no en borrador), y recordá que la hora se evalúa en UTC, no en la zona horaria de tu workspace.
• Si tu lógica basada en {{$scheduled.iteration}} no funciona como esperás (por ejemplo, para correr "cada 3 ejecuciones"): es un problema conocido, esa variable no incrementa, siempre vale 0.