Guides

Create Push Message

In this area you'll learn how to send a message using Notificare.

To access this area, in your app's menu, expand the Messages menu item and click in New Push Message:

Menu 1ab9e3d382

This will take you to a wizard divided in five different tabs like shown below. Some sections are optional and you will notice that they are marked as ready by default.

Tabs c555947b6c

Audience

Start by selecting who you are going to send the message to, by opening the Audience tab. In this tab you start by selecting the scope of your audience by pick one of the several options available in our platform.

You'll notice that as soon as you select an option, we will automatically show you the number of devices you will be reaching:

Audience count fe13308d4f

This will be calculated with every change you make to your audience selection.

Broadcast

If you want to send to all your users select the option shown below:

Broadcast 81fa459d2f

For this type of audience you can also define a specific location:

Map 00c91f4b65

If you do add a location, you will send to all the devices inside that location and ignore all the rest. To add a location you can manually draw a shape in the map or simply search for an Address or a previously created Geo-Zone, POI, city or Country.

Private User Message

If you want to send to single user and all its devices, select the option shown below:

Single user 53afdec172

Then search for a user by using its name or ID:

Search users 48243a4181

And finally select the user you wish to send the message to:

Selected user a4808a6b1e

Private Device Message

If instead you want to send to single device, select the option shown below:

Single device 5d3ef58818

Then search for the device token of the device you are looking for:

Search devices 2b2ab21f9a

And finally select the device you wish to send the message to:

Selected device f72deabf82

Segments

If you wish to send a message to a group of users that belongs to a certain segment, select the following option:

Segments e9657e4967

You can select one or more segments, first you need to search for segments like shown below:

Search segments d8ccaf9aa0

You can then click in one or more segments to select them:

Select segments 27a263823a

When you are done selecting segments, click in Done and your selection will look like the following:

Selected segments e26371d5f7

For this type of audience you can also define a specific location:

Map 00c91f4b65

If you do add a location, you will send to all the devices inside that location and ignore all the rest. To add a location you can manually draw a shape in the map or simply search for an Address or a previously created Geo-Zone, POI, city or Country.

Tags

If you just need to send to a group of devices in one or more tags, you should select the option below:

Tags b3019fb4c2

Then search for one or more tags you wish to send the message to:

Search tags be7e73ee37

Then in all the tags you want to select them:

Select tags 1dbe7902fd

When you are done selecting tags, click in Done and your selection will look like the following:

Selected tags 990948f2fa

Event Based Criteria

If you want to send a message to all the devices that executed a certain event during a period of time, select the option below:

Event based 1195125280

This can be extremely useful if want to create a follow up message to all the users that previously interacted in some way with your campaigns, app or website.

For this type of audience you will need to select which event you want to use:

Event 46d13ea946

Learn more about events by reading our guides located here.

Then select the start and end date for your criteria:

Date range 1d80dc8470

For this type of audience we will automatically fetch all devices that executed the event between those dates and use it as the recipients of the message.

Additionally, for this type of audience, you can further provide fine-grain audience selection by using a custom criteria:

Criteria 01286838e2

Learn how to setup a custom criteria by reading our guides located here.

Custom Criteria

With this type of audience selection, you can combine tags, segments, location and device properties to achieve a fine-grained selection. Start by selecting the option below:

Custom criteria 17cfcfc852

Additionally, for this type of audience, you can further provide a fine-grained selection using a custom criteria:

Criteria 01286838e2

Learn how to setup a custom criteria by reading our guides located here.

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:

Segmentation rules ddaa1db604

Learn more about how to setup segmentation rules in our guides located here.

Content

To actually create the content your users will see when you send a push message, 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 localized content to start creating content in other languages:

Use localized content 032fe3bb8f

Automatically a new tab called Default will appear, which will allow you to create the content that we will use as a fallback when the device that receives the message does not have a language provided by the localized content you create.

Default tab 2104813e74

Make sure you create the default content before proceeding to add more languages, as other localized content must share the same type and actions you use in the default content. When you are ready to add more languages, go ahead and click in the following button:

Add language button f4ca6508eb

This will open a new window where you can select a language/region combination. Note that region is a property that is only available in SDK 2.0 or higher, so it's important your apps use this version if you would like to have use 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 locallized content modal ffd74a42e7

Adding languages will eventually add new tabs to the message composer, as shown below. Make sure you localize all fields accordingly in each tab:

New language tab f582872e1b

A push message can include a lock screen image, for that simply upload a image file or use an existing one (only available if you have the Storage add-on) in the Lock Screen Media section:

Lock screen media a4e28d47e2

By default a push message will always generate a remote notifications, if you are using our inbox functionality and you don't want to generate one and only show it in the inbox instead, go ahead and toggle the following option OFF:

Send push 4f842f9715

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

Title a55c95445b

Also optional, a push message can contain a subtitle (please note that this field also allows placeholders):

Subtitle 4b66ab2a07

It is mandatory that you include a short message (please note that this field allows placeholders):

Message 8842a1758f

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:

Rich push templates 294ca8adf7

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

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

Actions ac26b84184

To learn more about actions, please read the guide here.

Options

Optionally, for each push message, you can also configure some optional settings. To do that click in the Options tab. If you wish to not deliver your message after a certain amount of time, provide a value in seconds in the following field:

Ttl 7d4f02ce19

This can be useful if the content of your message is time sensitive and not relevant if not delivered (recipient's device is OFF or unavailable) 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 default as the value to let the device play the default sound when a message arrives. You can also play custom sounds, 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:

Sound 03f6708cd3

In some cases, your app might need to handle some information before processing a push message. For those cases, we allow you to include a machine-readable value (key-value pairs JSON object) in each message as the Extra:

Extra afe571a908

Developers should then handle this data in the app as it will be accessible as soon as the message is delivered to the user's device.

Finally you can also provide some platform-specific options. For iOS you can override the badge value:

Ios tab 2c937f2f97

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 which channel to use and/or the LED colour and ON/OFF interval (when supported by the device):

Android tab 440304193e

These settings might be useful if you want to send a message platform specific message.

Delivery

Finally you can configure the delivery of this message by clicking in the Delivery tab:

Delivery d86320b513

If you wish to send the message right away, select the option below:

Deliver now 645b966571

If you wish to schedule a message to a date in the future, select the following option:

Deliver scheduled a64ebec198

Then you have to options, send to all users at the same time by providing a date and a timezone:

Schedule time fa6ebc036b

Or by sending to each user at their local device time:

Schedule local f2cdeecfbe

This delivery mode also supports recurrent scheduled messages. To repeat your message, toggle the following option:

Repeat schedule b8b8e908f8

You can then select if you want to repeat it hourly (except if you have chosen to use the device's local time):

Repeat hourly 2b102c4b18

Optionally you can select the specific hours and even the days of the week when the message is sent.

You can also select it to be sent daily:

Repeat daily cf2de2aef2

Optionally you can increase the interval to repeat the message every x days.

You can also select it to be sent weekly:

Repeat weekly dcbc1c009b

Optionally you can increase the week interval to repeat the message every x weeks or select more days of the week.

You can also select it to be sent monthly:

Repeat monthly 7aba58ffce

Optionally you can increase the month interval to repeat the message every x months and select between sending it on that same day or that same day of the week each month.

Finally, you can also select it to be sent yearly:

Repeat yearly a38059bd09

Optionally you can increase the year interval to repeat the message every x years.

You can also specify an end date for your recurrent schedule, by selecting a date in the following field:

Repeat end date 719bbe0047

As you configure your recurrent scheduled message, you will see a human-friendly summary describing your recurrent schedule job, like the one below:

Repeat summary 093c15e8b7

If instead you wish to save this message and send it later, select the option below:

Delivery later bdb08f3d05

This option will simply save the message in the drafts area. To learn about drafts read our guides located here.

Finally if you wish to throttle the delivery of a message, you can check the box below:

Throttle 07afa61b2f

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

Throttle rate b406804993

We will estimate for your the approximate delivery time based on the audience you've selected. This option might be useful to avoid messages from flooding your servers as users will open your app or website in response to a remote notification.

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

Preview button 3a832a28f0

Before you roll out a message to your selected audience, you can always test it first by sending it to one or more test segments:

Test button 8b8254c9c2

This will open a window like the one below:

Test message 67acc3af22

In this window, you should search for test segments previously created:

Search test segments 5e66622dae

You can select one or more segments, by clicking on them:

Select test segments b34f05cee0

Once you select all the test segments you want to use, go ahead and click in the Done button. Your selection will then look like this:

Selected test segments f7b47b0889

And go ahead and send a test message by clicking in the Send Test Message button:

Send test message button 88d3559690

When you feel confident that your message looks exactly like you want and have performed from tests, click in the Send button:

Send button f9db3ea6e0

You will have one last chance to review your message:

Review message 428c730ca6

If everything is OK and you want to proceed, go ahead and click the Continue button:

Continue button 991403451e

As a security measure, if you are trying to send or schedule a message to more than one user or device, we will request your authentication before actually send it. If you use 2FA, you will need to provide the 6 digit code:

Send with 2fa ab301048de

Otherwise you will be required to authenticate this operation with your password:

Send without 2fa cd107ff1f5

After this your message will be sent or scheduled and shown in the Sent list where you can check its performance.