Once you have configured at least one of APNS or FCM, you can send push notifications from your agency console. Your client can also send push notifications from their client portal if you have enabled this for them.

To send a push notification from your agency console, click on the app and then select 'Messaging' from the left menu. Click the primary action button to display the Compose Message wizard that will walk you through five simple steps to sending a push notification.

Compose Wizard

Audience

First, choose the audience that you want to send the push notification to. You can send a broadcast to all installs subscribed to receive push notifications or target a specific segment, channel and/or geofence. As you select a segment, a channel and/or geofence(s), the wizard will tell you how many users will be targeted.

Audience

To send the notification to an audience segment, toggle 'Limit to segment' and select the segment from the drop-down list.

Choose segment

To send the notification to installs subscribed to a channel, toggle 'Limit to channel' and select the channel from the drop-down list.

Choose channel

To send the notification to installs in a geofence, toggle 'Limit to geofence' and choose one of the following options, depending which geofence(s) you want to target.

  • If you want to send the notification to installs in any geofence, select 'All enabled geofences'.
  • If you want to send the notification to installs in one (or more) geofences, then select 'Specific geofences' and then add the geofence(s) from the drop-down list.
  • If you want to send the notification to installs in geofences that match one or more tags, then select 'Geofences matching tags' and select the tags from the drop-down list.

Choose geofence

If you select an audience segment, a channel and a geofence, then an install must match all of the filters in the segment, be subscribed to the channel and be in the geofence at the time the notification is scheduled to be sent in order for the notification to be sent to that install.

Click 'Next' when done.

Message Type

When prompted which type of message you want to send, select 'Push Notification' and click 'Next'.

Message Type

Content

Now, define the content of the notification. If you want the notification to appear in the foreground, add a title and a message. Use the emoji pickers to add emojis to your title and message as required.

Content

Kumulos supports Emoji v4.0 / Unicode version 9.0 which is fully supported in iOS 10.3 and Android v7. Older versions of iOS and Android may not support all emojis available. See Emojipedia for more details of what emojis are supported in which versions.

As you add content to the notification you can preview how the notification will look on a user's device. By default, the preview shows how the notification will look on an iPhone.

Compose content

Click the Android tab to see how the notification will look on an Android phone.

Compose content

Advanced Options

To open a URL, add a data payload or set any platform specific options, expand 'Advanced'.

Open a URL

To open a URL when the push notification is tapped by the user, toggle the "Open URL" switch and enter the URL you want to open.

Open a URL

Ensure that you have reviewed the appropriate SDK integration guides to support URL push

Background

To send a notification that can be processed in the background, toggle the "Run background handler" switch. The title & message become optional, and can be omitted to create a silent push.

On iOS this will set the content-available flag on the notification.

Data

To add an arbitrary meta-data object to the push notification, for example to trigger a deep link, toggle the "Data" switch and enter a valid JSON object into the editor. Additional data can be consumed by the SDK, please refer to the platform integration guides for further information.

Add data

iOS Badges

To set the badge on your app on iOS, toggle the "Set Badge" switch. By clicking on "Badge Type" you can choose whether to set the badge to the absolute number you enter in "Count" or to Increment the badge by the positive or negative number you enter in "Count".

Set badge

iOS Category

To set the category on your app on iOS, toggle the "Set Category" switch. Type in the category.

Set category

Android Priority

To set the priority flag and wake up Android devices, toggle the High Priority switch.

Set priority

Delivery Options

Now decide when you want the notification to be sent. If you want the notification to be sent immediately, just click "Next".

Send immediately

Alternatively, if you want to schedule a notification in advance to be sent in the future, toggle the "Scheduled" switch. Enter the date and time you want the notification to be sent.

Schedule

If you selected an audience segment, a channel and a geofence, then an install must match all the filters in the segment, be subscribed to the channel and be in the geofence at the time the notification is scheduled to be sent in order for the notification to be sent to that install.

Set what this date and time is relative to. Do you want everyone to receive the notification at exactly that same time in either UTC or your own timezone (which Kumulos will detect)? Or, more likely, do you want users to receive the notification at that date and time in their local timezone (according to the device on which the app is installed)?

Select Timezone

If choosing to schedule the notification according for the local timezone (according to the device on which the app is installed), what should Kumulos do for installs on devices for which this time has already past? Should we "Ignore" these installs or send at the same time, the "Next Day"?

Timezone Strategy

For example: At 4pm on Christmas Eve, Marketing Mandy in New York decides to send a "Happy Christmas" notification to all of her customers at midnight on Christmas Day. However, for Surfer Steve in Sydney, that was already 6 hours ago. What should Kumulos do? In this example, Marketing Mandy should "Ignore" Surfer Steve as a "Happy Christmas" notification on Boxing Day won't work.

Click "Next" when done.

Review & Send

Lastly, review the audience, content and delivery options you have set. Click 'Back' if you want to make any changes, or click 'Send' to send or schedule the push notification.

Send

The notification will now appear under 'Recently created messages' in your Messaging Dashboard.

You can also create automation rules to automatically send notifications on a trigger such as a device entering or exiting a Geofence or coming into proximity of a Beacon. Alternatively, you can send push notifications from an other backend system using the Push API.