Notification action is the action the system will perform when a notification triggers.

Notify by email

This action is used to set up email notifications. You can indicate one or more email addresses to send a notification to. When all fields for entering addresses are filled in, 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, enable 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

This action is used to set up SMS notifications. Type in one or more telephone numbers in the international format, for example, +375293293294. When all fields for entering phone numbers are filled in, additional slots appear automatically.

Send notification to Telegram

This action allows sending alerts about triggered 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 token 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 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 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 from the instruction above.
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 pop-up window

This action is used to set up online notifications that will be displayed in a pop-up window. Such a notification can be silent or accompanied by a specific sound. If no URL is given for the sound, the standard tune will be used. To use a custom tune, enter the URL of the sound. The recommended file size is up to 0.5 MB.

It is possible to receive notifications in the minimap once a notification triggers. To enable this option, check the Blink minimap box in this section.

Different browsers can have restrictions regarding formats of audio files:

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

Send mobile notification

This action is used to set up mobile notifications from the selected application. Choose the required application in the Applications field. Next, the system checks to what users the current user and the creator of the resource have the View detailed item properties and Act as given user access rights and creates the list of users. Specify the users who should receive mobile notifications (hold the Ctrl key and check any box to select all users). For the convenience of search, use the dynamic filter above the list.

The availability of mobile notifications service depends on the chosen service package.

To receive mobile notifications, the user of the application for Android and iOS should authorize in the application and enable the Notifications option in the settings.

Send a request

This action allows you to send alerts about the triggered notifications to third-party systems. When choosing this action, indicate the server address as well as the method of the HTTP request (POST or GET).

Register event for unit

This action allows you to register a notification as an event in the unit history. As a result, you can generate a report on these events. 

Register as violation

This action works together with the Register event for unit action and allows to register a notification not only as an event but also as a violation. As a result, the Violations report becomes available.

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 them. Next to the header of the command can be special icons that signify 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 (for example, 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.

You can read more about commands here.

Change access to units

This action allows you to change access rights to units once the notification is triggered. 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. 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 the unit entered a geofence), these units automatically become unavailable to the user.

Set counter value

This action is used to change (or reset) counter values 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 a parameter

This action is used to store the current values of mileage or engine hours counters 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/ or 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

This action is used to set a new status for a unit when a notification triggers. For instance, when a unit enters a geofence, the private state can automatically switch to business.

Modify unit groups

This action is used to change the contents of unit groups when a notification triggers (units can be added or removed from the group). On the left, there is a list of all available unit groups. Move the required groups to the Add to group or Remove from group sections. As a result, after the notification triggers, the unit will be added or removed from the group.

Send a report by email

This action is used to send a report to the specified email address(es) once the notification is triggered. Indicate the resource to which the required report template belongs (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 to the FTP server where the corresponding files/archives are stored. Indicate the report interval: choose particular dates or specify any time interval for the previous X minutes/days/weeks/months/years. Enter an email address(es) to which the report should be sent upon notification triggering. To generate a report, the View messages and reports access right is required. To find out more about file formats or parameters description, see the Export Report to Files section.

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

Change icon

This action is used to replace the icon of the current unit by the specified one when the notification triggers. Click on the Library button to open the window with the available icons.

Create a ride

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

Reset driver

This action is used to reset the driver automatically when the notification triggers. This action can be useful when, for example, you want to unbind the driver from the unit once the unit returns to the depot.

Reset trailer

This action is used to reset trailers when the notification triggers.