The text is used for the following notification actions: notify by SMS or email, register event for unit, display online notification in pop-up window.
The text of a notification can be written in any language, contain any characters, words, and phrases, and be of any size. In addition, you can use tags, that is, parameters encrypted with special characters. In a message, such characters will be replaced with real values. If you want to receive a notification by SMS, do not write long messages.
Example:
The text «'%UNIT%' violated speed limitations. At '%POS_TIME%' it moved %SPEED% near '%LOCATION%'» can be transformed to «'Rover-119' violated speed limitations. At '2000-01-01 12:01:37' it moved 136 km/h near 'KU 8, Thurnau, DE'».
The units of measurement (kilometers or miles) used to decrypt the tags depend on the resource settings to which the notification belongs. The date and time format is taken from the settings of the creator of this resource.
In the text of the notification with the Send a request action type, enter the parameters of the request. When composing the text of the notification yourself, use URL encoding. Note that when using this type of notification action together with others (such as Notify by email, Notify by SMS, and so on), the same text is created for all notifications.
Below is the list of tags applicable to most types of notifications.
Tag | Description |
---|---|
%UNIT% | Unit name. |
%UNIT_ID% | Internal unit ID in the system. |
%CURR_TIME% | Current date and time. |
%LOCATION% | Unit location when notification was triggered. |
%LAST_LOCATION% | Last known unit location. This information may be useful if there is no location information in the triggered message. |
%LOCATOR_LINK(60,T)% | Create a locator link for the triggered unit (in parentheses indicate its lifespan in minutes, the T and G parameters to show tracks and geofences). |
%ZONE_MIN% | The smallest of the geofences where the unit was located when the notification was triggered. The tag is replaced by the name of the geofence only if the geofence and the notification have been created in the same resource. |
%ZONES_ALL% | All the geofences in which the unit was located when the notification was triggered. |
%SPEED% | Speed registered when notification was triggered (is not applicable to fuel fillings or thefts). |
%POS_TIME% | Date and time of the triggered message, or the last message with the position (in case the triggered message has no information about the position). |
%MSG_TIME% | Date and time of the message that triggered. |
%DRIVER% | The name of the driver assigned to the unit when the notification was triggered. It is displayed only if the driver belongs to the same resource as the notification. |
%DRIVER_PHONE% | The phone number of the driver. |
%TRAILER% | The name of the trailer assigned to the unit when the notification was triggered. It is displayed only if the trailer belongs to the same resource as the notification. |
%SENSOR(*)% | Unit sensors and their values (indicate a sensor mask in parentheses). The tag does not work in notifications about fuel fillings and fuel thefts. |
%ENGINE_HOURS% | Engine hours when the notification was triggered. |
%MILEAGE% | Mileage when the notification was triggered. |
%LAT% | Latitude when the notification was triggered (for example, N 55° 45.7530'). |
%LON% | Longitude when the notification was triggered (for example, E 37° 35.2068'). |
%LATD% | Latitude without formatting. |
%LOND% | Longitude without formatting. |
%GOOGLE_LINK% | Link to Google Maps with the position when the notification was triggered (for example, https://www.google.com/maps?q=55.762550N,37.586780E) |
%CUSTOM_FIELD(*)% | Custom fields from the unit properties. If you leave the asterisk in parentheses, all available custom fields (including administrative ones) are shown with their values and names. To get the value of a certain field, specify its exact name in parentheses. In this case, the resulting notification text contains only the value of the specified field (without the field name). |
The time tags use the time zone of the user who created the notification. If another user opens the notification properties and clicks OK, the time zone of the latter user is applied.
There are also tags that are applied only to specific types of notifications.
Tag | Description |
---|---|
%ZONE% | The name of the geofence for which the notification was triggered (for the notifications of the Geofence type). In the text of the Outside geofence notification, the %ZONE% tag is replaced with the names of the geofences (separated by a comma) which the unit entered at the time of the previous message and already left. If there is no previous positional message or there are no geofences that satisfy the condition described above, the text of the notification shows only the name of their tag (that is, %ZONE%). |
%ZONE_DESC% | The description of the geofence (for the Geofence notification) taken from its properties. |
%SENSOR_NAME% | Name of the triggered sensor (used in notifications of various types). |
%SENSOR_VALUE% | Value of triggered sensor. |
%SERVICE_NAME% | Name of service interval (used in maintenance notifications). |
%SERVICE_TERM% | State of service interval — left/expired value (used in maintenance notifications). |
%TRIGGERED_SENSORS% | All triggered sensors and their values (used in maintenance notifications). |
%LOSE_RESTORE% | Connection loss/Connection restored (used in connection loss notifications). |
%PARAM_NAME% | Parameter name (used in parameter control notifications). |
%PARAM_VALUE% | Parameter value (used in parameter control notifications). |
%SMS_TEXT% | Text from SMS message (used in SMS control notifications). |
%VOLUME% | The volume of the fuel filling or theft (for the fuel filling or fuel theft notifications). |
%INITIAL_LEVEL% | The fuel level when the filling or theft began. |
%FINAL_LEVEL% | The fuel level when the filling or theft finished. |
%TIME_FROM% | The time when the fuel filling or theft began. |
%TIME_TO% | The time when the fuel filling or theft finished. |
%DURATION% | The duration of the fuel filling or theft (in minutes). |
%DRIVER_ID% | The driver's code (used in notifications about drivers). |
%DRIVER_NAME% | The driver's name (used in notifications about drivers). |
%TRAILER_ID% | The code of the trailer (used in notifications about trailers). |
%TRAILER_NAME% | The name of the trailer (used in notifications about trailers). |
%TAG_ID% | The code of the passenger (used in notifications about passengers). |
%TAG_NAME% | The name of the passenger (used in notifications about passengers). |
%OTHER_UNIT% | Name of another unit (used in notifications about interposition of units). |
%ROUTE_NAME% | Route name (used route control notifications). |
%ROUTE_STATUS% | Ride execution status (used in route control notifications). |
%ROUTE_POINT% | Name of the check point (used in route control notifications). |
%ROUTE_SCHEDULE% | Schedule name (used in route control notifications). |
%RIDE_NAME% | Ride name (used in route control notifications). |
%COUNTRY% | Country. |
%REGION% | Region (state, etc.). |
%CITY% | City (town, etc.). |
%STREET% | Street. |
%HOUSE% | House. |
If the data is unknown, the tags are displayed as they are (not substituted with any values). The exceptions are the following tags which do not appear in the notification text when there is no data: %UNIT%, %USER%, %CURR_TIME%, %LOCATION%, %LAST_LOCATION%, %SPEED%, %POS_TIME%, %MSG_TIME%, %UNIT_GROUP%, %ENGINE_HOURS%, %MILEAGE%, %LAT%, %LON%, %LATD%, %LOND%, %GOOGLE_LINK%, %INSURANCE_CASE%, %ZONES_ALL%, %ZONE_MIN%, %UNIT_ID%, %MSG_TIME_INT%, %NOTIFICATION%, %TAG_NAME%, %TAG_ID%, %LOSE_RESTORE%, %LOCATOR_LINK%.
A tag must be marked with a percent sign on both sides. Otherwise, it is considered as plain text and is not substituted with real values.