Notificar a los usuarios sobre incidentes o procesos críticos en el momento adecuado es fundamental para una operación que funcione de manera óptima. Ubidots simplifica este proceso con la acción de evento Notify User, permitiéndote seleccionar usuarios o contactos de tu cuenta y notificarles vía SMS, correo electrónico o llamada de voz.

Aprende cómo crear una acción Notify User siguiendo esta guía.

Requisitos

Licencia Industrial de Ubidots o superior

1. Agregar información de contacto

1.1. A usuarios

Para agregar información de contacto a tus usuarios, sigue estos pasos:

Dirígete a la pestaña “Users” en la barra de navegación principal → “Users”.
Haz clic en el botón “+” ubicado en la esquina superior derecha de la pantalla para crear un nuevo usuario. Sigue esta guía para crear un nuevo usuario.
En la segunda etapa del proceso de creación del usuario, ingresa la información de contacto del usuario.

Notas:

Asegúrate de incluir los códigos de país en los números telefónicos (por ejemplo, "+1" para EE. UU.) para garantizar la entrega del mensaje. Por ejemplo, escribir 1 212 361 4595 funcionaría para un número estadounidense.
Para agregar información de contacto a un usuario ya existente, simplemente edita ese usuario y dirígete a la sección “contact method”.

1.2. Como contactos independientes

También puedes crear "contactos" utilizando el módulo Address Book. Los contactos creados de esta manera son diferentes de los usuarios regulares, ya que no tienen credenciales de inicio de sesión ni necesariamente interactúan con la plataforma; solo se utilizan para notificar a las partes relevantes sobre cualquier evento operativo. Aprende cómo crear contactos aquí.

2. Crear un nuevo evento

Para comenzar, dirígete a la pestaña “data” → "Events" y coloca 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.

Luego, configura los disparadores del evento con lógica AND/OR. Para más detalles sobre cómo configurar estos disparadores, consulta sus guías correspondientes: basado en valor, inactividad, geocerca.

3. Configurar la acción Notify User

Con la lógica de "trigger" configurada, ahora es momento de establecer la acción Notify User.

1. Haz clic en el botón “+ add action”. De las opciones disponibles, selecciona “Notify User”.

2. Elige si los destinatarios serán seleccionados uno por uno mediante una lista de usuarios/contactos o mediante una etiqueta compartida (los usuarios que compartan la etiqueta con la acción del evento serán notificados).

3. Selecciona los usuarios o contactos a notificar usando la opción correspondiente. Si elegiste usar etiquetas, escríbelas en el campo designado. Puedes ingresar:

Etiquetas estáticas (por ejemplo, cold-room, maintenance-team)
El marcador dinámico {{device.tags}} para usar automáticamente las etiquetas asignadas al dispositivo que activó el evento
El marcador dinámico {{device.properties.<key>}} para usar una propiedad específica del dispositivo como fuente de etiquetas. Para usar esta opción, la propiedad del dispositivo debe configurarse de una de las siguientes maneras:
- Formato Texto: Establece el formato de la propiedad en Text e ingresa un único valor de etiqueta en el campo value.
- Formato JSON: Establece el formato de la propiedad en JSON e ingresa un arreglo de etiquetas en el campo value (por ejemplo: ["tag1", "tag2"]).
En ambos casos, reemplaza <key> en {{device.properties.<key>}} con el valor definido en el campo key de la propiedad (no el nombre).

Los marcadores dinámicos se resuelven utilizando el dispositivo que activó el evento. Si se proporcionan múltiples fuentes estáticas y dinámicas, Ubidots combinará las etiquetas resultantes antes de enviar la notificación.

La información de contacto configurada en los ajustes de cada usuario (sección 1) se utilizará para la entrega.

4. Elige uno o varios métodos de contacto entre las siguientes opciones:

Correo electrónico
SMS
Llamada de voz

5. Personaliza los textos de “active trigger” y “back to normal” (opcional) que se enviarán a los usuarios receptores. Si “email” fue uno de los métodos de contacto seleccionados, también puedes cambiar el asunto del mensaje.

Al usar el ícono de etiqueta en la esquina superior derecha de los campos “subject” y “message”, puedes agregar fácilmente información como ID del dispositivo, marca de tiempo, nombre de la variable, etc.

Nota: Por defecto, los datos que incluyen marcas de tiempo se envían en formato legible por humanos (YYY-MM-DD HH:mm:ss TZ). Si prefieres adjuntar tiempo UNIX epoch en milisegundos, haz doble clic en el dato y elimina el texto desde el símbolo de tubería ("|") hasta el final, como se muestra a continuación.

6. Opcionalmente, habilita “repeat action” si deseas repetir la acción múltiples veces mientras el evento esté activo. Puedes elegir la frecuencia y cuántas veces se repetirá la acción. Hay un límite de 50 repeticiones.

7. Haz clic en “save” cuando termines de configurar la acción y luego en “next”, a menos que desees configurar múltiples acciones.

8. Después de completar la configuración de la acción, pasarás al paso final, la pestaña “settings”. Allí podrás nombrar el evento y agregar una descripción (opcional).

9. 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 etiquetas aquí.

10. Finalmente (a menos que el evento creado sea un evento programado), define la ventana de actividad en la que los eventos deben ejecutarse. Un evento puede tener múltiples ventanas activas haciendo clic en el botón “+ add window” y configurándolas según corresponda. Después de finalizar, haz clic en “save” y tu evento será desplegado.