Server Setup for IM with Google Firebase

How to enable Firebase server on IM App:

Go to Settings in IM App on AdminCP and select "Firebase" at setting Select chat server

Add Firebase Config Object (Required)
Add Algolia App ID (Optional) and Algolia API Key (Optional) to support search messages

Setup Firebase App:

1. Add Firebase project

Go to Firebase console
Select Add Project if you don't have one
Go to App Dashboard, select Project Overview > Project settings
In Your apps section click on icon </> to Add Firebase to web app
Add App nickname, then click Register App, then click Continue to console to back to Project Settings page
In Your Apps section, chose the app you just created, then click on Config and copy all scripts code on it.
Paste to setting Firebase Config Object in IM App.

2. Enable Firebase Database

Back to Firebase App Dashboard, select Develop > Database.
On the section right click on Create Database.
Select mode and click Enable
After enable, you will redirect to database page.
In that page, select tab Indexes and add 2 Composite indexes to Database by click on Create index manually.
Setting like 2 below screenshot:
Indexes enable:
You must enable Sign-in method Email/Password in your project Authentication to allow users access to the database, follow screenshot:
Then, go to Database > Rules tab and set up database rules like:

Now, you can start to use IM App with Firebase.

Setup Algolia to support search messages

Note: Without Algolia configure on IM App, users can only search for messages with prefix and case sensitive.

Go to Algolia App Manage, sign up if you don't have an account
Algolia is pay to use, so you should check their pricing at Algolia Pricing
Go to your app Dashboard
Select Indices, create new Index with name im_chat
After Create Index, select menu API keys on left
Copy Application ID and paste to setting Algolia App ID on IM App
Copy Admin API Key and paste to setting Admin API Key on IM App

Now, users can search full-text messages with IM App and Firebase

Setup Cloud Functions support push notification on Mobile App

Refer tutorial from https://firebase.google.com/docs/functions/get-started

1. Set up Node.js and the Firebase CLI

You'll need a Node.js environment to write functions, and you'll need the Firebase CLI (which also requires Node.js and npm) to deploy functions to the Cloud Functions runtime. From among the supported Node.js versions available for Cloud Functions, we strongly recommend Node.js 8 for getting started. For installing Node.js and npm, Node Version Manager is recommended.

Once you have Node.js and npm installed, install the Firebase CLI via npm:

npm install -g firebase-tools

2. Initialize Firebase SDK for Cloud Functions

Run firebase login to log in via the browser and authenticate the firebase tool.
Go to your Firebase project directory or create a new project folder.
Run firebase init functions. The tool gives you an option to install dependencies with npm. It is safe to decline if you want to manage dependencies in another way.
Select option Javascript for language support

Structure of your project

myproject
 +- .firebaserc    # Hidden file that helps you quickly switch between
 |                 # projects with `firebase use`
 |
 +- firebase.json  # Describes properties for your project
 |
 +- functions/     # Directory containing all your functions code
      |
      +- .eslintrc.json  # Optional file containing rules for JavaScript linting.
      |
      +- package.json  # npm package file describing your Cloud Functions code
      |
      +- index.js      # main source file for your Cloud Functions code
      |
      +- node_modules/ # directory where your dependencies (declared in
                       # package.json) are installed

Edit package.json file, add new module request to dependencies object
```
{
  "name": "functions",
  ....
  "engines": {
    "node": "8"
  },
  "dependencies": {
    .....
    "request": "^2.88.0"
  },
  ....
}
```
Then run cd functions/ && npm install (from project folder) to update project modules.

Edit file functions/index.js and replace the content with following source codes

const functions = require('firebase-functions')
const admin = require('firebase-admin')
const request = require('request')

admin.initializeApp()

const firestore = admin.firestore()

exports.sendPushNotification = functions.firestore.document(
  'rooms/{roomId}/messages/{messageId}').onCreate(event => {
  const writeData = event.data()
  const sender = writeData.sender
  const recipient = writeData.receiver
  if (!writeData.sender_id || !writeData.server_key) {
    return false
  }
  const notifyTo = {
    recipient: recipient,
    sender_id: writeData.sender_id,
    server_key: writeData.server_key
  }
  let payload = {}
  firestore.doc('users/' + sender).get().then(doc => {
    const senderData = doc.data()
    payload = {
      notification: {
        title: senderData.name,
        body: writeData.text ? writeData.text : '[FILE]',
        sound: 'default'
      },
      data: {
        resource_link: 'chat/' + senderData.id,
        web_link: 'chat/' + senderData.id
      }
    }
    return getTokenToSend(payload, notifyTo)
  }).catch(e => console.warn(e))
  return true
})

function getTokenToSend (payload, notifyTo) {
  const recipientId = Buffer.from(notifyTo.recipient, 'base64').
    toString('ascii')
  const notificationKeyName = 'user-' + recipientId
  return getNotificationKey({
    senderId: notifyTo.sender_id,
    serverKey: notifyTo.server_key
  }, notificationKeyName).
    then(notificationKey => admin.messaging().
      sendToDeviceGroup(notificationKey, payload))
}

function getNotificationKey (options, notificationTokenName) {
  return new Promise((resolve, reject) => {
    request({
      url: 'https://fcm.googleapis.com/fcm/notification',
      method: 'GET',
      json: true,
      headers: {
        Authorization: 'key=' + options.serverKey,
        project_id: options.senderId,
        'Content-Type': 'application/json'
      },
      qs: { notification_key_name: notificationTokenName }
    }, (error, httpResponse, body) => {
      if (!error && body.notification_key) {
        resolve(body.notification_key)
      } else {
        reject(error || body)
      }
    })
  })
}

At least run firebase deploy --only functions from the project folder to deploy.

Now users can get notifications on Mobile App when chatting with Firebase.

Page tree