Messages

In the Appearance / Messages page, you can configure all the messages the DPS application send to the users when a certain event occurs.

This page is divided into several sections, each covering a specific set of messages.

  • Account and Security: the set of messages that are sent when registering or updating an account.

  • Account Suspension: the set of messages that are sent when an account is about to expire, has expired, or is being reactivated.

  • Alerts: the default messages that are sent when an alarm is activated or cleared.

  • Partners: the messages involved in managing client assignments to partners.

  • Payments: the messages involved in payment processing.

  • Work Sessions: the default messages that are sent when a work session is started or stopped.

Editing messages

Within the list of messages, you can click on each message to expand it and edit the associated texts.

Subject and body are available for messages sent only via email. Messages that can be sent through different channels (e.g. email, SMS, push) can have multiple texts to define, for example, short and long messages.

Placeholders

Within the email subject and payload, you can use the placeholders to generate dynamic content.

<div>
 <h1>NEW ACCOUNT CREATED</h1>
 Hi ${fullName},

 <p>Welcome to <em>${applicationName}</em>, a new account has been prepared for you.</p>

 <p>Click on the link below in order to complete the registration:<br />
 <a href="${accountActivationUrl}">${accountActivationUrl}</a></p>

 <p>Thanks,<br />
 ${companyName}</p>
</div>

Here is the list of common available placeholders:

Placeholder

Description

applicationName

The name of the application.
You can manage this label within the Labels page.

companyName

The name of the company that owns the application.
You can manage this label within the Labels page.

fullName

The concatenation of the user's first and last name.

user.firstName

The user's first name.

user.lastName

The user's last name.

unsubscribeUrl

The URL that users can click to turn off alert and work-session notifications.

According to the message type, you can use the following placeholders to include specific operation URL.

Account creation

Placeholder

Description

accountActivationUrl

The URL the user must click to activate the account.

Self account creation

Placeholder

Description

createPreliminaryUserUrl

The URL the user must click to activate the account in case of self-registration.

Self account registration already existing

Placeholder

Description

createPreliminaryUserExistUrl

The URL the user must click to activate the account in case of self-registration and already registered user.

Invite guest user

Placeholder

Description

inviteCustomerGuestUserUrl

The URL the user must click to accept the invitation.

Information updated

Placeholder

Description

updater

The user who performs the update of sensible information.

updatedObject

The update object (e.g. customer, location, thing).

updatedProperties

The list of updated properties.

updateTimestampFormattedTZ

The formatted timestamp of the occurred update.

Account inactivity

Placeholder

Description

suspensionDate

The date the user account will be suspended for inactivity.

Partner authorization update

Placeholder

Description

customerName

The name of the customer that is authorized on a partner.

partnerName

The name of the partner that is authorized on a client.

customerDetailsUrl

The authorized customer details page URL.

locationDetailsUrl

The authorized location details page URL.