Firebase Push Notification Integration Guide

This document provides step-by-step instructions for integrating Firebase Cloud Messaging (FCM) with your JFW brand. By completing this integration, you enable JFW to deliver push notifications using your own Firebase project credentials.

Prerequisites


Step 1: Create or Select a Firebase Project

  1. Log in to the Firebase Console.

  2. Either create a new Firebase project or select an existing project that you want to integrate with JFW.


Step 2: Generate a Service Account Private Key

  1. In your Firebase project, go to: Project Settings → Service Accounts.

  2. Under Firebase Admin SDK, click Generate new private key.

  3. A JSON file will be downloaded. From this file, note the following values:

    • Private Key

    • Project ID

    • Client Email

These values are required for the JFW integration.


Step 3: Configure Firebase in Admin

  1. Log in to your Admin.

  2. Navigate to: App Integration → Push Notification.

  3. Click Create in the top-right corner.

  4. Select Firebase as the provider.

  5. Fill in the required fields:

    • Code – A unique code to identify this integration.

    • Name – A descriptive name for your Firebase configuration.

    • Private Key – The private key value from your Firebase JSON.

    • Project ID – The Firebase project ID.

    • Client Email – The client email from the service account.

    • Description – Optional notes about this integration.

    • Status – Set to Active to use this configuration.

      • If Inactive, JFW will automatically fall back to the system default configuration.

  6. Click Save to complete the setup.


Step 4: Test the Integration

  1. Once the configuration is created, open the integration detail page.

  2. Click Test in the top-right corner.

  3. A test panel will appear where you can provide:

    • Token – The device token from your app.

    • Title – Notification title.

    • Body – Notification message content.

  4. Click Send Test Notification to validate the integration.

If successful, the notification will be delivered to the specified device.


Step 5: Explore Push Notification APIs

For advanced usage, JFW provides a full set of push notification APIs. You can explore the available endpoints and request/response formats here: 👉 JFW API Reference – Notifications

Last updated