Notification Action

Notification action is the way system will react when a notification triggers.

Notify by e-mail

You can indicate one or more e-mail addresses to send a notification to. When all fields for entering addresses are filled, additional slots appear automatically. The header of the message will contain the name of the notification, and the name of the unit in the parentheses. The body of the letter will contain the text of the notification, where the tags will be replaced with specific values.

In addition, if the device allows, an image sent by the unit in the message may be attached to the notification. To do this, check the Attach image from triggered message option.

:!: To receive a notification by e-mail, in the general properties of the billing plan, specify the e-mail address from which system messages will be sent.

Notify by SMS

Key in one or more telephone numbers in the international format, for example, +375293293294. When all slots to enter phones are filled, additional slots appear automatically.

:!: Note that if the checkbox Can send SMS is not activated in user properties, then the corresponding notification delivery method becomes unavailable.

Send notification to Telegram

This method allows sending alerts about triggered notifications to the Telegram messenger.

To configure sending of notifications to Telegram, perform the steps described below.

1. Create a bot.

  • Tap the Search icon.
  • Find the bot named BotFather.
  • Tap Start and follow the instructions.
  • The received token must be specified in the Bot key field.

2. Tap Start to subscribe to the created bot.

3. Find out the user ID.

  • Find the bot named userinfobot.
  • Tap Start.
  • If you have found the correct bot, you should receive a message with the user ID. In order to find out the ID of another user, forward any of their messages to the bot. Indicate the received ID in the Channel ID field.

Display online notification in a popup window

A notification can be displayed in a popup window. It can be silent or accompanied by a specific sound. If no URL is given for the sound, the standard tune will be used. Otherwise, enter sound URL to use a custom tune. Recommended file size is up to 0.5 MB.

There is a possibility to inform on a notification triggering by blinking a minimap. To enable this option, indicate the 'Blink minimap' flag in this section.

:!: Attention!
Different browsers can have restrictions regarding formats of audio files:

Internet Explorer 9+ + +
Google Chrome 11+ + + +
Mozilla Firefox 12+ + +
Safari 5+ + + +
Opera 10+ + +

To highlight a notification, you can set an individual color to it. This color will be applied to the background of the triggered notification so that you could easily notice it.

Send mobile notification

In this case upon notification triggering a mobile notification is sent to a user/users of an application. Choose the necessary application in the upper field. Then the system checks the possession of the necessary rights towards users: 'View detailed item properties', 'Act as given user'. Current user, as well as the creator of a resource to which a notification belongs, are checked for the possession of these rights. Afterwards on the basis of this check a list of users is formed in the field below. Here you can indicate a user/multiple users (choosing the corresponding flags) or all the users (holding <ctrl> and checking any user's flag) to whom a notification will be sent. To facilitate the search, you can use the dynamic filter.

Note that mobile notifications service availability depends on the chosen service package.

:!: Note that in order to receive mobile notifications, a user of Wialon Mobile Client should authorize in the application and enable the 'Notifications' option.

Send a request

You can transfer a notice on the triggered notification to external systems. Choosing this measure it is necessary to indicate server address as well as HTTP request method ('POST' or 'GET').

Register event for unit

In this case notification text is stored in unit history. Then a report on these events can be generated.

Register as violation

Upon checking this option the notification will be registered not only as event but also as violation, and one more report type will be available to you. For further information, see reports on Events and Violations.

Execute a command

When you select this action, a command is sent to the unit (units) when a notification is triggered. Select a command from the list of the available ones. The list contains all commands configured in the properties of selected units if a user has the Execute commands access rights towards the units. Next to the header of the command can be special indicators that stand for the following:

  • all selected units support this command;
  • not all of the selected units support this command (see details in the tooltip).

If necessary, set the parameters.

If you send commands that require the input of text or a message (e.g. Send custom message or Send message to driver), you can use tags (the same as for the notification text). When the command is executed, the entered tags are converted to the values that correspond to them.

:!: Tags are converted to values only if a command is selected as a notification action (not if a command is sent manually from the monitoring panel).

Read more about the commands here.

Change access to units

Select users whose access rights should be modified when trigger conditions occur. Specify the access rights that should be applied to these users after the notification triggers. The Manage access to this item access right is required. You can use this feature, for instance, in the following situation: suppose you have created a user who monitors the transportation of their cargo, that is, they have access rights to certain units. After the cargo is delivered to the agreed place (that is, after entering a geofence), these units automatically become unavailable to the user.

Set counter value

Counter values can be changed (or zeroed) when notification triggers. Select one or more counters (mileage counter, engine hours counter, traffic counter) and set new values for them.

Store counter value as parameter

Current values of mileage or engine hours counters can be stored as parameters in unit data messages (odometer or engine_hours correspondingly). These parameters can be used to create sensors on their basis (for example, engine hours sensor) and to get initial/final mileage in reports. For more precise calculations, it is recommended to store counters while the unit is parked, for example, once a day at night time.

Register unit status

A new status can be set for unit when a notification triggers. For instance, when unit enters a geofence, private state can automatically switch to business.

Modify unit groups

You can change the contents of unit groups when a notification triggers — add triggered unit to a group or remove it from a group. On the left, there is a list of all available unit groups. Move necessary groups to the right to 'Add to group' or 'Remove from group' sections.

Send a report by e-mail

When a notification is triggered, a report is sent to the specified e-mail address (or several addresses). Indicate the resource which the required report template belongs to (select All available to view the templates of all available resources), report template, object (only the objects that belong to the same resource as the template are displayed), file format(s), time interval and report parameters. Note that when choosing an object, sometimes it is convenient to use the Triggered unit option — in this case, a report is generated for the same unit that the notification triggers for.

Afterwards, for the Content item specify whether you would like to receive files/archives or the link on FTP server (Wialon or custom one) where the corresponding files/archives are stored. Indicate report interval: choose particular dates or specify any time interval for previous X minutes/days/weeks/months/years. Enter e-mail address(es) to which report to be sent upon notification triggering. To generate a report, the View messages and reports access right is required. To find out more on file formats or parameters description, see the Export Report to Files section.

The information about the geodata in such report is shown in accordance with the settings of the user-creator of the resource in which this notification was created.

:!: If the access right to the object (or the object itself) was removed, the created notification is not executed.

Change icon

If this action is chosen, the current unit's icon is replaced by the specified one when the notification triggers. The window with the available icons is opened by clicking the Library button.

Create a round

After the notification triggers, a new round can be created for a unit. For example, when one round is finished, a new round can be assigned, or when a unit leaves the geofence (for example, a garage), a new round is automatically created for it. More about the parameters that can be configured for rounds are described in the Routes section.

Reset driver

This feature can be used, for example, to reset driver automatically when the unit returns to the depot. This action can be completed successfully only if you have enough rights for the resource where the driver under question belongs — 'Create, edit, delete drivers'. Note that driver resetting can take place only within the resource to which a notification belongs.

Reset trailer

Similar to the previous one but concerns trailers. This action can be completed successfully only if you have enough rights for the resource where the trailer under question belongs — Create, edit, delete trailers. Moreover, the same as for driver resetting, trailers should belong to the same resource in order the action to be executed correctly.

Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon   |   Copyright © 2002-2019 Gurtam