Skip to main content

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

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Configuring push notifications for Android apps

Updated on November 9, 2021

Keep the users up-to-date with various events in your business process by enabling automatic push notifications in your mobile app for Android devices.

Before you begin: Prepare the framework for enabling push notifications in your mobile app:
You configure push notification support by obtaining and adding the following Firebase Cloud Messaging (FCM) services parameters to your mobile certificate set:
FCM server key
The key that the Pega Platform server uses to authenticate with the FCM services.
Google Services JSON
A JSON configuration file for FCM-based projects.

    Obtain the FCM parameters:

  1. Go to, sign in to your Firebase account, and then access the Firebase console.
    For more information about managing projects in Firebase, go to the Firebase documentation website.
  2. Create a Firebase project for your mobile app.
  3. On the console dashboard, launch the setup workflow, and then add Firebase to your Android app:
    1. Register your app in Firebase.
      Important: When you register your app in Firebase, ensure that the Android package name in Firebase matches the App ID package name of your certificate in Pega Platform.
    2. Download the google-services.json file, and then finish the setup workflow.
      Note: You can also download the JSON file at any time from the project settings in your Firebase console.
  4. In the Firebase console, go to the cloud messaging settings, and then copy the server key.
  5. Add the FCM parameters to the certificate that you want to use in your mobile app:

  6. In the navigation pane of App Studio, click SettingsMobile certificates.
  7. Click the certificate that you want to use in your mobile app.
  8. In the FCM Server Key field, enter the server key from the Firebase console.
  9. In the Google Services JSON section, click New, and then upload the google-services.json file from the Firebase console.
  10. Click OK, and then save the certificate by clicking Save.
What to do next: Ensure that your mobile app receives automatic and manual push notifications by adding the certificate that you updated to the mobile channel for your app. For more information, see Generating installation packages.
  • Configuring push notifications on iOS

    You configure the push notifications for the iOS mobile app in a new or an already existing iOS certificate set that contains mobile provisioning with push notifications enabled. You must upload a .p12 file containing an Apple Push Notification service (APNs) certificate used for push notifications. After you configure the options described in the following procedure, push notifications will be enabled for the iOS mobile app.

  • Sending push notifications with the push console

    Send custom push notifications to all or specific users of your mobile app by using the push console in the mobile channel.

  • Adding the push notifications shape to a workflow

    You configure push notifications by adding a Push Notification smart shape to a workflow. You add a Push Notification smart shape before an assignment shape and configure it to send a push notification to a user's mobile device. The notification indicates that an appraisal is ready for user's review.

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