Configuring FCM

Configuring Firebase Cloud Messaging

For showing Push notifications there are 2 important things

  1. Registration for Push that is generating push token.
  2. Receiving the Push payload from Firebase Cloud Messaging(FCM) service and showing the notification on the device.

Push registration can be handled by the application or MoEngage SDK. There is some configuration required based on whether the above-mentioned things are handled by the application or SDK.

Push Registration and Receiving are handled by App

By default, MoEngage SDK attempts to register for push token, since your application is handling push you need to opt out of SDK's token registration.

How to opt-out of MoEngage Registration?

To opt out of MoEngage's token registration mechanism, disable token registration using configureFCM() API while configuring FCM in the MoEngage.Builder as described

Kotlin Java
val moEngage = MoEngage.Builder(this, "XXXXXXXX")
    	.configureNotificationMetaData(NotificationConfig(R.drawable.small_icon, R.drawable.large_icon, R.color.notiColor, null, true, isBuildingBackStackEnabled = false, isLargeIconDisplayEnabled = true))

Pass the Push Token To MoEngage SDK

Your application would need to pass the Push Token received from FCM to the MoEngage SDK for the MoEngage platform to send out push notifications to the device.
Use the passPushToken() API to pass the push token to the MoEngage SDK.

Kotlin Java


Ensure token is passed to MoEngage SDK whenever push token is refreshed and on application update. Passing the token on the application update is important for migration to the MoEngage Platform.

Passing the Push payload to the MoEngage SDK

To pass the push payload to the MoEngage SDK call the passPushPayload() API from the onMessageReceived() in the Firebase receiver.
Before passing the payload to the MoEngage SDK you should check if the payload is from the MoEngage platform using the isFromMoengagePlatfrom() helper API provided by the SDK.

Kotlin Java
if (MoEPushHelper.getInstance().isFromMoEngagePlatform({
    // your app's business logic to show notification

Push Registration and Receiving are handled by SDK



  • When token registration is handled by the SDK, use firebase-messaging 23.0.0 or higher.
  • At any point, your application manifest file should have only one service with intent filter If there is more than one service, only the first service will receive the callback, and MoEngage SDK might never receive the Push Payload resulting in poor delivery rates.

Add the following code to the manifest file:

<service android:name="com.moengage.firebase.MoEFireBaseMessagingService"
         <action android:name="" />


We recommend you to add the callbacks in the onCreate() of the Application class since these callbacks can be triggered even when the application is in the background.

Token Callback

When MoEngage SDK handles push registration it optionally provides a callback to the application whenever a new token is registered or the token is refreshed.

To get the token callback implement the TokenAvailableListener and register for the callback using MoEFireBaseHelper.getInstance().addTokenListener().

Non-MoEngage Payload

If you are using the receiver provided by the SDK in your application's manifest file, SDK provides a callback in case a push payload is received for any other server apart from MoEngage Platform.

To get a callback implement the NonMoEngagePushListener and register for the callback using MoEFireBaseHelper.getInstance().addNonMoEngagePushListener.

Rich Landing

A rich landing page can be used to open a web URL inside the app via a push campaign.

The below configuration is only required if you want to add a parent activity to the Rich landing page, if not you can move to the next section.
To use a rich landing page you need to add the below code in the AndroidManifest.xml

  android:parentActivityName="[PARENT_ACTIVITY_NAME]" >
Parameter Description

Replace with the name that you want to appear on your rich landing page.


Replace with the parent activity name that you want.


Was this article helpful?
0 out of 3 found this helpful

How can we improve this article?