Guides

Edit Templates

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:

Messages templates menu 4533717c0a

In this page click in the template you wish to edit:

Messages templates edit record 2281f977fd

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.

Segmentation

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:

Messages create tab segmentation 05edb89e19

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:

Automation connectors segmentation add segments 719aca115d

If you want to remove users from one or more segments, select the following:

Automation connectors segmentation remove segments e7fa3f4810

Then go ahead and proceed to select the segments you want:

Automation connectors segmentation segments selection fa2eac589f

In the Search Segments field, search for existing segments:

Automation connectors segmentation search segments 303f66f793

If the segment you are looking for does not exist you can create one on-the-fly, just click in the Create it? link:

Automation connectors segmentation create segment 98280546f6

When you are done selecting segments, just go ahead and add the rule by clicking in the Add Rule button:

Automation connectors segmenation add segments rule e71b0db0d2

The exact same thing can be done with tags, to add devices to one or more tags, select the following:

Automation connectors segmentation add tags 5f75db0bda

If you want to remove devices from one or more tags, select the following:

Automation connectors segmentation remove tags e68fabc1f5

Then go ahead and proceed to select the tags you want:

Automation connectors segmentation tags selection 5043a7135d

In the Search Tags field, search for existing segments:

Automation connectors segmentation search tags a99c9a31ba

If the tag you are looking for does not exist you can create one on-the-fly, just click in the Create it? link:

Automation connectors segmentation create tag e98dd27064

When you are done selecting tags, just go ahead and add the rule by clicking in the Add Rule button:

Automation connectors segmentation add tags rule 58f421db91

As you add rules, you will see them in a list as follows:

Automation connectors segmentation rules list 2bb00ca1b0

Content

To actually create the content your users will see when you send a notification, click in the Content tab:

Messages create tab content 16722aa298

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:

Use localizable content d0b0386ed7

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.

Localizable content default tab 3eba0b6b50

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:

Add localizable content button fd47a34f92

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.

Add languages modal 6c24f9f75d

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:

Localizable content tabs 80943e0d76

A message can include a lock screen image (except desktop notifications), for that simply upload one in Lock Screen Media:

Automation connectors notification content lock screen media e4c8988ab2

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:

Automation connectors notification content inbox only eca13af55c

It is also optional to include a title (please note that this field allows placeholders):

Automation connectors notification content title 5cd2262db1

Optionally you can also include a subtitle (please note that this field allows placeholders):

Automation connectors notification content subtitle 7405d9186d

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):

Automation connectors notification content message dd009da054

In all these fields you can use the emoji selector to select emoticons as shown below:

Automation connectors notification content emojis 0e62cf5ab4

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:

Automation connectors notification content rich push templates 97134476b5

To learn more about these templates read the guide here. To learn how to create your own read the guide located here.

Finally you can also add actions to your messages, by using the option below:

Automation connectors notification content actions b82d9f5507

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:

Automation connectors notification content preview button 914c9dccb5

Options

Optionally, for each notification you can also configure a couple more options about your notification. To do that click in the Options tab:

Messages create tab options 9092ed6f6f

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:

Automation connectots notification options ttl adb6060ce5

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:

Automation connectors notification options sound 847fec03e5

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:

Automation connectors notification options extra 21ddedc67d

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:

Automation connectors notification options platform tabs 59e2e46646

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:

Automation connectors notification options badge ba1e52bbb0

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):

Automation connectors notification options led 4148996bfc

This is useful if you want to alert the users that a message arrived pretty much the same way you would provide a sound.

Delivery

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:

Messages create delivery throttle 5cef52ad9f

This will allow you to specify the rate of how many messages should sent per second:

Message template delivery throttle rate 13d9acd7c2

As you compose your message you can also see how it will look like by clicking in the Preview button:

Messages create preview button 1eec695579

Once you are done composing your message, click in the Update button to actually save the changes to the template:

Messages drafts update button 220b6ee180

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:

Messages templates options menu d564da244c