SEND FIREBASE CLOUD MESSAGES (FCM) TO YOUR DESIRED ANDROID USERS USING NODE JS SERVER
SEND FIREBASE CLOUD MESSAGES (FCM) TO YOUR DESIRED ANDROID USERS USING NODE JS SERVER
Architecture:
As the figure says, we will send notification messages from our android set to our own server (say Node js web app). In the Node js web app we implemented the admin sdk of Firebase Cloud messaging (FCM) server. The Nodejs web app communicates with the firebase cloud server using its app credentials. The FCM (Firebase Cloud Messaging) server now serve the users of defined categories.
[This article should be read as the appended section of SEND YOUR FIRST ANDROID NOTIFICATION USING FCM (Firebase Cloud Messaging)]
1. In your Firebase console go to Project Settings>Service Accounts
2. In the Service Accounts window click Generate New Private Key. Then in the confirmation window click Generate Key.
3. The Google Credential json file will be downloaded to the downloads folder of the browser.
Keep this file safe.
4. We need to put this file in the project root of our Node js web app.
5. SETUP THE NODEJS WEB SERVER
Now install firebase admin sdk in our server.
In my case my server is an apache shared server. I have node js setup tool in it.
(i) first create a folder in my shared server root directory. Under it I will create my base directory for my nodejs web app.
(ii) it is better to create a demo app in our local WAMP or LAMP server with npm init.
(iii) the main app.js file along with package.json will be created there.
(iv) now upload this app.js along with package.json to our shared server base directory.
(v) Now go to nodejs setup.
(vi) specify Node js app root directory in Application root.
And put the application url.
(vii) Application startup file(app,js) & log file
(viii) click on Edit under Run NPM Install.
(ix) Here enter in the dependency section the firbase-admin as following:
"firebase-admin": ""
(x) Now install packages by clicking Run NPM Install.
(xi) After successful installation open app.js and add the following code in app.js file:
var express = require('express')
var admin = require("firebase-admin");
const port = 2388;
app.get('/', (req,res)=>{
res.status(200).send("Hello World")
})
app.listen(port, () =>{
console.log("listening to port"+port);
})
(xii) Save app.js and restart the web app from Node js setup.
(xiii) Setup the subdomain for your web app. Make https redirect to it. (xiv) Now in the browser test your web app by typing your (sub)domain name.
This will show now Hello World on the browser.
It proves that our web app setup is correct and working.
6. Now we have Google Credential json file containing firebase keys stored in the base directory of our web app.
7. Now inside the app.js add the following code to initialize the Firebase Admin SDK for messaging.
var admin = require("firebase-admin");
var serviceAccount = require("./myTopic-firebase-msg.json");
admin.initializeApp({
credential: admin.credential.cert(serviceAccount),
databaseURL: "htts://your-firebase-database.firebaseio.com"
})
Here myTopic-firebase-msg.json is the json file I downloaded in the step 3 and renamed it. I put this file in web app’s base directory.
Also the initialization requires a database url to the realtime database (rtdc) of your Firebase Account (You will get it from Real Time Database section on your Firebase console).
8. Further put a module like below to accept request from the messaging app that controls the notification to all users.
app.post('/firebase/notification', (req, res)=>{
var topic;
var title;
var message;
var body = [];
req.on('error', (error)=>{
console.log(error);
}).on('data', (chunk)=>{
body.push(chunk);
}).on('end', ()=>{
body = Buffer.concat(body).toString();
res.on('error', (err)=>{
console.error('Error Occured :'+err);
});
var json = JSON.parse(body);
topic = json.topic
title = json.title
message = json.body
const messaging = admin.messaging();
var payload = {
notification: {
title: title,
body: message
}
};
messaging.sendToTopic(topic, payload)
.then(result=>{
Console.log('The response: '+result)
});
res.send('Its OK..');
res.end();
})
})
Here be careful to construct the right payload with notification and topic. This payload will reach to the end users.
9. Now save the app.js file. Restart the Node js web app from nodejs setup.
10. Now make the following changes in our message sending android app:
In your MyActivity do the following changes:
Send the three strings: topic, title & body in the form of json string to your server (https://yourdaomain.com/firebase/notification) as an http post request.
Here the field "topic" is the topicname of the notification. The field "title" is the title of the notification and the field "body" is our message body.
Sample fields are as following:
String topic = "urgent";
String title = "Test Notification";
String body = "Meeting called at 8:30 pm";
//We have to send these as a JSON string as http POST request to our Node js server.
11. In the user’s client Android app keep the FrebaseMessageReceiver class unchanged. (This class we created earlier in the previous section -SEND YOUR FIRST ANDROID NOTIFICATION USING FCM).
Also, In the main launcher activity onCreate method must add the following code to subscribe the user for definite topic.
Note:
12. This change in user’s client android app will enable it to receive FCM messages based on its subscribed topic.
Now Install client android app in user’s device and install the sender app to your device. On clicking the button on sender app push notification will be served to those user’s app who have subscribed to topic “urgent” (as I have mentioned “urgent” as the topic in query string (QString) in my sender’s app. This query string is collected by our nodejs web app and extracts the topic from this query.).
FURTHER READING: HANDLING RECEIVING OF FCM MESSAGES IN ANDROID IN EFFICIENT MANNER.
Next Read: SEND FIREBASE NOTIFICATION USING NODE JS TO ANDROID – FURTHER READING