Skip to content
EntrigDocs

FCM (Android)

Firebase Cloud Messaging (FCM) delivers push notifications to Android devices. Entrig uses your Firebase service account to send notifications on your behalf. No server-side code or SDK changes needed.

What you’ll need

  • A Firebase project with FCM enabled
  • A Firebase service account key: a JSON file downloaded from Firebase Console under Project Settings → Service accounts → Generate new private key
  • Your Android app’s package name (Application ID), e.g. com.example.myapp

Configure

  1. Open Channels → Push in Settings

    From the Entrig dashboard, go to Settings → Channels. Under the Push section, find FCM and click Configure.

  2. Upload your service account JSON

    Click Choose File and select the service account .json file you downloaded from Firebase Console.

  3. Enter your Application ID

    Enter your Android app’s package name exactly as it appears in your build.gradle or app/build.gradle.kts file.

  4. Save

    Click Save. Entrig validates the service account and stores it encrypted.

Troubleshooting

Notifications aren’t arriving on Android

Check: Make sure the Application ID matches exactly what’s registered in Firebase, including casing. A mismatch silently drops the notification.

”Invalid service account” error

Cause: The JSON file is malformed or is not a Firebase service account key (e.g. you uploaded a different type of credential file).

Fix: Re-download a fresh key from Firebase Console → Project Settings → Service accounts → Generate new private key and upload that file.

FCM shows “Not configured” after saving

Cause: The save request may have failed silently due to a network error.

Fix: Refresh the page and try configuring again.