Ir al contenido principal

Eventos: crear una alerta basada en contexto

Aprende a activar un evento usando el contexto de una variable.

Escrito por Sergio M

Aprovecha al máximo los datos de tu operación configurando eventos que se activen según el contexto de tus variables.

Requisitos

  • Cuenta con un plan activo.

1. Crear un evento con activador basado en contexto

1.1. Activadores

Para comenzar, ve a la pestaña "datos" → "Eventos" y pasa el cursor sobre el botón "+", ubicado en la esquina superior derecha de la pantalla, y crea un evento condicional, evento global o evento programado según tus necesidades.

Una vez que aparezca el modal del evento, estarás en la primera etapa de configuración, donde definirás la lógica de los activadores. Aquí es donde configuraremos nuestra alerta basada en contexto.

1. Haz clic en los botones "+ agregar activador" o "+ agregar grupo OR" y selecciona "basado en contexto". De forma predeterminada, un evento recién creado carga con un activador basado en valor, pero puedes eliminarlo o configurarlo también si se adapta a tus necesidades.

2. Selecciona una variable por expresión condicional. Se pueden agregar múltiples variables usando condicionales AND ("+ agregar activador") / OR ("+ agregar grupo OR").

3. Ingresa la clave de contexto que deseas rastrear. Ten en cuenta que este campo distingue entre mayúsculas y minúsculas, así que asegúrate de ingresar exactamente la clave que se envía al contexto de tu variable.

4. Selecciona el tipo de dato del valor de la clave de contexto. El menú desplegable "Tipo de dato" te permite especificar cómo debe interpretarse el valor de la clave:

  • Cadena de texto (predeterminado): Los valores se comparan como texto plano. Este es el comportamiento para todos los eventos existentes.

  • Número: Los valores se interpretan como numéricos (enteros o decimales). Úsalo cuando tu payload de contexto contenga lecturas de sensores o conteos.

  • Booleano: Los valores se comparan como verdadero/falso. Úsalo para indicadores de encendido/apagado o estados binarios.

5. Define la condición del activador. Estas varían según el "tipo de dato" seleccionado en el paso anterior.

Cadena de texto:

  • Es: Se activa si el valor coincide exactamente.

  • Contiene: Se activa si el valor contiene parcialmente el texto.

  • No es: Se activa si el valor es cualquier cosa distinta al texto definido.

Número:

  • Es: Se activa si el valor numérico analizado es igual al número configurado.

  • No es: Se activa si el valor numérico analizado difiere del número configurado.

  • Mayor que: Se activa si el valor es estrictamente superior al número configurado.

  • Mayor o igual que: Se activa si el valor es igual o superior al número configurado.

  • Menor que: Se activa si el valor es estrictamente inferior al número configurado.

  • Menor o igual que: Se activa si el valor es igual o inferior al número configurado.

Booleano:

  • Es: Es la única condición disponible. La comparación no distingue entre mayúsculas y minúsculas ("true", "True" y "TRUE" coinciden con True; lo mismo aplica para False). Valores como "1", "0", "yes" o "on" no coinciden.

6. Ingresa el valor de la clave que determinará la activación del evento.

  • Cadena de texto: Campo de texto libre, distingue entre mayúsculas y minúsculas.

  • Número: Solo entrada numérica.

  • Booleano: El campo de texto libre se reemplaza por un menú desplegable con Verdadero y Falso (Verdadero preseleccionado).

Nota: Si el tipo de dato seleccionado es "cadena de texto", este campo distingue entre mayúsculas y minúsculas, así que asegúrate de ingresar exactamente el valor que se envía al contexto de tu variable. Esto aplica incluso cuando la condición está configurada como "contiene".

7. Por último, define cuánto tiempo debe transcurrir para que el evento se active si las condiciones configuradas siguen siendo verdaderas.

Si dejas esta opción en el valor predeterminado "0", tan pronto como tu dispositivo reciba un payload de contexto que coincida con tu configuración de activador, el evento se activará. Si, por ejemplo, eliges 5 minutos, el evento solo se activará si el último payload de contexto recibido aún coincide con tus condiciones; por otro lado, si el dispositivo recibe un payload de contexto con un valor de clave diferente al definido después de 4 minutos, el evento no se activará.

Basándote en lo anterior, tiene sentido definir este tiempo según la frecuencia con la que se actualiza la variable.

1.2. Acciones

Tras 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 ejecutará cuando el evento se active.

  1. Haz clic en el botón "+ agregar acción" para iniciar este proceso. Estas son las opciones disponibles:

Para una explicación detallada sobre cómo funciona y cómo configurar cada acción, visita su artículo correspondiente (enlazado arriba).

1.3. Configuración

Tras completar la configuración de la acción y hacer clic en "siguiente", pasarás al paso final, la pestaña "configuración". Allí identificarás tu evento y definirás sus ventanas de actividad.

  1. Comienza esta etapa nombrando tu evento y, opcionalmente, añadiéndole una descripción para que sea fácil de distinguir de otros eventos más adelante.

  2. Otro paso opcional es usar una etiqueta en el evento. Esta es una excelente herramienta para controlar lo que tus usuarios finales ven en tu aplicación. En este caso, por ejemplo, podrías decidir que tu usuario final vea un evento pero no otro, usando etiquetas. Aprende más sobre las etiquetas aquí.

  3. Determina la ventana de actividad en la que deben ejecutarse los eventos. Un evento puede tener múltiples ventanas activas haciendo clic en el botón "+ agregar ventana" y configurándolas de forma correspondiente. Para obtener más información sobre cómo y cuándo se activa un evento, consulta esta guía.

¿Ha quedado contestada tu pregunta?