e-trainiaDocs
IntegrationPush Notification

How to Config Mobile Integration

Site Settings → Integration → Push Notification

The Push Notification page under Site Settings → Integration lets you connect your site to Firebase Cloud Messaging (FCM) so the admin panel can send push notifications to users' web browsers.

Click Site Settings

Click Integration → Push Notification → App Build


Firebase — App Build Config

You can use Firebase to manage your app's push notifications and user engagement. Set up your Android and iOS app build files below.


How to Set This Up

Follow these steps in the Firebase Console (and Apple Developer account for iOS) to get the files this page needs. This assumes you've already created a Firebase project — do that first on the Push Notification page's Setup tab if you haven't.

1. Register Your Android App

In the Firebase Console, open your project and click the Android icon to add a new app. Enter the app's package name (for example, com.yourorg.app). It must match exactly what your Android build uses. Register the app, then download the google-services.json file it creates.


2. Register Your iOS App

From the same Project Overview page, click the Apple icon to add a new app. Enter the app's Bundle ID (it must match your iOS build exactly). Register the app, then download the GoogleService-Info.plist file it creates.


3. Get Your APNs Authentication Key

In your Apple Developer account, go to Certificates, Identifiers & Profiles → Keys, create a new key with the "Apple Push Notifications service (APNs)" capability enabled, and download the .p8 file. You can download it only once.

Note the Key ID shown on that page and your Team ID (in the Membership details of your Apple Developer account).


4. Add the APNs Key to Firebase

Back in the Firebase Console, open Project Settings → Cloud Messaging, scroll to "Apple app configuration", and upload the same .p8 key along with its Key ID and Team ID.

Note

Firebase relays iOS notifications through Apple's APNs, so this step is required even though the key is also stored on this page.


5. Upload Everything Below and Save

Upload (or paste) the google-services.json and GoogleService-Info.plist files. Then paste the APNs key, Key ID and Team ID into the form below, and save. You can replace any of these later, for example if you change your keys or register an app again.


App Build Config

Upload the platform config files that Firebase gave you when you registered your Android and iOS apps. These values are also shown for reference on the Push Notification page.


Android

Status: Not Configured

FieldDescription
google-services.json FileUpload the google-services.json file that Firebase gave you when you registered your Android app
Or Paste google-services.jsonPaste the contents of the google-services.json file into the edit field instead of uploading
Save App Build ConfigSaves the Android config and changes the status from Not Configured to Configured

✅ After you provide the google-services.json file (upload or paste) and click Save App Build Config, the Android status changes from Not Configured → Configured.


iOS

Status: Not Configured

FieldDescription
GoogleService-Info.plist FileUpload the GoogleService-Info.plist file that Firebase gave you when you registered your iOS app
Or Paste GoogleService-Info.plistPaste the contents of the GoogleService-Info.plist file into the edit field instead of uploading
Save App Build ConfigSaves the iOS config and changes the status from Not Configured to Configured

✅ After you provide the GoogleService-Info.plist file (upload or paste) and click Save App Build Config, the iOS status changes from Not Configured → Configured.


Android

Android

iOS

iOS

After you click Save App Build Config, the saved changes appear in the App Build section at the bottom of the page. It shows the updated config and the new Configured status for that platform.


Apple Push Notification Service (APNs)

Required for iOS push notifications

FieldDescription
APNs Auth Key (.p8 contents)Paste the contents of your .p8 key file downloaded from your Apple Developer account
APNs Key IDThe Key ID shown on the APNs key page in your Apple Developer account
Apple Team IDYour Team ID, found in the Membership details of your Apple Developer account
Save App Build ConfigSaves the APNs config and changes the status from Not Configured to Configured


Configuration Status (All Platforms)

PlatformFieldStatus Flow
Androidgoogle-services.jsonNot Configured → Configured
iOSGoogleService-Info.plistNot Configured → Configured
APNs.p8 Key + Key ID + Team ID-

Quick Reference

FieldDescription
Android Configgoogle-services.json file (upload or paste)
iOS ConfigGoogleService-Info.plist file (upload or paste)
APNs Auth KeyContents of the .p8 key file
APNs Key IDIdentifier of the APNs key
Apple Team IDYour Apple Developer Team ID
Save App Build ConfigSaves the config and updates the status

FAQ

Last updated on