User documentation

⌘K
  1. Home
  2. User documentation
  3. Notification Pack
  4. Push notifications initial configuration

Push notifications initial configuration

Notification Pack add-on allows you to send push notifications in addition to emails and SMS. For this, you must do a small initial configuration. This guide will guide you over each step. First of all:

  • Go to the Booking Activities settings, “Notifications” tab

Further down on the page, you’ll see a “Push Notifications Settings” section with fields that you probably haven’t heard about before: “Google FCM config”, “Google FCM service account private key” and “Google FCM vapid key”. Let’s see how to fill these fields.

⚠ Warning: First, be aware that your site must have a valid and active SSL certificate (its URL must begin with HTTPS) to send push notifications. The URLs of the “Click action”, “Push notification icon” and “Push notification badge” must also be https.

 

Bind FCM to Notification Pack

Notification Pack uses Firebase Cloud Messaging (FCM), the Google notification service, to send push notifications to you and your customers. This service is free, but you still need to register to bind it to your site.

  1. Create your Firebase project
    • Sign in to your FCM console (you must have a Google Account)
    • Click on the “Add project” button
    • Name it as you like (the name of your company for example), choose your country and validate
    • You are now redirected to the homepage (“Overview”) of your project (else, click on “Project Overview” in the left sidebar)
  2. Register your app
    • (If you have already registered apps here, click on “Add app”)
    • In the center of the page, below “Get started by adding Firebase to your app”, click on the “Web” icon (</>)
    • Give your app a name (your website name for example), and click “Register app”
    • Click “Back to console” to go back to the homepage
  3. Google FCM config
    • In the left sidebar, click on the gear () next to “Project Overview”
    • Click “Project settings”
    • Go to the “General” tab, and scroll down to “Your apps” section
    • Click on your app name
    • Under “SDK setup and configuration”, select “Config”, a code will appear (it begins with const firebaseConfig = { apiKey: "...)
    • Copy the given javascript code and paste it in the “Google FCM config” field on your site
  4. Google FCM service account private key
    • In the left sidebar, click on the gear () next to “Project Overview”
    • Click “Project settings”
    • Go to the “Service accounts” tab, and wait for the page to load
    • Click on “Firebase Admin SDK” tab
    • Click the “Generate new private key” button
    • A .json file will be downloaded
    • Open it with a text editor such as Notepad (or TextEdit on mac) (its content begins with { "type": "service_account", "project_id": "...)
      • Tip: You can simply drag and drop the file into your browser to open it in a new tab
    • Copy the content of this file and paste it in the “Google FCM service account private key” field on your site
  5. Google FCM vapid key
    • In the left sidebar, click on the gear () next to “Project Overview”
    • Click “Project settings”
    • Go to the “Cloud Messaging” tab, and scroll down to “Web configuration”
    • Click “Web Push certificates” tab
    • Click “Generate key pair” button if you haven’t already
    • Copy the key in the “Key pair” column value and paste it in the “Google FCM service account private key” field on your site
      • Warning: Make sure to copy the entire key. It has 87 characters.
      • Warning: There is an option to show your private key, you do not need it. What you need is the public key, directly visible in the “Key pair” column.

  6. Save the changes of Booking Activities notifications settings page

Your site is now able to send push notifications. But no one will receive them until you have obtained their explicit agreement, including yourself. Go to the second part of this tutorial to find out how to get permission from your customers and customize your push notifications.

How can we help?