Fleetrun
Hecterra
NimBus
Other apps
Wialon for Android/iOS
Logistics
Wialon Local
Wialon Hosting
Distance Tag
WiaTag
Configurator
LeaseControl
en
Contents
Notification Actions
  • notifications
  • notifications_to_telegram
  • email_notifications
  • sms

In the notification properties, you should select and configure one or several actions that should be performed automatically when the notification is triggered.

All the available actions are described in detail below.

Notify by email

This action allows you to configure sending email notifications. To do this, check the box to the left of the field and specify the address to which notifications should be sent. A new field is added automatically after each input. To cancel sending notifications to any of the specified addresses, uncheck the box to the left of the required address.

To receive notifications by email, on the Email settings tab of the billing plan properties, specify an email address from which system messages should be sent.

Some types of devices allow you to attach to the email an image sent by the unit in the message after which the notification was triggered. To do this, enable the Attach image from triggered message option. 

The notification name is specified in the header of the received email and the unit name, in brackets. The main part of the email contains the notification textBelow, there is a link which allows unsubscribing from notifications. If a recipient unsubscribes, the box to the left of their email is automatically unchecked in the notification settings. If all the specified recipients unsubscribe, and only this action is specified in the notification settings, the notification is automatically disabled.

Notify by SMS

This action allows you to configure sending notifications as SMS messages. The action is available only if the Can send SMS option is enabled in the user properties. Phone numbers should be specified in the international format (for example, +375293293294). A new field is added automatically after each input.

Send notification to Telegram

This action allows you to send notifications to the Telegram messenger.

Notifications can be sent to:

Notifications to the user’s private messages

To configure sending notifications to the user’s private messages, follow these steps:

There are no pictures in the gallery


  1. Using the search, find and open the bot named BotFather.
  2. Tap Start.
  3. Select the /newbot command.
  4. Specify the bot name.
  5. Specify the user name for the bot. It should end with the word bot.
  6. Save the received token.
  7. Specify the token in the Bot token field.
  8. Select the /mybots command.
  9. Select the created bot.
  10. Tap Start.
  11. Using the search, find and open the bot named userinfobot.
  12. Tap Start. After that, the user ID is sent. To find out the ID of another user, send any message to this bot on behalf of the required user. 
  13. Specify the received ID in the Channel ID field.

Notifications to a public channel

To configure sending notifications to a public channel, follow these steps:

  1. Follow steps 1–10 from the previous guide.
  2. Create a public channel in Telegram.
  3. Add the created bot to the channel as an administrator with the right to post messages.
  4. In the Channel ID field in Wialon, specify the link to the channel in the @link format (without t.me/). The link is indicated 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 link to the channel.

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

Notifications to a private channel

To configure sending notifications to a private channel, follow these steps:

  1. Follow steps 1–10 from the previous guide.
  2. Create a public channel in Telegram.
  3. Add the created bot to the channel as an administrator with the right to post messages.
  4. Copy the following link to the browser address bar:

    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 the 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 link to the channel.

Notifications to a private group  

To configure sending notifications to a private group, follow these steps:

  1. Follow steps 1–10 from the previous guide.
  2. Create a private group in Telegram.
  3. Add the created bot to the group as a member.
  4. Copy the following link to the browser address bar:

    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 group name 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 link to the group.

For futher information, see Telegram notifications.

Display online notification in a pop-up window

This notification action allows you to display notifications in a pop-up window in Wialon (see more). If the Play sound for events option is enabled in the user settings, the notifications are accompanied by an audio signal. In the Sound URL field, you can specify the address of the audio file. The recommended file size is up to 0.5 MB. If the field is not filled in, the default audio signal is used.

When using different browsers, take the following restrictions into account:

BrowserSupported format
Internet Explorer 9+MP3, AAC
Google Chrome 11+MP3, WAV, Ogg
Mozilla Firefox 12+WAV, Ogg
Safari 5+MP3, WAV, AAC
Opera 10+WAV, Ogg

If necessary, you can select the notification indicator and background colour. The default colour is white.

If the Blink minimap option is enabled, once the notification is triggered, a mini-window opens in which you can track the movement of the unit.

Send mobile notification

This action allows you to configure sending mobile notifications. The action is available if the Mobile notifications service is enabled in the properties of the user’s account. 

To work with this action, you should have the following access rights:

Access right typeAccess rightsDescription

Unit access rights
View object and its basic propertiesThe recipient users should have this access right to all the selected units.
Use unit in jobs, notifications, routes, retranslatorsThe user who configures the notification and the user-creator of the resource to which the notification belongs should have this access right to all the selected units.
User access rights

View detailed object properties

The user who configures the notification should have these access rights to the recipient users and to the user-creator of the resource in which the notification is stored.

The user-creator of the resource in which the notification is stored should have these access rights to the recipient users.

Act on behalf of this user

To configure sending mobile notifications, follow these steps:

  1. Make sure that the users who should receive notifications are authorized in the mobile application and have the option allowing them to receive notifications enabled. In the case of  Wialon for Android and iOS, the Push notifications option should be enabled in the settings.

  2. Select the mobile application to which the notification should be sent.


  3. Select the users who should receive the notification. To find them, use the dynamic filter above the list. To select all the users at once, select one of them while holding down the Ctrl key.

Send a request

This action allows you to send messages about triggered notifications to third-party servers. To do this, specify the server address and select the method of the HTTP request: POST or GET.

Register event for unit

This action allows you to register events in the unit history. To do this, the creator of the resource where the notification will be stored must have the Manage events access right to the unit.

After registering events, you can execute a report on events. In order for events to be registered as violations and to be available in the same-name report, enable the Register as violation option.

Send a command

This action allows you to send a certain command to the unit(s). The list contains all the available commands created in the properties of all the selected units if you have the Send commands access right to them.

Next to the name of each command, you can see the following icons:

  • : means that all the selected units support this command;
  • : means that not all the selected units support this command (more information in the tooltip).

In case of sending commands that involve entering text or a message (for example, Send custom message or Send message to driver), you can use the same tags as for the notification text. When executing the command, the specified tags are converted to the values that correspond to them.

Tags are converted to values only when selecting the Send a command notification action. When sending a command manually from the Monitoring tab, the tags are not converted.

Here you can find frequently asked questions about sending commands and answers to them. For more information about commands, see this section.

Save a video as a file

  Prerequisites

To access this notification action, the Video monitoring service should be activated in the properties of the user account or billing plan. In addition, the following access rights to the unit are required:

  • View object and its basic properties,
  • View detailed object properties,
  • View connectivity settings,
  • Send commands,
  • View commands,
  • Create, edit, and delete commands.
This action allows you to automatically save a video excerpt captured by the unit cameras at the moment when the notification is triggered. You can use such a notification for several units.

To configure this notification action, follow the steps below.

  1. On the Video tab of the unit properties, enable the Automatic saving option for the cameras from which you want to save video excerpts. If you want to configure the notification for more than one unit, perform this action for all of them.
  2. In the notification, select the cameras from which you want to save video excerpts. You can specify one or several cameras, or select all of them. To select several cameras, use the Add camera button. If you create the notification for several units, you can see the number of units that have a camera with this name and the total number of units from the notification next to the camera field.

  3. Specify the duration before and after the event (the moment when the notification is triggered) in seconds. The minimum allowed value is 1, and the maximum one is 30. The duration of the saved file is equal to the sum of the entered values.

When the notification is triggered, it saves video excerpts from the selected cameras. If you have specified the cameras for which the Automatic saving option is not enabled in the unit properties, the video from such cameras is not saved.

You can see the saved file on the Video tab, in messages, and in reports. If automatic saving is enabled for several unit cameras, the video excerpts captured by these cameras are grouped into one file and played simultaneously.

Change access to units

This action allows you to automatically change the user’s access rights to units. To do this, you should have the Manage access to this object access right to the user.

To configure this action, follow these steps:

  1. Select the users whose access rights you want to change.

  2. Next to the required access right, select one of the following actions:
    • Add. Allows you to grant the users this access right.
    • Remove. Allows you to remove from the users this access right.
    • Skip. Allows you not to change this access right.

This action can be useful when granting users temporary access rights. For example, the user should track the movement of a unit delivering cargo on a certain territory (geofence A). After the cargo is delivered to the required place (geofence B), the unit should be unavailable for this user. In this case, you should use the notification of the Geofence type.

Set counter value

This action allows you to change the values of the mileage, engine hours, and/or GPRS traffic counters. To do this, you should have the Edit counters access right to the unit.

To configure this action, select the required counters and specify the values that these counters should have when the notification is triggered.

Save counter value as a parameter

This action allows you to save the value of current mileage (odometer parameter) or engine hours (engine_hours parameter) as a parameter in the message. This is required in order to show the initial and final mileage values in the report on trips and convert the engine_hours parameter into the engine hours sensor for further operations. To do this, you should have the Edit counters access right to the unit.

For more precise calculations, it is advisable to store counter values while the unit is parked, for example, once a day at night time.

Register unit status

This action allows you to register the unit status: Business or Personal. To do this, you should have the Manage events access right to the unit. For example, when the unit visits a certain geofence, the unit status can be changed from personal to business or vice versa.

Add or remove units from groups

This action allows you to add or remove the selected unit from certain groups. To add the unit to the group when the notification is triggered, click on the required group in the All groups list and, using the icon , move the group to the Add to group list; to remove from the group, to the Remove from group list. To move the selected groups to the common list, use the icon .

Read more about the possibilities of working with this and other notification actions in the expert article.

Send a report by email

This action allows you to send a report to one or several specified email addresses. To do this, you should have the Request messages and reports access right. 

To configure this action, follow these steps:

  1. Select the resource to which belongs the report template you want to send. To see templates from all the available resources, select the All available option.

  2. Select the report template.
  3. Select the object on which you want to execute the report.
  4. If necessary, enable the Triggered unit option. It is only available for reports on unit or unit group. If the option is enabled, the report is executed only on the unit that triggered the notification, regardless of the object selected in the previous list.
  5. Select one or several file formats: HTML, PDF, Excel, XML, CSV. When selecting the PDF format, you can specify the page orientation, size, and width. When selecting the CSV format, you can specify the coding and delimiter as well as enable or disable the displaying of headings. 
  6. If necessary, enable additional options (see more).

  7. Specify the time interval for which report should be executed.
  8. Select one of the two options defining the report content:
    • Send files/archives. Allows you to send files or archives directly.
    • Send links to files/archives. Allows you to send links to the FTP server (Wialon or a custom one) where the files or archives of the report are stored.

      If the file size exceeds 30 MB, the Send links to files/archives option is used automatically.


  9. Specify and select the email addresses of the recipients of the report. A new field is added automatically after each input. 

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

If the user-creator of the notification no longer has access rights to the object or this object has been deleted, the notification stops working. 

Change icon

This action allows you to select the icon that should be the unit icon when the notification is triggered. To open the list of available icons, click on the Library icon.

Create a ride

This action allows you to create a new ride for the unit. For example, when leaving a certain geofence or finishing a certain ride the unit can start a new ride automatically.

To configure this action, follow these steps:

  1. Specify the ride name.

  2. If necessary, add a description.
  3. Select the route.
  4. Select the schedule of the route.
  5. Select the order of check points: Strict, Skipping possible, Arbitrary.
  6. If necessary, enable the Remove finished rides from the timeline option, so that the timeline shows only those rides which are currently executing.
  7. In the Expiration time field, specify the time during which the ride can start.

Separate driver

For this notification action, you should have the Create, edit, delete trailers access right to the resource to which the driver belongs.

This action allows you to automatically separate the driver from the unit. If several drivers are assigned to a unit, all of them are separated after the notification is triggered. The drivers and the notification should belong to the same resource.

See more information about the automatic separation of drivers.

Separate trailer

For this notification action, you should have the Create, edit, delete trailers access right to the resource to which the trailer belongs.

This action allows you to automatically separate the trailer from the unit. If several trailers are assigned to a unit, all of them are separated after the notification is triggered. The trailers and the notification should belong to the same resource.

See more information about the automatic separation of trailers.

If you find a mistake in the text, please select it and press Ctrl+Enter.
Thank you for your feedback!
Report a mistake
Text with the mistake Comment
Maximum 500 characters