User Guide
Setup Firebase
Firebase acts as the backend for sending push notifications. Setting up Firebase properly ensures your notifications reach your users reliably.
Create Firebase Project
Follow the instruction to create a new Firebase project.If Firebase is already set up, skip toSetup Firebase Project > Step 6: Download FCM Service Account Key (JSON).
Things to Prepare
(iOS Only) You’ll need your APNs Key (a.p8 file provided by Apple) to enable push notifications for iOS devices. Save it securely on your local machine.
How to Generate APNs Auth Token (.p8 file):
(skip if you already setup firebase)
How to Generate APNs Auth Token (.p8 file):
(skip if you already setup firebase)
- Log in to Apple Developer Center.
- Go to Certificates, Identifiers & Profiles.
- Select Keys from the sidebar, then click the + (plus) button to create a new key.
- Enter a key name (e.g., “Push Notifications”) and check the Apple Push Notifications service (APNs) option.
- Click Continue, then review and confirm your choices.
- Click Register and download your
.p8file immediately. Store this file securely, as you will need it in Firebase setup.
Setup Firebase Project
1. Signup to Firebase
1. Signup to Firebase
Sign up or log into your Firebase Console
2. Create a Firebase Project
2. Create a Firebase Project
Click Add project and follow the on-screen instructions. Your project organizes your app’s notification capabilities.
3. Add App to the Project
3. Add App to the Project
- Navigate to your Project Overview and select Add app.
- Register your app using your iOS Bundle ID or Android Package Name.
4. Upload APNs .p8 file (for iOS)
4. Upload APNs .p8 file (for iOS)
- Uploading this file authorizes Firebase to send notifications via Apple servers.
- Go to Project settings > Cloud Messaging and upload your
.p8file.
5. Download FCM Service Account Key (JSON)
5. Download FCM Service Account Key (JSON)
- In the Project Setting, navigate to Service Accounts.
- Locate the Firebase Admin SDK service account.
- Click Generate new private key, then click Create.
- This will download a
.jsonprivate key file. Keep it secure, and upload it to the Clix console in the next step.
6. Upload Firebase JSON to Clix Console
6. Upload Firebase JSON to Clix Console
Upload the downloaded Firebase service account JSON file to the Clix console > Settings > General > Push Notification Sender Config.
7-1. Add GoogleService-Info.plist to Xcode Project (for iOS)
7-1. Add GoogleService-Info.plist to Xcode Project (for iOS)
- In the Project Setting > General, select the registered app on the ‘Your apps’ list.
- Download this file from Firebase Console.
- Add it to your project’s root directory in Xcode.
7-2. Add google-services.json to Android Project (for Android)
7-2. Add google-services.json to Android Project (for Android)
- In the Project Setting > General, select the registered app on the ‘Your apps’ list.
- Download this file from Firebase Console.
- Add it to your project’s root directory in Android project.