Android FCM Integration

Firebase Cloud Messaging (FCM)

Firebase Cloud Messaging is the official Android push channel provided by Google. It enables you to deliver reliable and fast push notification services to Android apps.

---

A Firebase project is required for push notifications. Hackle uses the Firebase Cloud Messaging V1 API to send pushes.

Follow the guide below to set up a Firebase project and generate a push key.

1

Create a Firebase Project

(Skip to the next step if you already have a Firebase project.)

Firebase project page

2

Verify Firebase Cloud Messaging API (V1) Is Enabled

If you just created a new project, it is enabled by default and you can skip this step. However, if you are using a previously created Firebase project, you need to verify that the Firebase Cloud Messaging API (V1) is enabled.

Click the gear icon next to 'Project Overview' and select Project settings. On the Project settings page, select the Cloud Messaging tab.

Firebase project settings

If **Firebase Cloud Messaging API (V1)** is disabled, click the icon in the upper right corner to navigate to the API management page.

When Firebase Cloud Messaging API (V1) is disabled

Click the Enable button.

Enable Firebase Cloud Messaging API (V1)

3

Generate a Private Key JSON File

Navigate to the Service accounts tab in Project settings.

Click Generate new private key at the bottom of the page.

Service accounts tab" align="center" src="../../../service-guide/.gitbook/assets/0ea49d3-_2024-01-31_11.29.22_98791c9aad4735d9.png"> Firebase project settings > Service accounts tab

Then click Generate key.

Save the JSON file in a secure location. You will need it soon.

Required Permissions

The following service account permissions are required for push notifications to work:

• cloudmessaging.messages.create

• firebase.projects.get

4

Configure Android Push in the Hackle Dashboard

In the Hackle Dashboard, click the Integrate button for **Android Push Message (FCM)** under Settings > External Integration.

Hackle Dashboard push integration page

Select the JSON file downloaded in step 3 and save.