Overview

Required plan

This feature or setting is available to all customers on any Recurly Engage subscription plan.

Prerequisites & limitations

• Company or App Administrator permissions in Recurly Engage.
• App must integrate the Recurly Engage SDK on the target platform.
• Supported on Android devices and web browsers with FCM support.

Definition

The FCM connector ingests your Firebase service account JSON and enables Recurly Engage to send push notifications via Google’s FCM infrastructure.

Key benefits

• Broad device reach: Target Android apps and modern web clients.
• Secure authentication: Leverage Google’s service account keys.
• Centralized management: Handle push credentials within Recurly Engage.

Key details

Firebase Cloud Messaging (FCM)

Required information: FCM service json file

Steps to obtain your FCM service JSON:

1. Go to the Firebase Console and select your project.
2. Click the gear icon in the sidebar and choose Project Settings → Service Accounts.
3. Click Generate new private key.
4. Download the resulting JSON file.

Sample service account JSON payload:

{
  "type": "service_account",
  "project_id": "PROJECT_ID",
  "private_key_id": "PRIVATE_KEY_ID",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "firebase-adminsdk-xxx@PROJECT_ID.iam.gserviceaccount.com",
  "client_id": "CLIENT_ID",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "CLIENT_X509_CERT_URL"
}

Upload file to Recurly Engage

1. In Recurly Engage, go to Settings → Push Credentials.
2. Select Firebase Cloud Messaging and upload your downloaded JSON file.
3. Toggle Active to On to enable FCM push prompts.