Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring the delivery of push notifications with the Push Notification shape

Updated on August 4, 2022

The Push Notification shape in the flow canvas enables the user to configure notification messages for delivery.

Pega Customer Decision Hub

The following table lists the various roles involved in the push notification process along with their responsibilities:

App DeveloperCreates mobile app, which:

Registers and un-registers app users for receiving push notifications from the application, via the provided REST services. See Push Notification User Registration Services for details.

Receives and displays push notification messages to app users.

Deploys app on app platform (for example, App Store, Google Play).

Provides marketing administrator with key registration information for app.

Outside of Pega Customer Decision Hub
AdministratorRegisters app for receiving push notification messages from Pega Customer Decision Hub.In Pega Customer Decision Hub
App UserDownloads and installs app from app store.(Behind the scenes, app registers the user for receiving push notifications).Outside of Pega Customer Decision Hub
AnalystCreates actions and utilizes the Push Notification flow shape to send notification messages to registered app users.In Pega Customer Decision Hub
SystemHandles registrations of apps.

Handles registrations/un-registrations of app users.

Delivers notification messages to registered users for registered apps.

In Pega Customer Decision Hub

The following General Configuration options are available for the Push Notification shape:


Notification message to push to the customer’s registered device(s). This can be plain text or an expression and can include property references.

If the Push notification is defined as a treatment for an Action, the message should be configured to reference .OfferData.PushMessage. Refer to Configuring push notification treatments for more details.

Play Sound?

Associate sound with the notification message.

If this setting is enabled, the message payload references the default sound. When the message is received by the device, the device-specific default sound for notifications (if enabled) is played.

Key Code

Marketing code used to identify the treatment.

This value can be passed to the device along with the notification message (as additional values).

A sample configuration for the general settings is shown below.

Sample general configuration for push notification shape in action flow.

Application Configuration

Users also have the option to specify the application where the notification should be sent.

The following Application Configuration options are available in the Application Configuration sub-section:

Default ApplicationDetermines whether the notification message should be pushed for the default app.
Other ApplicationDetermines whether the notification message should be pushed for the specified app. Select the app to notify from the drop-down of configured apps.

Setting the Default App

Administrators can mark one app as the default. This is beneficial in scenarios where there is only app or where a particular app is predominantly used. The default app is the (default) target for push notification messages in flows. Analysts can choose to override this by selecting a specific app

Use the Make Default action from the Actions menu to mark an application as the default.

Wait After Sending

Users can determine whether they would like to wait after sending a Push Notification or proceed directly to the next step in the Flow. The wait options available are the same for all wait-based shapes and are described in the section on the Wait shape.

Send Additional Values

Users can choose to include other information as part of the notification message payload. This data can be used by the app developer. Different platforms place different restrictions on the size of the overall message payload. Users should be aware of this limitation when specifying additional values. A notification message that ends up being larger than the allowed payload size may not be delivered.

Enable the Send Additional Values? check box (in the Additional Details section of the properties panel) to pass additional values. Use the grid controls to add fields. For each field, specify a name and value. The name must be plain text, but the value can be an expression. The key code can also be passed as an additional field.

Set Badge

The badge value can be sent in the payload of the push notification and displayed if the user's device's operating system supports this function.

  • Previous topic Uploading the required certificates for passbooks
  • Next topic Configuring application settings for push notifications

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us