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

# Push notifications

Stay connected with your customers by utilizing push notifications to alert them of new chat messages, release notes, and news articles. This will deepen engagement and foster stronger relationships.

Gleap supports <a target="_blank" href="https://firebase.google.com/docs/cloud-messaging">Firebase Cloud Messaging</a> to send push notifications to users.

## Setup Firebase Cloud Messaging

To make use of Gleap Push Notifications you must add the Firebase Cloud Messaging service to your app or website. Learn how to get started with FCM <a href="https://firebase.google.com/docs/cloud-messaging/js/client" target="_blank">here</a>.

## Getting your Firebase Cloud Messaging Token

Open your project in Firebase and open the project settings.

Click on "Cloud Messaging" and, if it is not already enabled, activate the Firebase Cloud Messaging API (V1).

<img src="https://mintcdn.com/gleap-1d346ffa/b8_EVsZHbtxdB2pN/images/cloudmessaging_v1.png?fit=max&auto=format&n=b8_EVsZHbtxdB2pN&q=85&s=8534fa0dd4382de0a1271a10babe42ae" alt="Gleap Firebase Setup" width="2882" height="1036" data-path="images/cloudmessaging_v1.png" />

Proceed to the "Service Accounts" section and generate a new private key, which will automatically create a file named like `serviceAccountKey.json`.

<img src="https://mintcdn.com/gleap-1d346ffa/b8_EVsZHbtxdB2pN/images/serviceaccounts.png?fit=max&auto=format&n=b8_EVsZHbtxdB2pN&q=85&s=32b86bfc558884a98962819fb7ee63ee" alt="Gleap Firebase Setup" width="2874" height="1604" data-path="images/serviceaccounts.png" />

Next, open the project settings in Gleap, select "Push Notifications", and upload the `serviceAccountKey.json` file. Finally, save your configuration.

<img src="https://mintcdn.com/gleap-1d346ffa/b8_EVsZHbtxdB2pN/images/pushnotificationsconfig.png?fit=max&auto=format&n=b8_EVsZHbtxdB2pN&q=85&s=a8df60c3781a4df7cc343b1e38492762" alt="Gleap Push Notifications Setup" width="2710" height="1180" data-path="images/pushnotificationsconfig.png" />

## Subscribe to the Gleap user topic

The last step to complete the push notification setup is to subscribe to the user topic, which Gleap will send the push notifications to.

First, in order to proceed, it is necessary to obtain the registration token from Firebase. For more detailed information, please refer to the documentation provided by Firebase <a href="https://firebase.google.com/docs/cloud-messaging/js/client" target="_blank">here</a>.

```js theme={null}
const token = await getToken(messaging, {
  vapidKey: "<YOUR_VAPID_KEY>",
  serviceWorkerRegistration,
});
```

Next, it is important to register the callbacks for subscribing and unsubscribing from push message topics.

```js theme={null}
Gleap.on("unregister-pushmessage-group", (topic) => {
  // TODO: Send topic to your server
});

Gleap.on("register-pushmessage-group", (topic) => {
  // TODO: Send topic to your server
});
```

Once you have obtained both the Firebase registration token and the Gleap topic, you should send this information to your server. On your server, you will need to subscribe the topic to the token. For more detailed information, please refer to the documentation provided by Firebase <a href="https://firebase.google.com/docs/cloud-messaging/js/topic-messaging" target="_blank">here</a>.

```js theme={null}
firebaseAdmin.messaging().subscribeToTopic(token, topic);
```

That's it - build and run your app 🚀
