> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Android credentials (Firebase)

> How to create your app in Google Firebase and paste the info into the Notifique dashboard.

<Tip>
  Firebase is Google’s **doorman**: it lets Notifique notify Android phones for your app. You only set this up once in the dashboard.
</Tip>

## In a few words

1. Create a project on Google’s site (Firebase)
2. Register your Android app there
3. Download an **authorization file** (JSON format)
4. Paste it in Notifique under **⚙️ Settings → Android**

## What you’ll paste in Notifique

| In Notifique           | Plain English                                                         |
| ---------------------- | --------------------------------------------------------------------- |
| **Firebase JSON file** | The file Google downloads, copy everything and paste                  |
| **Project ID**         | Project code, usually fills in automatically when you paste JSON      |
| **App package name**   | The app’s “registration name” on Android (e.g. `com.yourcompany.app`) |

<Note>
  The **package name** is like the app’s ID on Android. It must be **the same** in Firebase, Notifique, and your project. If one place is different, push won’t work.
</Note>

## Step 1: Sign in to Firebase

1. Open [console.firebase.google.com](https://console.firebase.google.com)
2. Sign in with Google
3. Click **Add project** and follow the screens until **Create project**

No expert knowledge needed, the wizard walks you through it.

## Step 2: Register the Android app

1. On the project screen, click the **Android** icon (green robot)
2. Under **Package name**, type your app’s name, the same one your developer uses (e.g. `com.mystore.app`)
3. Click **Register app**
4. Firebase offers a `google-services.json` file, **download and keep it**. Your developer puts it in the Android project (so phones can receive alerts)
5. Click **Continue** through the wizard

## Step 3: Enable messaging (Cloud Messaging)

1. Left menu: **Build** → **Cloud Messaging**
2. Accept terms the first time

That’s it, nothing else needed here to start.

## Step 4: Download the authorization file (JSON)

1. Click the **gear** ⚙️ next to Project overview
2. Go to **Project settings**
3. **Service accounts** tab
4. Click **Generate new private key** and confirm
5. Your browser downloads a `.json` file

This file is sensitive, **don’t send it on WhatsApp** or publish online. Use it only in Notifique.

<Warning>
  Anyone with this file can send messages through your Google project. Treat it like a password.
</Warning>

## Step 5: Paste into Notifique

1. Open [app.notifique.dev](https://app.notifique.dev) → **Push** → your app
2. Click **⚙️** (top right)
3. Scroll to **Android**
4. Paste the full JSON in the first field
5. Check that **Project ID** appeared
6. In **Package name**, type the same name from step 2
7. Click **Save changes**

Done. “Firebase already configured” means it worked.

## Step 6: Test

1. Back to Push App screen → **Android** tab
2. Copy the code shown (or ask your developer to paste it)
3. Open the app on an Android phone
4. Send a test alert from the Notifique dashboard

## Something went wrong?

| What happened                         | What to check                                                  |
| ------------------------------------- | -------------------------------------------------------------- |
| Dashboard says package not configured | Empty or mismatched app name between Firebase and Notifique    |
| Alert doesn’t arrive                  | `google-services.json` in project + user allowed notifications |
| JSON rejected                         | Paste the whole file, from `{` to `}`                          |

## Next steps

* [Add code to the Android app](/en/push-api/integracao/android)
* [All guides](/en/push-api/integracao/index)
