EMS Push Notifications
Go Up to Enterprise Mobility Services (EMS)
EMS Push Notification messages are the easiest way to reach a great number of registered devices in the EMS Server. Each EMS push client application that is installed in a device, registers a single EMS Installation in the EMS Server.
Send EMS Push Notification messages to the registered devices in your EMS Server to easily inform your users.
Contents
Sending EMS Push Notification Messages
The EMS Server provides functionality for sending push notifications with custom messages to the registered devices in the EMS Server.
Use the TBackendPush component to send or broadcast push notification messages.
Target Destination for EMS Push Messages
You can either broadcast your push message, send it to a channel with subscribed devices or only to a specific device.
Choose the destination devices of your EMS Push Notification messages.
- Broadcasting. You can send the push message to all the registered devices in your EMS Server.
- EMS Channels. You can send the push message to all the registered devices that are subscribed to an EMS Channel.
- Note: You can add a registered device to one or several EMS Channels in order to subscribe it.
- Advance targeting. You can select the target destination of your messages by selecting the deviceToken of the target device.
EMS Push Message Payload
Use the TPushData types to specify the EMS push message payload and send this message to your registered devices. You can also create a JSON message with the following payload:
- Message. Text body of the push notification message (if you do not customize the EMS push notification payload).
{
"message":"EMS Push notification message"
}
Customizing EMS Push Message Payload
EMS allows you to customize your EMS Push messages depending on the type of destination device.
- aps. Custom settings for a push notification message in an iOS device.
- aps.alert. Body text message of the notification for an iOS device.
- aps.badge. Number of the badge number displayed in the iOS application icon.
- gcm. Custom settings for a push notification message in an Android device.
- gcm.title. Title of the notification for an Android device.
- gcm.message. Body text message of the notification for an Android device.
- Note: If you customize the body text message, this text will be shown as text message of the received notification.
{
"message":"EMS Push notification message",
"aps":{
"alert":"iOS Alert message",
"badge":"45"
},
"gcm":{
"message":"GCM message",
"title":"GCM title"
}
}
- Note: We recommend you to follow the payload structure for iOS devices as described in Apple Push Notification Service (APN) and for Android devices as described in Google Cloud Messaging (GCM).
EMS Server Requirements to Send EMS Push Notifications
To send EMS Push notification messages to the registered devices in your EMS Server, you need to install the OpenSLL libraries in the system where the EMS Server runs.
- Note: You need to install the 32-bit or 64-bit OpenSSL binary, depending on the target platform of the EMS Server.
If you do not install the OpenSSL libraries and use the EMS Server to send push notification messages to your registered device, the EMS Server shows the following error exception in the EMS Server Window log:
{"Error":{"Type":"Other","Exception":"EIdOSSLCouldNotLoadSSLLibrary","Message":"Could not load SSL library.","Thread":5576}}
Topics
The following topics help you to enable sending EMS Push notification messages to your registered devices.
- Setting Up the Messaging Service
- Configuring the EMS Server to Enable Push Notifications
- Creating an EMS push client application