⏰ Disparadores Programados para Agentes Gestionados
Los Disparadores Programados permiten que un Agente Gestionado se ejecute automáticamente a una hora específica o de forma recurrente. Puedes crear un horario único, repetir el agente en un intervalo definido, o usar una expresión cron para mayor precisión.
📋 Contenido de este Tutorial
⏰ ¿Qué son los Disparadores Programados?
✨ Beneficios Clave
🕐 Modos de Programación
🏁 Condiciones de Fin para Horarios Recurrentes
🔢 Varios Horarios para un Mismo Agente
💬 Programación en Lenguaje Natural
🌎 Zona Horaria
⚖️ Disparadores Programados vs. Programador de Workflows
🧭 Cómo Configurar un Disparador Programado
❓ Preguntas Frecuentes
⏰ ¿Qué son los Disparadores Programados?
Le dan a un Agente Gestionado un punto de inicio basado en tiempo. En vez de esperar a que alguien lo ejecute manualmente, CRMHUB lo inicia según el horario que configures. Es útil para trabajo operativo recurrente, revisiones programadas, recordatorios, resúmenes, y otras tareas que deben ocurrir en momentos predecibles.
Un Disparador Programado puede iniciar un Agente Gestionado:
Una vez, en una fecha y hora específica.
Repetidamente, en un intervalo definido.
Según una expresión cron personalizada.
Según un horario descrito al constructor en lenguaje simple.
Cada ejecución programada corre el Agente Gestionado completo: sus instrucciones, habilidades configuradas, y acciones de CRM.
✨ Beneficios Clave
Ejecución sin intervención: corre agentes automáticamente sin que alguien los inicie manualmente.
Programación flexible: elige un horario único, un intervalo repetido, o una expresión cron avanzada.
Control de horarios recurrentes: limita las ejecuciones a días específicos de la semana y define cuándo debe terminar el horario.
Varios horarios: agrega más de un horario al mismo agente cuando se necesitan distintas frecuencias.
Zona horaria local: los horarios corren según la zona horaria local de tu cuenta.
Visibilidad de ejecución: revisa la actividad programada en el feed de actividad del agente.
Configuración en lenguaje natural: describe el horario al constructor en vez de configurar cada campo manualmente.
🕐 Modos de Programación
Una Vez
Usa esta opción cuando el agente debe ejecutarse una sola vez en una fecha y hora específica. Ejemplos: una revisión de fin de mes, un recordatorio único, preparar un reporte antes de una reunión programada.
Intervalo Definido
Usa esta opción cuando el agente debe ejecutarse repetidamente a una cadencia regular. Unidades disponibles: minutos, horas, días, semanas, meses. Los horarios recurrentes también pueden incluir días de la semana específicos, sin fecha de fin, con fecha de fin, o un número máximo de ejecuciones.
Ejemplo: un agente puede ejecutarse cada martes, miércoles y jueves a las 9:00 AM hasta fin de mes.
Expresión Cron
Úsala para horarios avanzados que requieren mayor precisión que un intervalo estándar. Es ideal para quienes ya están familiarizados con la programación basada en cron.
⚠️ Revisa la expresión cuidadosamente antes de publicar el agente, para asegurar que representa el horario que realmente quieres.
🏁 Condiciones de Fin para Horarios Recurrentes
Un horario recurrente puede configurarse para terminar:
Nunca: el horario continúa hasta que se cambie o elimine.
En una fecha específica: el horario se detiene después de la fecha seleccionada.
Después de un número de ejecuciones: el horario se detiene tras completar el número especificado.
Usa una condición basada en fecha para iniciativas de tiempo limitado (ej. campañas mensuales). Usa una condición basada en número de ejecuciones cuando el agente deba completar una cantidad conocida de corridas programadas.
🔢 Varios Horarios para un Mismo Agente
Permite que un Agente Gestionado soporte más de una cadencia operativa, reduciendo la necesidad de crear agentes duplicados cuando las instrucciones, habilidades y acciones de CRM son las mismas.
Por ejemplo, un mismo agente puede configurarse para: hacer una revisión diaria de cuenta, generar un resumen semanal, y correr una revisión única adicional a fin de mes. Cada horario se configura por separado dentro del área de Disparadores del agente.
💬 Programación en Lenguaje Natural
Permite que el constructor configure un Disparador Programado a partir de una solicitud en lenguaje simple. Por ejemplo, puedes decirle: "Ejecuta esto cada martes, miércoles y jueves a las 9 AM hasta fin de mes." El constructor interpreta la cadencia solicitada y configura el disparador. Revisa el horario resultante antes de publicar el agente para confirmar que las fechas, horas, días de la semana y condición de fin coinciden con tu intención.
🌎 Zona Horaria
Los Disparadores Programados usan la zona horaria local de tu cuenta. Verificarla antes de publicar ayuda a evitar que el agente se ejecute antes o después de lo esperado — especialmente importante si tu equipo trabaja en distintas regiones, o si el agente da soporte a contactos en múltiples zonas horarias.
⚖️ Disparadores Programados vs. Programador de Workflows
Ambos soportan automatización basada en tiempo, pero inician tipos distintos de automatización:
Un Disparador Programado inicia un Agente Gestionado y ejecuta sus instrucciones, habilidades y acciones de CRM.
Un Programador de Workflow inicia un workflow de CRMHUB.
Usa Disparadores Programados cuando la tarea debe completarla un Agente Gestionado. Usa el Programador de Workflow cuando el proceso debe manejarse mediante acciones y lógica de workflow.
🧭 Cómo Configurar un Disparador Programado
Paso 1: Abre el Estudio de Agentes IA en tu cuenta y abre el Agente Gestionado que quieres programar.
Paso 2: Haz clic en "Editar Agente" y luego en "Agregar Disparador".
Paso 3: Selecciona "Programar".
Paso 4: Elige un modo de programación: Una Vez, Intervalo Definido, o Expresión Cron.
Paso 5: Configura la temporización requerida:
Para un horario único: selecciona la fecha y la hora.
Para un intervalo recurrente: ingresa el intervalo, selecciona minutos/horas/días/semanas/meses, selecciona los días de la semana aplicables, y elige una condición de fin.
Para un horario cron: ingresa la expresión cron que representa el horario requerido.
Paso 6: Revisa el horario usando la zona horaria local de tu cuenta.
Paso 7: Agrega otro horario si el agente requiere más de una cadencia.
Paso 8: Publica el Agente Gestionado. El horario se activa después de publicarse — no se requiere ninguna acción manual adicional.
❓ Preguntas Frecuentes
¿Un Disparador Programado ejecuta todo el Agente Gestionado? Sí. Cada ejecución programada corre las instrucciones, habilidades y acciones de CRM del agente, tal como lo haría una ejecución en vivo.
¿El agente necesita estar publicado? Sí. Publicar el Agente Gestionado activa su horario configurado.
¿Qué zona horaria usa el horario? La zona horaria local de tu cuenta.
¿Un mismo agente puede tener más de un horario? Sí. Puedes agregar varios horarios cuando el agente necesita correr en distintas cadencias.
¿Un horario recurrente puede correr solo en días específicos de la semana? Sí. Los horarios recurrentes pueden limitarse a días específicos.
¿Puedo detener un horario recurrente automáticamente? Sí. Puede continuar indefinidamente, terminar en una fecha específica, o detenerse después de un número configurado de ejecuciones.
