Configuring e-mail notifications for messages

Users can be notified about new messages received via the Messages application by means of notification e-mails. The e-mails are based on the Messaging - Notification email e-mail template.

For this to work, the target e-mail address must be filled into a special field in the user settings. This can be done in one of the following locations:

  • On the live site, via the My profile web part -> Personal settings -> Messaging notification e-mail field.
  • Users with access to the system’s user interface can enter the e-mail in the My desk -> My profile -> Messaging notification e-mail field.
  • Users with the Global administrator privilege level can enter the notification e-mail for each user in Users -> Edit () user -> Settings -> Messaging notification e-mail field.

When the e-mail address is entered into the field, a notification e-mail is sent to the address whenever the user receives a new message. This does not apply to messages received from users in the recipient’s Ignore list.

Your instance of Kentico must be configured to use an SMTP server in order for e-mails to be sent, as described in Configuring SMTP servers.

Macros in messaging e-mail template

In the text of the Messaging - Notification email template, you can access the following specific objects and their properties (e.g. {% Sender.UserName %}) using context macros to include dynamic values:

  • {% Sender %} - UserInfo object of the message sender.
  • {% Recipient %} - UserInfo object of the message recipient.
  • {% Message %} - MessageInfo object of the message.

Besides these special ones, you can also use all other standard macro expressions in the templates. See Macro expressions for more information about macro expressions in Kentico.

In Settings -> Community -> Messaging, you can find the following settings related to the notification e-mails:

  • Messaging sender e-mail - e-mail address that will be used as the sender address (From field) of the notification e-mails.
  • Messaging e-mail subject - entered text will be used as content of the Subject field of notification e-mails.

Configuring messaging-related settings