Guides

Create Messages

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

Messages create menu a1716134c8

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

Audience

Start by selecting who you are going to send the message to, by opening the Audience tab:

Messages create tab audience 89f4194023

In this tab you start by selecting the scope of your audience using 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:

Messages create device count e7696437bd

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:

Messages create scope all f04dcc38e9

For this type of audience you also allow you to pick a location:

Messages create pick location 9819d345ed

If you do add a location, you will send to all the users inside that location, ignore all the rest. To add a location you can manually draw a shape in the map using the controls below:

Messages create map controls e68d127e84

Or by searching for an address, geo-zone, POI, city or country previsouly created in your app:

Messages create search location 41f433e852

Private User Message

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

Messages create scope user 1e779d0335

Then search for a user by using the name or id:

Messages create search users a24be69e47

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

Messages create selected user 183ddf9801

Private Device Message

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

Messages create scope device 5bf1aa7222

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

Messages create search device 66e4910d09

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

Messages create selected device f5c0946cf8

Segments

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

Messages create scope segments 93ba7c713f

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

Messages create search segments 1787b93f67

And select them as shown below:

Messages create selected segments 1b0499e68a

You can also filter users found in any of those segments, by selecting only the devices that have certain tags. For that you will need to search for one or more tags:

Messages create segments search tags 929d6d0e76

And select all the tags you want to filter for:

Messages create segments selected tags 54ed1f4569

This will make sure you reach devices that have any of these tags and belong to users in any of the selected segments.

For this type of audience you can also pick a location:

Messages create pick location 9819d345ed

If you do add a location, you will send to devices with the selected tags, from users with the selected segments that are currently inside that location. To add a location you can manually draw a shape in the map using the controls below:

Messages create map controls e68d127e84

Or by searching for an address, geo-zone, POI, city or country previsouly created in your app:

Messages create search location 41f433e852

Tags

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

Messages create scope tags 744f86d150

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

Messages create search tags 941327410b

And select the tags you want to use:

Messages create selected tags 061d6e6519

With a selection like this, we would send the message to all the devices in any of these tags.

Optionally you can also pick a location:

Messages create pick location 9819d345ed

If you do add a location, you will send to devices with the selected tags that are currently inside that location. To add a location you can manually draw a shape in the map using the controls below:

Messages create map controls e68d127e84

Or by searching for an address, geo-zone, POI, city or country previsouly created in your app:

Messages create search location 41f433e852

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:

Messages create scope event a2d87175e3

This can be extremely useful if want to create a follow up message to all users that open a previously sent message, visited a region or any other event that you track in your app.

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

Messages create select event 1f9bf9dbf2

Learn more about events by reading our guides located here.

Then select the start and end date for your criteria:

Messages create event dates d8a17228be

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 provide a criteria:

Data export criteria bd006c425f

This is similar to the following type of audience, described below. This will allow you to reach users/devices that executed a certain event and are also assigned to certain segments, tags, locations or device proeprties.

Custom Criteria

If all of the audience types we've shown before are not enough and you wish to have total control over the selection of devices that you want to send a message, then you can use this type which allows you to combine tags, segments, location and device properties to achieve a fine-grained selection. Start by selecting the option below:

Messages create scope criteria 06b1749114

In the Criteria selector you can select between Segments, Tags, Location or Device Properties. You will have to select them individually and eventually combine them to create a powerful criteria.

To select segments go ahead an select Using Segments from the Criteria option:

Automation connectors filters segments bdd0b54b6e

You can search for an existing segment by typing in the Search Segments field:

Automation connectors filters search segments 938a5cc177

Because segments can be created via the dashboard, if the segment does not exist, you can quickly create one by clicking in the Create it? link:

Automation connectors filters new segment 750ad4acc5

Once you have selected the segments you want to use, go ahead and click in the Add to Criteria button:

Automation connectors filters add segments 91eb6ddd2c

This will add the segments you've selected to the criteria. Now you can select the quantifier for this selection. If you want the criteria to match any of the segments you've selected, leave the option In any of these selected:

Automation connectors filters segments any 42e57734e8

If you want to make sure you only show content if the users are in all the segments you've selected, change the quantifier to In all of these:

Automation connectors filters segments all 559657ee80

And finally if you want to make sure you only show content if the users are not in any of the segments you've selected, change the quantifier to In none of these:

Automation connectors filters segments none 02f1a00b1c

You can also do the same thing with tags, even combine it with segments. To also add tags in this criteria, select Using Tags from the Criteria option:

Automation connectors filters tags 4223dd53fe

You can search for an existing tag by typing in the Search Tags field:

Automation connectors filters search tags 5489929908

Once you have selected the tags you want to use, go ahead and click in the Add to Criteria button:

Automation connectors filters add tags a14d9915c7

This will add the tags you've selected to the criteria. Now you can select the quantifier for this selection. If you want the criteria to match any of the tags you've selected, leave the option In any of these selected:

Automation connectors filters tags any 8fca9d5784

If you want to make sure you only show content if the devices are in all the tags you've selected, change the quantifier to In all of these:

Automation connectors filters tags all 027aaa6b76

And finally if you want to make sure you only show content if the devices are not in any of the tags you've selected, change the quantifier to In none of these:

Automation connectors filters tags none 19dc0ef9f0

In this criteria you can include location as a decisive factor of who ever gets to see your content. To start adding locations to your criteria, select Using Location:

Storage criteria type location 4cf172e9b7

This will show you a map where you can either search for a specific address or any of the geo-zone, POI's, cities or countries you already created or you can simply draw a shape anywhere in the map:

Storage criteria location map b6e5a8c624

To search for a specific address select the following in the map:

Storage criteria location search address 08a0d03519

To search for a specific Geo-Zone select the following in the map:

Storage criteria location search geozone e911b13950

To search for a specific POI select the following in the map:

Storage criteria location search poi 456e4e2e57

To search for a specific City select the following in the map:

Storage criteria location search city 54faa6ccd0

To search for a specific Country select the following in the map:

Storage criteria location search country bc43e8a051

Or simply select one of the shapes available and draw it in any location in the map:

Storage criteria location draw 0ed9aa4c63

Once you have selected a location, your map will look like this:

Storage criteria location selected 06b23137d5

You can select one or more locations and once you've done with your selection you simply need to click in the Add To Criteria button to actually add these locations to the criteria:

Storage criteria location add criteria button 3d1159a952

Once you've selected some locations you can then specify how exactly you can use them in the criteria. If you want to show content to anyone that uses your apps while at any of the locations, leave the option In any of these selected:

Storage criteria location any f0e29c3e6d

If you want to show content to anyone that uses your apps while at all of the locations at the same time, select the option In all of these:

Storage criteria location all bc8bf7982c

If you want to show content to anyone that is not any of the selected locations, select the option In none of these:

Storage criteria location none c03300e96e

Finally you can also filter based on certain properties of devices (operating system, app version, language, etc), even combine it with segments and tags if needed. To also add device properties in this criteria, select Using Device Properties from the Criteria option:

Automation connectors filters device properties dde36e798e

To start adding device properties to the criteria click in the Add a Property? link, as shown above. This will create an entry like this:

Automation connectors filters add device property 9efbf786fc

You should now select which device property and the operator to user and type the value you want to filter it for, like the example below:

Automation connectors filters device propery inserted 8c0aabcf3e

If you select the operator is any or is not any, you will be able to add more than one value by clicking in Add another value link , like shown below:

Automation connectors filters device properties more values 43cb2b2abc

If instead you want to combine device properties you can simply add more properties by clicking in the Add another device property link, as shown below:

Automation connectors filters device properties add more c7fcf779c5

When you are ready with your selection of device properties just go ahead an hit the Add to Criteria button and you will see a selection like this:

Automation connectors filters device properties add criteria 6fd94e7b39

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 segments or tags in each rule. 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

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 the delivery of this message by clicking in the Delivery tab:

Messages create tab delivery 2824524aae

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

Messages create delivery draft f3c17b8ee1

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

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

Messages create delivery schedule 540e42a5f5

Then simply provide the date you wish to schedule the message for:

Messages create schedule date 325621ea94

If you wish to use the device's local time instead, toggle the switch below:

Messages create schedule local f74c86f4d1

This delivery mode also supports recurrent scheduled messages. To repeat your message at the given time, check the following box:

Messages create delivery schedule repeat 2c9057f0a9

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

Messages create delivery schedule repeat hour 17c328fe4e

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:

Messages create delivery schedule day 124b1d7c02

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

You can also select it to be sent weekly:

Messages create delivery schedule week 904a9d64d9

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:

Messages create delivery schedule month 176924cc91

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:

Messages create delivery schedule year 9c0d3ae758

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

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

Messages create delivery schedule end afbbb4b2b8

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

Messages create delivery schedule summary 2c19dcd277

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

Messages create delivery throttle rate c22c3b6958

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:

Messages create preview button 1eec695579

Once you are done composing your message, click in the Create button to send or save the message (depending on your delivery settings):

Messages create create button c1aabea258

After hitting this button we will show you a summary of your message like the one below:

Messages create review message 8555fbcb13

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

Messages create create button c1aabea258

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:

Messages create authentication 3eed56d8e1

Depending on your account settings, we will either request your password or if you are using 2FA you will need to provide the 6 digit code from the Google Authenticator app.

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