> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/en/external-link/crm-channels/fcm-integration.md).

# 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.

{% stepper %}
{% step %}
**Create a Firebase Project**

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

![Firebase project page](/files/9WNgOPVv3GrVKlIxYQhQ)
{% endstep %}

{% step %}
**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](/files/7xiPz4Q5sG8KgT7nsSPV)

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](/files/dUM2NIrR1S9cKReBvGiQ)

Click the **Enable** button.

![Enable Firebase Cloud Messaging API (V1)](/files/vef2P3AFDsVBGaW0eBxU)
{% endstep %}

{% step %}
**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](/files/eoPeqzQpdYpPu17OcCJ3)

Then click **Generate key**.

![](/files/mdTtjm6TSDmHPJEoSlxn)

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

{% hint style="info" %}
Required Permissions

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

* `cloudmessaging.messages.create`
* `firebase.projects.get`
  {% endhint %}
  {% endstep %}

{% step %}
**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](/files/hdGVr4cjURSmtg5aITX2)

Select the JSON file downloaded in step 3 and save.

![](/files/r0iV5tjZNZxwgVO69StU)
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hackle.io/en/external-link/crm-channels/fcm-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.