Al hablar de automatización, es inevitable pensar en tareas y acciones que se deben realizar en función del tiempo, pero también que esas tareas pueden ser repetitivas semanalmente. Por ejemplo, encender un sistema de riego todos los días a las 6 a.m. y luego apagarlo a las 7:30 a.m.; o algo tan simple como enviar un recordatorio todos los viernes a las 4 p.m. a un técnico que es responsable de un sistema particular que necesita ser calibrado para garantizar su correcto funcionamiento.

En este artículo, aprenderás cómo crear Eventos Programados que permitirán ejecutar alertas o acciones semanales, habilitando tu aplicación para automatizar acciones repetitivas que deben ser activadas en función del tiempo.

NOTA: Este artículo asume que ya tienes un conocimiento básico sobre el motor de Eventos de Ubidots. Si no, te recomendamos encarecidamente revisar este artículo antes, ya que parte de la información en esta guía puede ser desconocida de otro modo.

En términos prácticos, los eventos programados son acciones que se activan de manera regular. Su principal propósito es enviar datos, activar alertas o ejecutar procesos utilizando cualquiera de las acciones integradas del Evento.

En un solo evento programado puedes establecer múltiples horarios, cada uno con su propia lógica de activación y datos de entrada, pero compartiendo las mismas acciones del evento. Para ello, los eventos programados utilizan un objeto JSON como los datos de entrada para el horario, permitiéndote enviar datos personalizados y, por lo tanto, activar diferentes comportamientos en tu aplicación.

1. Para comenzar, dirígete a la pestaña “datos” → "Eventos" y pasa el cursor sobre el botón “+”, ubicado en la esquina superior derecha de la pantalla, y haz clic en el botón “agregar nuevo evento programado”.

2. Luego, elige los días de la semana en los que se activará el horario. Puedes seleccionar múltiples días.

3. A continuación, utiliza el campo “hora” para elegir la hora a la que se debe activar el horario.

4. Opcionalmente, define los datos de entrada que se enviarán cuando se active el evento. Haz clic en el botón "datos de entrada" para crear un objeto JSON con tus parámetros deseados. Esto te permite enviar datos a cualquier variable de Ubidots y activar acciones distintas basadas en estos datos de entrada. Un ejemplo de un JSON válido:

{"value":0, "context":{"type":"deactivation"}}

4.1. En caso de que desees registrar los datos de entrada en una variable existente para fines de control y depuración, puedes hacer clic opcionalmente en el botón alternable para activar esta opción. Elige la variable donde se registrarán los datos de entrada.

4.2. Elige la variable para registrar los datos de entrada haciendo clic en el campo “variable” y seleccionando la variable en el modal que se abre.

CONSEJO PROFESIONAL: Utiliza el botón "+ Agregar Horario" para crear horarios adicionales con datos y tiempos únicos.

Después de completar todos los pasos en la pestaña “activadores” y hacer clic en “siguiente”, pasarás a la pestaña “acciones”. Allí, podrás seleccionar y configurar la acción que se activará cuando se active el evento.

Para una explicación detallada sobre cómo funciona cada una de las acciones y cómo configurarlas, visita su respectivo artículo (enlazado arriba).

Después de completar la configuración de la acción y hacer clic en “siguiente”, procederás al paso final, la pestaña “configuración”. Allí, identificarás tu evento.