Configurar texto de notificación
Esta página describe el sistema de notificaciones rediseñado con una lógica de combinación de condiciones actualizada, bloques de condiciones flexibles y una nueva interfaz de pantalla completa. Si su cuenta aún no ha sido actualizada al nuevo sistema de notificaciones, consulte la versión anterior de la documentación de notificaciones.
Puede especificar el texto para determinadas acciones de notificación en el paso 4 de la configuración de notificación. Este paso está disponible si seleccionó una de las siguientes acciones en el paso anterior:
- Notificar por email
- Notificar por SMS
- Enviar notificación a Telegram
- Mostrar notificación en línea en una ventana emergente
- Enviar una notificación móvil
- Enviar una solicitud
- Registrar evento para la unidad
Cuando abre este paso, el texto de notificación se completa automáticamente con una plantilla predeterminada. Este texto predeterminado se genera basándose únicamente en la primera condición configurada; no tiene en cuenta ninguna condición adicional. Puede editar manualmente este texto y agregar etiquetas relevantes para todas las condiciones incluidas.
El texto de notificación puede estar en cualquier idioma y contener cualquier carácter.
Si selecciona la acción Notificar por SMS, no es recomendable especificar un texto largo. Si la longitud del texto excede la longitud máxima permitida del mensaje SMS, el texto se envía en varios mensajes.
Si selecciona la acción Enviar una solicitud, debe ingresar los parámetros de la solicitud en el texto de notificación. Además de los parámetros, puede ingresar texto utilizando codificación URL. Si utiliza esta acción junto con otras (por ejemplo, notificar por email), se generará el mismo texto para todas las notificaciones.
Uso de etiquetas
Puede agregar etiquetas al texto. Estas son palabras clave que se reemplazan con valores reales cuando se activa la notificación.
Una etiqueta debe estar marcada con un signo de porcentaje en ambos lados. De lo contrario, se considera texto sin formato y no se reemplaza por valores reales.
Por ejemplo, al ingresar el texto:
%UNIT% ha violado el límite de velocidad. En %POS_TIME% se movió con una velocidad de %SPEED% cerca de %LOCATION%
se convierte en:
Unidad KIA 299-SMD ha violado el límite de velocidad. En 2025-05-01 12:01:37 se movió con una velocidad de 156 km/h cerca de Calle Arenas de San Pedro
Para agregar una etiqueta al texto, haga clic en ella en la lista debajo del cuadro de texto o ingrésela manualmente.
Etiquetas en notificaciones con condiciones combinadas (operador «O»)
Al usar el operador O, el texto de notificación no cambia según qué condición activó la notificación; se utiliza la misma plantilla para todas. Solo las etiquetas relacionadas con la condición que realmente activó la notificación se reemplazan con valores reales. Las etiquetas que pertenecen a condiciones que no se activaron permanecen en el mensaje entregado como texto sin formato (por ejemplo, %SPEED% o %ADDRESS%). Si el mismo tipo de condición se usa varias veces (por ejemplo, Valor del sensor O Valor del sensor), la etiqueta refleja el valor del sensor que activó la notificación.
Reglas de formato para etiquetas
- Las unidades de medición (kilómetros o millas) utilizadas para descifrar las etiquetas dependen de la configuración del recurso al que pertenece la notificación.
- El formato de fecha y hora se toma de la configuración del creador del recurso.
- Las etiquetas de tiempo utilizan la zona horaria especificada para el creador del recurso en el que se almacena la notificación.
Preguntas y respuestas
Categorías de etiquetas y disponibilidad
El conjunto de etiquetas disponibles para usar depende de la condición o condiciones específicas que seleccionó en el paso 1 de la configuración de notificación.
Debajo del campo de entrada de texto, las etiquetas se agrupan en categorías, como Etiquetas generales y etiquetas específicas de la condición (por ejemplo, Entrada a geocerca). Puede hacer clic en los enlaces junto a Ir a: para ver la lista relevante de etiquetas.
Etiquetas generales
A continuación se muestra una lista de etiquetas generales disponibles para la mayoría de los tipos de notificaciones.
| Etiqueta | Descripción |
|---|---|
%UNIT% |
El nombre de la unidad. |
%UNIT_ID% |
El ID interno de la unidad en el sistema. |
%CURR_TIME% |
La fecha y hora actual. |
%LOCATION% |
La ubicación de la unidad en el momento de la notificación. Determinada por la fuente de geodatos seleccionada en los parámetros del usuario que creó el recurso en el que se almacena la notificación. Para una condición Descarga de combustible, se muestra la ubicación al inicio de la descarga. |
%LAST_LOCATION% |
La última ubicación de la unidad en el momento de la notificación. Determinada por la fuente de geodatos seleccionada en los parámetros del usuario que creó el recurso. Esta etiqueta es útil si el mensaje que activó la notificación no contiene datos de ubicación. |
%LOCATOR_LINK(60,T)% |
Crea un enlace del localizador para la unidad activante. Entre paréntesis, indique la duración en minutos y use los parámetros T y G para mostrar recorridos y geocercas. La duración predeterminada es 60 minutos. Para una duración ilimitada, ingrese 0 (cero). |
%ZONE_MIN% |
La más pequeña de las geocercas en las que se econtraba la unidad en el momento en que se activó la notificación. El nombre de la geocerca se muestra en lugar de la etiqueta solo si la geocerca y la notificación pertenecen al mismo recurso. |
%ZONES_ALL% |
Todas las geocercas en las que se encontraba la unidad en el momento en que se activó la notificación. |
%UNIT_GROUP% |
Grupos que contienen la unidad activante. |
%SPEED% |
Velocidad de la unidad en el momento de la notificación. La etiqueta no funciona en notificaciones sobre llenados, descargas y recargas de combustible. |
%POS_TIME% |
La fecha y hora del mensaje que activó la notificación. Si este mensaje no contiene datos de ubicación, la etiqueta se reemplaza con la fecha y hora del último mensaje con estos datos. |
%MSG_TIME% |
La fecha y hora del mensaje que activó la notificación. |
%MSG_TIME_INT% |
Tiempo Unix del mensaje que activó la notificación. |
%NOTIFICATION% |
El nombre de la notificación. |
%DRIVER% |
El nombre del conductor asignado a la unidad en el momento en que se activó la notificación. Se muestra solo si el conductor pertenece al mismo recurso que la notificación. |
%DRIVER_PHONE% |
El número de teléfono del conductor. |
%TRAILER% |
El nombre del remolque asignado a la unidad en el momento en que se activó la notificación. Se muestra solo si el remolque pertenece al mismo recurso que la notificación. |
%VIDEO_LINK(480)% |
Enlaces a los archivos de vídeo guardados para la notificación activada. Estos enlaces se generan cuando la acción Guardar un vídeo como archivo se configura junto con cualquier acción que permita entrada de texto. Entre paréntesis, especifique el período de validez de los enlaces en minutos en el rango entre 480 (mínimo) y 2880 (máximo). Un valor fuera de este rango se restablece al valor predeterminado de 480 minutos. |
%SENSOR(*)% |
Sensores y sus valores. Especifique el nombre del sensor o máscara entre paréntesis. Si deja el asterisco entre paréntesis, se muestran todos los sensores de la unidad y sus valores. La etiqueta no funciona en notificaciones sobre llenados de combustible, descargas de combustible y recargas de batería. Los valores de los sensores se pueden mostrar en forma redondeada. Para este propósito, se debe seleccionar el formato de redondeo requerido en sus parámetros de usuario. Si no ha iniciado sesión, pero se activa la notificación, el formato se toma de los parámetros del usuario que creó el recurso donde se almacena la notificación. Si se especifica Encendido/Apagado como unidad de medida para un sensor digital, o si no se indica ninguna unidad de medida, la etiqueta se reemplaza por Encendido u Apagado. Si se especifica otra unidad de medida, por ejemplo, Activado/Desactivado, la etiqueta se reemplaza por estos valores. |
%ENGINE_HOURS% |
El valor de horas de motor en el momento en que se activó la notificación. |
%MILEAGE% |
El valor de kilometraje en el momento en que se activó la notificación. |
%LAT% |
Latitud en el momento en que se activó la notificación (por ejemplo, N 55° 45.7530'). |
%LON% |
Longitud en el momento en que se activó la notificación (por ejemplo, E 37° 35.2068'). |
%LATD% |
Latitud sin formato. |
%LOND% |
Longitud sin formato. |
%GOOGLE_LINK% |
El enlace a Google Maps con la ubicación de la unidad en el momento en que se activó la notificación (por ejemplo, http://maps.google.com/?q=55.762550N,37.586780E). |
%CUSTOM_FIELD(*)% |
Los campos personalizados de las propiedades de la unidad. Si deja el asterisco entre paréntesis, se muestran todos los campos personalizados, incluidos los administrativos, y sus valores. Para obtener el valor de un campo determinado, especifique su nombre completo entre paréntesis. En este caso, solo se muestra el valor del campo en la notificación (sin el nombre del campo). |
Actividad de ruta
Estas etiquetas describen el estado actual de la unidad y su ubicación a lo largo de una ruta programada.
| Etiqueta | Descripción |
|---|---|
%ROUTE_NAME% |
El nombre de la ruta. |
%ROUTE_STATUS% |
El estado de la rutina. |
%ROUTE_POINT% |
El nombre del punto de control de la ruta. |
%ROUTE_SCHEDULE% |
El nombre del horario de la ruta. |
%ROUND_NAME% |
El nombre de la rutina. |
Asignación de conductor
Use estas etiquetas para identificar al conductor asignado a la unidad.
| Etiqueta | Descripción |
|---|---|
%DRIVER_ID% |
El código del conductor. |
%DRIVER_NAME% |
El nombre del conductor. |
Asignación de pasajero, Pasajero no separado
Use estas etiquetas para mostrar detalles sobre pasajeros identificados.
| Etiqueta | Descripción |
|---|---|
%TAG_ID% |
El código del pasajero. |
%TAG_NAME% |
El nombre del pasajero. |
Asignación de remolque
Estas etiquetas muestran información sobre el remolque actualmente asignado a la unidad.
| Etiqueta | Descripción |
|---|---|
%TRAILER_ID% |
El código del remolque. |
%TRAILER_NAME% |
El nombre del remolque. |
Diferencia de valores del sensor, Rango de valores del sensor
Estas etiquetas muestran información sobre los sensores específicos que activaron la notificación.
| Etiqueta | Descripción |
|---|---|
%SENSOR_NAME% |
El nombre del sensor que activó la notificación. Si se selecciona la opción Sumar valores, entonces de todos los sensores cuyos valores se suman, la etiqueta se reemplaza con el nombre del sensor que tiene el ID más pequeño en el sistema. Por lo tanto, el nombre que aparece en lugar de la etiqueta no depende del valor del sensor. |
%SENSOR_VALUE% |
El valor del sensor que activó la notificación. |
%TRIGGERED_SENSORS% |
Todos los sensores que activaron la notificación y sus valores. En contraste con la etiqueta %SENSOR_NAME%, aquí puede ver exactamente aquellos sensores cuyos valores se encuentran dentro del rango especificado (si se selecciona el tipo de activación En el rango) o están fuera del rango (si se selecciona el tipo de activación Fuera del rango). |
%SENSOR_VALUE_OLD% |
El valor del sensor del mensaje anterior. |
Dirección
Use estas etiquetas para desglosar los componentes específicos de dirección de la ubicación de la unidad.
En la notificación activada con la condición Dirección, en lugar de las etiquetas a continuación, se muestra la información de la dirección especificada en el paso 1 de la configuración de notificación. El formato de dirección se toma de la fuente de geodatos en los parámetros del usuario que creó el recurso donde se almacena la notificación.
| Etiqueta | Descripción |
|---|---|
%COUNTRY% |
El nombre del país. |
%REGION% |
El nombre de la región (estado, etc.). |
%CITY% |
El nombre de la ciudad (pueblo, etc.). |
%STREET% |
El nombre de la calle. |
%HOUSE% |
El número de la casa. |
Entrada en geocerca
Use estas etiquetas para incluir información sobre la interacción de la unidad con áreas específicas.
| Etiqueta | Descripción |
|---|---|
%ZONE_INSIDE% |
El nombre de la geocerca sobre la cual se recibe la notificación. |
%ZONE_DESC% |
La descripción de las propiedades de geocerca. |
Estado de conexión
Esta etiqueta indica si se perdió o restauró la conexión de la unidad al servidor.
| Etiqueta | Descripción |
|---|---|
%LOSE_RESTORE% |
Pérdida o restauración de conexión. |
Estado de parámetro
Estas etiquetas muestran los parámetros específicos y sus valores enviados por el dispositivo.
| Etiqueta | Descripción |
|---|---|
%PARAM_NAME% |
El nombre del parámetro controlado mediante la notificación. |
%PARAM_VALUE% |
El valor del parámetro. |
Estado de salud
Estas etiquetas resumen el estado de salud operativo del dispositivo y describen cualquier problema activo.
| Etiqueta | Descripción |
|---|---|
%HEALTH_CHECK_STATUS% |
El estado de salud del dispositivo en el momento de la activación de la notificación. |
%REASON% |
Lista de incidentes activos en el momento de la activación de la notificación. |
Llenados de combustible, descargas y recargas de batería
Estas etiquetas proporcionan datos completos sobre eventos de reposición o pérdida de energía.
| Etiqueta | Descripción |
|---|---|
%TYPE% |
El tipo de reposición de energía: un llenado de combustible o una recarga de batería. Se usa para las condiciones Llenado de combustible y Carga de batería. |
%VOLUME% |
El volumen del llenado de combustible, descarga de combustible o recarga de batería. |
%INITIAL_LEVEL% |
El nivel de combustible al comienzo de un llenado de combustible o descarga de combustible, o el nivel de batería al comienzo de una recarga de batería. |
%FINAL_LEVEL% |
El nivel de combustible al final de un llenado de combustible o descarga de combustible, o el nivel de batería al final de una recarga de batería. |
%TIME_FROM% |
La hora en que comenzó un llenado de combustible, descarga de combustible o recarga de batería. |
%TIME_TO% |
La hora en que finalizó un llenado de combustible, descarga de combustible o recarga de batería. |
%SENSOR_NAME% |
El nombre del sensor que activó la notificación. Si se selecciona la opción Sumar valores, entonces de todos los sensores cuyos valores se suman, la etiqueta se reemplaza por el nombre del sensor que tiene el ID más pequeño en el sistema. Por lo tanto, el nombre que ve en lugar de la etiqueta no depende del valor del sensor. |
%DURATION% |
La duración de un llenado de combustible, descarga de combustible o recarga de batería en minutos. |
Límite de mensajes
Esta etiqueta indica la cantidad total de mensajes recibidos durante el período especificado.
| Etiqueta | Descripción |
|---|---|
%MSG_COUNT% |
La cantidad de mensajes. |
Límites de velocidad en vías
Estas etiquetas proporcionan detalles sobre los límites de velocidad de la carretera y cuánto se excedieron.
| Etiqueta | Descripción |
|---|---|
%SPEED_LIMIT% |
El límite de velocidad en el momento de activar la notificación. |
%SPEEDING_VALUE% |
El valor en el cual se excedió el límite de velocidad. |
Mantenimiento
Use estas etiquetas para mostrar detalles de mantenimiento del vehículo próximos o atrasados.
| Etiqueta | Descripción |
|---|---|
%SERVICE_NAME% |
El nombre del servicio. |
%SERVICE_TERM% |
El estado del servicio: cuánto tiempo, kilómetros o horas de motor quedan, o cuánto tiempo, kilómetros o horas de motor tiene de retraso el servicio. |
SMS
Esta etiqueta inserta el contenido exacto de un mensaje SMS entrante.
| Etiqueta | Descripción |
|---|---|
%SMS_TEXT% |
El texto del mensaje SMS. |
Salida de geocerca
Use estas etiquetas para incluir información sobre la interacción de la unidad con áreas específicas.
| Etiqueta | Descripción |
|---|---|
%ZONE_OUTSIDE% |
El nombre de la geocerca sobre la cual se recibe la notificación. La etiqueta %ZONE_OUTSIDE% se reemplaza por los nombres de las geocercas en las que se encontraba la unidad en el momento del mensaje anterior, pero de las que ya ha salido. Si no existen tales geocercas o no se encuentra el mensaje anterior con datos de ubicación, el texto de notificación muestra solo el nombre de la etiqueta (%ZONE_OUTSIDE%). |
%ZONE_DESC% |
La descripción de las propiedades de geocerca. |
Visualización de datos vacíos
Si los datos son desconocidos, las etiquetas se muestran exactamente como están, es decir, no se reemplazan por ningún valor. Esto puede suceder en notificaciones con múltiples condiciones O cuando el texto de notificación incluye etiquetas de una condición que no activó la notificación.
Las excepciones son las siguientes etiquetas que se ocultan automáticamente y no se muestran en el texto de notificación cuando no hay datos:
| Grupo | Etiquetas ocultas cuando están vacías |
|---|---|
| Unidades y grupos de unidades | %UNIT%, %UNIT_GROUP%, %UNIT_ID% |
| Fecha y hora | %CURR_TIME%, %POS_TIME%, %MSG_TIME% |
| Ubicación y geocercas | %LOCATION%, %LAST_LOCATION%, %LAT%, %LON%, %LATD%, %LOND%, %GOOGLE_LINK%, %LOCATOR_LINK%, %ZONES_ALL%, %ZONE_MIN% |
| Pasajeros | %TAG_NAME%, %TAG_ID% |
| Otros | %SPEED%, %ENGINE_HOURS%, %MILEAGE%, %LOSE_RESTORE% |