Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Here’s a step-by-step guide to creating a Firebase account, setting up a project and configuring the Firebase integration in CRM.COM.

Info

If you plan to develop your own app instead of using the CRM.COM Release app, you can still use this guide to create your Firebase account but skip the items item marked with a ⭐.

Step 1 - Create a Firebase Account

...

  1. Set up a new project

    • In the Firebase Console, click on Add project or Create a project.

  2. Name your project

    • Enter a name for your project. This name will be displayed in the Firebase Console and will be used to identify your project in Firebase services.

    • Click Continue after naming your project.

  3. Set up Google Analytics (optional)

    • Firebase allows you to enable Google Analytics for free, which can provide valuable insights into app usage.

    • You can choose to enable or disable this option. If you enable it, you’ll need to set up your Google Analytics account preferences.

    • Click Continue.

  4. Review and create the project

    • Firebase will show you a summary of your project setup options.

    • Click Create project. Firebase will take a few moments to set everything up.

    • Once done, click Continue to be taken to your new Firebase project’s dashboard.

...

You must connect a mobile or web app to Firebase, you can do so by following these steps within your project dashboard:

  1. Select your platform

    • Choose Create three platforms - iOS, Android, or and Web,based on the app you want to integrate with Firebase. If front-end apps are not required, then create only the Web platform for the portal.

  2. Register your app

    • Follow the setup steps specific to your chosen platform, including registering your app and downloading .

    • For iOS and Android apps - Register your apps and download the necessary configuration files (i.e.g., google-services.json for Android or GoogleService-Info.plist for iOS). These files store essential metadata, such as API keys, project identifiers, and settings, allowing Firebase SDKs to connect your app to the right Firebase project.

    • For the portal (Web) - You must copy part of the generated firebaseConfig script to use for the CRM.COM Firebase integration (for the APP Config setting) in step 5 below. Specifically, you need to start copying from the opening bracket (i.e. { ) after firebaseConfig up to the closing bracket (i.e. } ).

    image-20250127-130940.pngImage Added
  3. Send the configuration files to CRM.COM

    • Send the Android and iOS configuration files you downloaded in step 2 above to CRM.COM

    at must build these
    • need these files to build them into the

    apps
    • app we

    will
    • send you for review.

  4. Generate a Public Key

    1. To generate a key pair, navigate to Project Settings > Cloud Messaging > Web Configuration > Web Push Cetificates > and click on Generate Key Pair.

    2. Copy the public key, you’ll need this for the VAPID Key in step 5.

Step 4 - Create a Firebase Service Account

  1. Access the Firebase console

    • Go to the Firebase Console.

    • Select your project

  2. Navigate to Service Accounts

    • In the Project Settings, click the settings gear icon ⚙️ in the left-hand menu and select Project Settings.

    • Go to the Service Accounts tab.

  3. Generate and save the Service Account key

    • In the Firebase Admin SDK section, click Generate new private key.

    • A confirmation dialogue will appear. Click Generate Key to confirm.

    • A JSON file containing your service account credentials will be downloaded automatically. Save You should save this file securely, as it provides access to your Firebase project. You must upload this file in the next step when configuring the Firebase integration in CRM.COM to authenticate Firebase Admin SDK.⭐

Step 5 - Complete the Firebase Configuration in CRM.COM

...

  1. Firebase configuration in CRM.COM

    1. Sign in to the back-end system and navigate to Integrations via Platform > Integrations > Firebase.

    2. Click on Setup and provide a name for your Firebase integration.

    3. Select Manage and provide:

      1. Project Id - The id for the project

      ID
      1. created in

      Firebase. Click on More Actions and upload the JSON file you
      1. step 2.

      2. Firebase Key - Find this key from the file downloaded in step 4.3 above.

      3. APP Config - The firbaseConfig script you copied from step 3.2 above, adding quotes for each field name (see example below).

      4. VAPID Key - This is the public key generated in step 3.5.

    4. Enable your Firebase integration by selecting the Enable Integration button.

That’s it! You’ve successfully created a Firebase account, created a project and configured your Firebase integration in CRM.COM .

Info

Examples of the expected Firebase integration settings:

Project ID

crmcom-contact-app-v2

Firebase Key

{
"type": "service_account",
"project_id": "crmcom-contact-app-v2",
"private_key_id": "4088846cc84a1153c003978508160dad74ddfbb9",
"private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvAIBADdcq2P\nFmcmLzyVAgMBAAECggEABbhBhW ...... LjG9XcuAqGyxcxsnIqJRjr7qrwMUOQ==\n-----END PRIVATE KEY-----\n",
"client_email": "firebase-adminsdk-7grxj@crmcom-contact-app-v2.iam.gserviceaccount.com",
"client_id": "159810741943393331071",
"auth_uri": "https://accounts.google.com/p/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": "https://www.googleapis.com/robot/v1/metadata/s130/firebase-adminsdk-siai5%40crmcom-contact-app-v2.iam.gserviceaccount.com"
}

APP Config

{
"apiKey": "AIAyc9DfVlsEMzhzaSyBDh2hkhTo7nJXIULP3nq",
"authDomain": "crmcom-contact-app-v2.firebaseapp.com",
"databaseURL": "https://crmcom-contact-app-v3.firebaseio.com",
"projectId": "crmcom-contact-app-v2",
"storageBucket": "crmcom-contact-app-v2.firebasestorage.app",
"messagingSenderId": "90715804890",
"appId": "1:07415880909:web:eea3cbe923a8764166869d",
"measurementId": "G-408KZ7JP8W"
}

VAPID Key

TVqg8DgwCTF3dMENugNJqyGWl7k1uO1O9_2y_0paPiJMT0MM-ih4f7ttmIUBKENzVimjuyQEPQdstwVh_mwwjJF

If you need assistance, don't hesitate to get in touch with us at support@crm.com.