Notification Action

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

Notify by email

You can indicate one or more email 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 email, in the general properties of the billing plan, specify the email 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 action allows sending notifications to the Telegram messenger.

Configuring notification sending for one user

1. Create a bot.

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

2. Tap Start to subscribe to the created bot.

3. Indicate 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.

Configuring notification sending for a public channel

1. Follow steps 1 and 2 from the instruction above.

2. Create a public channel in Telegram.

3. Add the created bot to the channel as an administrator with a right to post messages.

4. In the Channel ID field in Wialon, indicate the link to the channel in the @link format (without t.me/). The link is specified in the Info section of the channel.

5. In the channel settings, add subscribers, that is, the users who should receive notifications, or send them the invite link.

In the same way, you can configure notification sending for a public group. In this case, add the created bot as a member.

Configuring notification sending for a private channel

1. Follow steps 1 and 2 from the Configuring notification sending for one user instruction.

2. Create a public channel in Telegram.

3. Add the created bot to the channel as an administrator with a right to post messages.

4. In the address bar of the browser, insert

https://api.telegram.org/bot<YourBotToken>/sendMessage?chat_id=<@YourChannelName>&text=ping

5. Replace <YourBotToken> with the bot token and <@YourChannelName> with the link to the created channel in the @link format (without t.me/). The link is specified in the Info section of the channel.

6. Press Enter.

7. From the resulting code, copy a numerical value after “chat”:{“id”: and paste it into the Channel ID field in the notification properties in Wialon.

8. Delete an automatic message in the channel.

9. In the channel settings, change its type from public to private.

10. In the channel settings, add subscribers, that is, the users who should receive notifications, or send them the invite link.

Configuring notification sending for a private group

1. Follow steps 1 and 2 the Configuring notification sending for one user instruction.

2. Create a private group in Telegram.

3. Add the created bot to the group as a member.

4. In the address bar of the browser, insert

https://api.telegram.org/bot<YourBotToken>/getUpdates

5. Replace <YourBotToken> with the bot token.

6. Press Enter.

7. In the resulting code, find the ID of the created group (a negative value between “chat”:{“id”: and “title”:“Group name”). To find this place quickly, use the key combination Ctrl+F, type the name of the group in the search box, and press Enter.

8. Insert the ID of the group in the channel ID field of the notification properties in Wialon.

9. In the group settings, add members, that is, the users who should receive notifications, or send them the invite link.

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. The 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, check the Blink minimap box in this section.

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

MP3 WAV Ogg AAC
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

For this action, choose a command to be executed over unit(s). The list consists of all commands configured in the properties of selected units. So, different commands on the list may be supported by different units. Support status is seen with special indicators:

  • command is supported by all selected units;
  • not all of selected units support given command (see details in the tooltip).

For some commands, you should set additional parameters like input/output number, online report interval, etc.
More about executing commands...

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 email

When a notification is triggered, a report is sent to the specified email 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 email 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.

Was this helpful?
Thank you!