Customizing Event Center messages

The Event Center sends emails, SMSes, and push notification messages based on triggering events. When you configure events, you can use the default message template or create a new one. Event Center templates enable you to specify content and basic formatting using HTML markup.

Displaying Event Center templates

To display Event Center templates:

  1. In the Admin Portal, go to Settings > Templates.

  2. Select Event Center Templates.

    This list includes the default template for each Event Center type. Default templates are not editable.

  3. Click the View link for the message template you want to view.

Adding custom Event Center messages

To add a custom Event Center message:

  1. Either click the Create button in the event dialog or select the event type from Settings > Templates > Event Center Templates > Add New.

    The following figure shows the event dialog.

  2. The following figure shows the Event Center Templates menu.

    The dialog for the corresponding event type opens.

    Event Center messages are displayed with the HTML markup that provides the basic formatting for the content.

     
  3. In the Name field, enter a name for the template.

    The name must be unique for events of the same type.

  4. In the Edit Template for field, select the language this template will be used for.

    Note that only those languages that have been enabled for the system will be displayed in this list.

  5. Make changes to the displayed messages.
  6. Click Save.

Adding other types of templates

There are "Other" types of events that have templates that you can modify and use. The "Other" list includes the default template for: Action on Device, App Distribution, Selective Wipe, and Wipe. Default templates are not editable.

Procedure 

  1. Go to Settings > System Settings.

  2. Click Templates > Others.

    The Others template page displays.

  3. Find the language you want the template to display in and then click the Edit icon.

    The Edit Template dialog box opens. For this example, the Edit Template: Wipe (English) dialog box opens.

  4. Enter the information in the form.

    • Email Subject - Modify the default text or enter a short phrase that gives a summary of the message.

    • Email Body - Modify the provided text for your needs. See Using variables in Event Center messages.

  5. When finished, click Save.

Customizing registration messages

Using variables in Event Center messages

Supported and required variables for Event Center messages vary by the type of message. The following table summarizes these variables. You can also click the Variables Supported link to display this information. Note that, unlike variables used for registration variables, Event Center variables do not end with $.

Table 1. Variables in Event Center messages

Template Type

Required Variables

International Roaming

$CURRENT_COUNTRY

$HOME_COUNTRY

$PHONE_NUMBER

$SEVERITY

$USER_NAME

Threshold Reached

$PHONE_NUMBER

$SEVERITY

$THRESHOLD_ON

$THRESHOLD_TYPE

$THRESHOLD_UNIT

$THRESHOLD_VALUE

$USED_VALUE

$USER_NAME

SIM Changed

$CURRENT_PHONE_NUMBER

$NEW_PHONE_NUMBER

$SEVERITY

$USER_NAME

Memory Size Exceeded

$FREE_MEMORY_SIZE

$MEMORY_SIZE_LIMIT

$PHONE_NUMBER

$SEVERITY

$TOTAL_MEMORY_SIZE

$USER_NAME

System Event

$DEFAULT_SYSTEM_MESSAGE

$SERVER_IP

$SERVER_NAME

$SEVERITY

Policy Violation

$DEFAULT_POLICY_VIOLATION_MESSAGE

$PHONE_NUMBER

$SEVERITY

$USER_NAME

Variable descriptions

The following table describes the variables used in Event Center messages.

 

Table 2. Variable descriptions

Variable

Description

$CURRENT_COUNTRY

The country in which the device is currently located.

$CURRENT_PHONE_NUMBER

The phone number currently associated with the device in Core, but not matching the phone number currently used by the device.

$DEFAULT_POLICY_VIOLATION_MESSAGE

The hard-coded message associated with the policy violation that triggered the alert.

Due to the length limits of SMS, the text might be truncated.

$DEFAULT_SYSTEM_MESSAGE

The third-party system message or error that triggered the alert.

$FREE_MEMORY_SIZE

The amount of free memory currently available on the device.

$HOME_COUNTRY

The home country of the device.

$MEMORY_SIZE_LIMIT

The threshold set for the device memory.

$NEW_PHONE_NUMBER

The phone number replacing the $CURRENT_PHONE_NUMBER$ as a result of a SIM change.

$PHONE_NUMBER

The phone number used by the device.

$SERVER_IP

The IP address of the server triggering a system event alert.

$SERVER_NAME

The hostname of the server triggering the system event alert.

$SEVERITY

The defined severity of the system event, i.e., Information, Warning, or Critical.

$THRESHOLD_ON

The total used for calculations, i.e., International Roaming or Total Usage.

$THRESHOLD_TYPE

The type of usage measured, i.e., SMS, Data, or Voice.

$THRESHOLD_UNIT

The unit associated with the type of usage, i.e., minutes, messages, or MB.

$THRESHOLD_VALUE

The defined threshold value for this event, e.g., 1000 (voice minutes).

$TOTAL_MEMORY_SIZE

The total memory reported by the device.

$USED_VALUE

The amount of memory currently used on the device.

$USER_NAME

The display name of the user associated with the device.

Specifying which template to use

When you create or edit an event, you specify which template to use for resulting alerts. To select a template:

  1. Create or edit an event.
  2. Select a template from the drop-down or click the Create button to create a new template.

Filtering Event Center messages

In the Event Center Templates page, you can filter messages by event type. Just select the preferred event type from the Event Type drop-down.

Editing Event Center messages

You can edit your custom Event Center templates. However, default Event Center templates are not editable.

To edit a custom Event Center template:

  1. In Admin Portal, go to Settings > Templates > Event Center Templates.

  2. Click the edit icon for the custom template you want to edit.
  3. Make your changes.
  4. Click Save.

Deleting Event Center messages

You can delete any of the Event Center messages you have created:

  1. In Admin Portal, go to Settings > Templates > Event Center Templates.
  2. Select the items you want to delete.
  3. Click Delete.