Disparador: Programado (tiempo / cron)

Ejecuta un workflow en un horario recurrente usando una expresión cron, ideal para reportes y tareas periódicas.

Jul 11, 2026

Mira este paso en el video · Programados y webhook entrante

El disparador Programado ejecuta un workflow según una expresión cron que tú defines — 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 eliges "Programado" y completas:

  • 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 — convierte manualmente la hora que quieres (por ejemplo, si tu workspace está en UTC-5 y quieres que corra a las 9am hora local, configura 0 14 * * 1, no 0 9 * * 1).
  • Si necesitas 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 necesitas ese conteo, llévalo tú 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, revisa la sintaxis cron (5 campos: minuto hora día-mes mes día-semana), confirma que el workflow esté activo (no en borrador), y recuerda 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 esperas (por ejemplo, para correr "cada 3 ejecuciones"): es un problema conocido, esa variable no incrementa, siempre vale 0.
¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp