Notifications

Simple Email notifications system that sends messages when devices goes offline.

Setup

First of all, each user that wants to receive notifications must have email field filled and at least one notification event type selected in profile. This is done in Account screen opened from the top navigation bar.

Then user with either ‘administrator’ or ‘manager’ role in Settings » Notifications menu should set up one of the following:

• SMTP server settings

• Pushbullet Access Token

Use ‘Test’ button to check settings validity. It will just test the connection. No test email or push is sent.

Templates

In Settings » Notifications menu it is also possible to customize notification message with template. Message template is defined per event type.

There are placeholders, which are replaced during message generation with actual values. Placeholders may be used both in subject and body of message. Full list of available placeholders is shown at bottom of this dialog window. There is an option to apply custom formatting to the date and time fields using rules from SimpleDateFormat and following notation:

${dateField;date(FORMAT)}

For example:

${eventTime;date(yyyy.MM.dd HH:mm:ss)}

Each template can be tested with sample values using ‘Test’ button.

Usage

Every minute starts an ‘Offline’ check for devices. If any device goes offline then an ‘Event’ is posted, which is scheduled for notification. Then every minute starts notification sender, which finds all available ‘Offline’ events and sends them to the users that have access to these devices.

Also there are two geo-fence events: on enter and on exit.

All new events are always put into a single message with title [traccar-web] Notification.

Important notes

• Administrators receive notifications for all devices.
• Notification settings are taken first from current user and then from all managers hierarchy. If none of managers have notification settings then they are taken from some administrator. If no notification settings found then no email will be sent.
• Once any notification for event is sent it will NEVER be sent again. This also means that until ANY notification is sent event is in ‘pending’ outbox.
• User receives only events of types selected in his account profile.

Disable event recording

By default all devices events are always recorded. However, this can be disabled from in Global settings menu (Settings » Global).

Troubleshooting

If you are using GMail then by default security settings don’t allow access from third party applications (see #133). This security check can be disabled here - select ‘turn off’ here. You must be logged in to google account before accessing that page.