Customizing registration messages

This feature is supported on iOS, macOS, Windows, and Android devices.

The registration process is a critical part of deployment. You can customize the registration messages involved in this process by editing the registration templates. Registration templates enable you to specify content and basic formatting using HTML markup.

MobileIron sends multiple messages related to registration:

  • registration SMS
  • registration email and reminder email
  • post registration email

These messages may vary by:

  • platform
  • language

In addition, messages may vary by device type:

  • phones
  • PDAs

To accommodate this range of messages:

  • Separate registration templates are provided for each language/platform combination.
  • Each registration template contains separate text for each registration message type.
  • Each registration template contains separate text for phones and PDAs.
  • For when Core discovers device users that have not downloaded the MDM profile, reminder email scheduling capabilities are provided

Viewing registration templates

To view MobileIron message templates:

  1. In Admin Portal, click Settings > Templates.
  2. Select Registration Templates.
  3. Click the View link for the template you want to view.

Editing registration messages

To edit registration messages:

  1. In Admin Portal, select Settings > Templates > Registration Templates.

  2. Select the template you want to edit and click the Edit pencil icon.

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

  3. Make changes to the displayed registration messages.

    NOTE: Do not add the <head> html tag in the registration template fields.

  4. Click the Variables Supported link in the right corner of the dialog box to display a guide to the supported variables. See Using variables in registration messages for additional details.
  5. Click Save.

Next steps 

Scheduling reminder notifications for completing registration

Using variables in registration messages

Each field in a registration template has a set of supported variables, most of which are required. Supported and required variables also differ by OS. Use the following variables to guide your customization. You can also click the Variables Supported link to display this information. All variables except $BRANDING_COMPANY_NAME$ are also required in the specified field.

Registration message variables

The following table gives the of variables used in types of registration messages.

Table 1. Variables used in different types of registration messages

Type

Supported Variables

Registration SMS, Phone

$REG_LINK$

Registration Email

 

Registration Email, Subject (Phone)

$ENT_NAME$, $USER, $PHONE$

Registration Email, Subject (PDA)

$ENT_NAME$, $USER, $PHONE$

Registration Email, Body(Phone)

$ENT_NAME$, $BRAND_COMPANY_NAME$, $PHONE$, $INAPP_REG_STEPS$, $REG_LINK$

Registration Email, Body(PDA)

$ENT_NAME$, $BRAND_COMPANY_NAME$, $REG_LINK$, $INAPP_REG_STEPS$

Registration Email, Reminder Subject (Phone)

$ENT_NAME$, $USER$, $PHONE$

Registration Email, Reminder Subject (PDA)

$ENT_NAME$, $USER$, $PHONE$

Registration Email, Reminder Body(Phone)

$ENT_NAME$, $BRAND_COMPANY_NAME$, $PHONE$, $INAPP_REG_STEPS$, $REG_LINK$

Registration Email, Reminder Body(PDA)

$ENT_NAME$, $BRAND_COMPANY_NAME$, $REG_LINK$, $INAPP_REG_STEPS$

Values for $INAPP_REG_STEPS$

 

Server

$SERVER_URL$

Username

$USER_ID$

PIN

$PASSCODE$, $PASSCODE_TTL$

Post-Registration Email

 

Post Registration Email, Subject (Phone)

$BRAND_COMPANY_NAME$, $USER$, $PHONE$

Post Registration Email, Subject (PDA)

$BRAND_COMPANY_NAME$, $USER$, $PHONE$

Post Registration Email, Body (Phones)

$PHONES$, $BRAND_COMPANY_NAME$

Variables used inside registration messages

The following table gives the description of variables used inside registration messages.

Table 2. Description of Variables used inside Registration Messages

Variable

Description

$BRAND_COMPANY_NAME$

An internal variable.

$ENT_NAME$

The name of the organization using MobileIron Core to secure the device. See the field EnterpriseName in Settings > System Settings > General > Enterprise.

$INAPP_REG_STEPS$

Combines $SERVER_URL$, the user’s LDAP password, $PASSCODE$, and $USER_ID$.

$PASSCODE$

The registration PIN generated for the device by Core.

$PASSCODE_TTL$

The number of hours that the registration PIN remains valid. See the field Passcode Expiry in Settings > System Settings > Users & Devices > Registration.

$PHONE$

The phone number associated with the device.

$REG_LINK$

The URL that users access to complete the registration process (i.e., https://server name:port/i for iOShttps://server name:port/v/passcode for Windows and other platforms).

 

$SERVER_URL$

The MobileIron Core server address used for registration.

$USER$

The name of the user associated with the device, as displayed in MobileIron Core.

$USER_ID$

The user ID for the user associated with the device, as defined in the user account on Core.

 

Scheduling reminder notifications for completing registration

This feature works on iOS devices only.

Core detects whether device users have completed registration or not. To ensure that device users complete their registration, set up notifications to remind device users to complete the registration process. It is recommended that a notification is sent to the device user every hour.

Notifications are only possible if the registration is done within the Mobile@Work registration. No reminders are needed for Apple Device Enrollment registrations because the MDM profile is always installed as part of the Apple Device Enrollments.

Procedure 

  1. In the Admin Portal, select Settings > System Settings.
  2. Select iOS > MDM. The MDM page displays.

  3. Select the Send email to user and notification to client if MDM profile is not installed check box.

    The field expands, displaying additional fields.

  4. Select how often to send a reminder email in the every hour field. If the device user registers within 8 minutes of the hour, the device user will not get a reminder until the next hour.
  5. Select the Maximum Number of Emails / Notifications to be sent. A maximum of 24 emails/notifications can be sent within a 24-hour period.
  6. Click Save.

Next steps 

Send the email invitation to device users. See Admin invites users to register

Filtering registration messages

In the Registration Templates page, you can filter registration messages by:

  • language
  • platform

Procedure 

  1. If you want to restrict the templates displayed based on language, select the preferred language from the Language list.
  2. If you want to restrict the templates displayed based on device platform, select the preferred platform from the Platform list.

Restoring registration messages to default content

To restore a registration message to the default content provided by MobileIron:

  1. In the Settings > Registration Templates page, select the template you want to restore.
  2. Click Restore to Factory Default.