In this area you'll learn how to edit a message template.
To access this area, expand the menu item Messages and click in Templates as follows:
In this page click in the template you wish to edit:
This will take you to a wizard divided in three different tabs. Some sections are optional and you will notice that they are marked as ready by default.
If you would like to automatically categorize users when they open your messages, you can use segmentation rules to do so. Click in the Segmentation tab:
There's four types of rules you can select, add or remove users from segments and add or remove devices from tags. You can add an unlimited number of rules and even combine two or more rules. This becomes powerful as you can add users to a group while removing them from another group, as they open the message. This can be used to categorize their behaviour when they open messages allowing you to effortlessly create groups of users that can be reused later on.
To add users to one or more segments, select the following:
If you want to remove users from one or more segments, select the following:
Then go ahead and proceed to select the segments you want:
In the Search Segments field, search for existing segments:
If the segment you are looking for does not exist you can create one on-the-fly, just click in the Create it? link:
When you are done selecting segments, just go ahead and add the rule by clicking in the Add Rule button:
The exact same thing can be done with tags, to add devices to one or more tags, select the following:
If you want to remove devices from one or more tags, select the following:
Then go ahead and proceed to select the tags you want:
In the Search Tags field, search for existing segments:
If the tag you are looking for does not exist you can create one on-the-fly, just click in the Create it? link:
When you are done selecting tags, just go ahead and add the rule by clicking in the Add Rule button:
As you add rules, you will see them in a list as follows:
To actually create the content your users will see when you send a notification, click in the Content tab:
If you are using our inbox functionality, you may localize your content in multiple languages. For that toggle the switch Use localizable content to start creating content in other languages:
Automatically a new tab called Default will appear, which will allow you to create the content that we will use as the fall back when the device that receives the message does not have a language provided by the localizable content you create.
Make sure you create the default message before proceeding to add localizable content, as localizable content must have the same type of rich tenmplates and actions use in the default message. When you are ready to add localizable content, go ahead and click in the button on the right:
This will open a new window where you can select with language/region combination you want to create content for. Note that region is a property only available in SDK 2.0 or higher, so it's important your apps use this version if you would like to have content for a language/region combination. If your apps do not support this version or you simply don't need to create content based on a language/region combination, you can leave the region option unselected.
Adding languages will eventually add new tabs to the message composer, as shown below. Make sure you then complete the localization of your content by translating the relevant content in each tab:
A message can include a lock screen image (except desktop notifications), for that simply upload one in Lock Screen Media:
If you do not want to generate a remote notification and only show this message in the inbox, go ahead and check the following box:
It is also optional to include a title (please note that this field allows placeholders):
Optionally you can also include a subtitle (please note that this field allows placeholders):
It is required you include a short message, this will show in the lock screen or notification center (please note that this field allows placeholders):
In all these fields you can use the emoji selector to select emoticons as shown below:
Then you should select a Rich Push Template, by default we will include several templates but you can also create your own. Select one of the options by expanding the menu below:
Finally you can also add actions to your messages, by using the option below:
To learn more about actions, please read the guide here.
As you compose your notification, you get an approximate preview of how it will look like by clicking in the button Preview:
Optionally, for each notification you can also configure a couple more options about your notification. To do that click in the Options tab:
If you wish to not deliver your notification if the user by any chance is not reachable (phone is off, no network, etc) within a certain amount of time, you can add TTL (Time to Live) to your message:
This can be useful if the content of your message is time sensitive and not relevant if not delivered after a certain amount of time.
It is also possible to configure a sound for your message. By default your message will not produce any sound, but you can provide the text default to let the device play the default sound when a message arrives. You can also play a custom sound, for that you need to include a sound file in your apps. For iOS we advise you to use the .caf format and for Android and Web the .mp3 file format. To play custom sounds you will need to specify the file name in this field:
For app developers there might be at some point the need to send custom data with a notification. For those case we allow you to include a JSON object in each message in the Extra editor:
Developers should then handle this data in the app as it will be accessible for them as soon as the notification is delivered to the user's device.
Finally you can also provide some platform specific options under this section:
For iOS you can provide the badge number, this badge number will be visible on the top of the app icon. This is usually used to show the user there's new content available for your app. To show a number in the badge provide a number bigger than zero in the Badge field:
Please note that if you are using the inbox functionality with the Auto-Badge option, any value you provide in this field will be ignored.
For Android you will be able to remotely provide the LED colour and ON/OFF interval (when supported by the device):
This is useful if you want to alert the users that a message arrived pretty much the same way you would provide a sound.
Finally you can configure a single option for the delivery of this message by clicking in the Delivery tab:
If you wish to throttle the delivery of a message, you can check the box below:
This will allow you to specify the rate of how many messages should sent per second:
As you compose your message you can also see how it will look like by clicking in the Preview button:
Once you are done composing your message, click in the Update button to actually save the changes to the template:
In this page you can also quickly jump to the message composer using this template or delete the template. This is done via the Options menu: