[F/OS] FCM Notification Sender [V1.0.0]

Extensions
, ,
1

Firebase-Cloud-Messaging

Firebase Cloud Messaging sender extension. Developed by Hridoy.

:memo: Specifications

  • :package: Package: com.hridoy.fcmsender
  • :floppy_disk: Size: 15.05 KB
  • :gear: Version: 1.0.0
  • :mobile_phone: Minimum API Level: 14
  • :date: Updated On: 26-05-2026 SAST
  • :laptop: Built Using: FAST v6.1.0

All Blocks

blocks
blocks1300×1525 140 KB

Methods (12)

1. Initialize

Initialize

Initialize the sender with your server URL and secret key. Call this once at app startup.

  • serverUrl: full URL to deployed web-app.
  • secretKey: must match SECRET_KEY in your script.
Parameter Type
serverUrl text
secretKey text

2. SendDataToTopic

SendDataToTopic
SendDataToTopic302×105 6.1 KB

Sends a data-only message to all devices subscribed to a topic.
No notification is shown automatically — the app handles display.
Delivered to MessageReceived event on all subscribed devices.

Parameters:

  • topic — FCM topic name (without /topics/ prefix)
  • data — Dictionary of key-value pairs
  • callback — procedure(success, messageId, error)
Parameter Type
topic text
data dictionary
callback any

3. SendDataToToken

SendDataToToken
SendDataToToken307×105 6.09 KB

Sends a data-only message to a single device token.
No notification is shown automatically — the app handles display.
Delivered to MessageReceived event on the target device.

Parameters:

  • token — FCM registration token of target device
  • data — Dictionary of key-value pairs
  • callback — procedure(success, messageId, error)
Parameter Type
token text
data dictionary
callback any

4. SendDataToMultipleTokens

SendDataToMultipleTokens
SendDataToMultipleTokens366×105 7.2 KB

Sends a data-only message to multiple device tokens (up to 500).
No notification is shown automatically — the app handles display.
Delivered to MessageReceived event on each target device.

Parameters:

  • tokens — List of FCM registration token strings
  • data — Dictionary of key-value pairs
  • callback — procedure(success, messageId, error)
    messageId contains summary e.g. '5/5 sent'
Parameter Type
tokens list
data dictionary
callback any

5. SendNotificationToTopic

SendNotificationToTopic
SendNotificationToTopic345×155 9.85 KB

Sends a notification message to all devices subscribed to a topic.
Notification is built and shown by the receiver extension.
Delivered to NotificationReceived event on all subscribed devices.

Parameters:

  • topic — FCM topic name (without /topics/ prefix)
  • smallIcon — Small icon for status bar (Full HTTPS image URL or image in asset)
  • notificationStyle — Notification style (basic, big text, big picture, individual/group message)
  • extraData — Dictionary of extra key-value pairs
  • callback — procedure(success, messageId, error)
Parameter Type
topic text
smallIcon text
notificationStyle dictionary
extraData dictionary
callback any

6. SendNotificationToToken

SendNotificationToToken
SendNotificationToToken349×155 9.82 KB

Sends a notification to a single device token.
Notification is built and shown by the receiver extension.
Delivered to NotificationReceived event on the target device.

Parameters:

  • token — FCM registration token of target device
  • smallIcon — Small icon for status bar (Full HTTPS image URL or image in asset)
  • notificationStyle — Notification style (basic, big text, big picture, individual/group message)
  • extraData — Dictionary of extra key-value pairs
  • callback — procedure(success, messageId, error)
Parameter Type
token text
smallIcon text
notificationStyle dictionary
extraData dictionary
callback any

7. SendNotificationToMultipleTokens

SendNotificationToMultipleTokens
SendNotificationToMultipleTokens408×155 10.9 KB

Sends a notification to multiple device tokens (up to 500).
Notification is built and shown by the receiver extension on each device.
Delivered to NotificationReceived event on each target device.

Parameters:

  • tokens — List of FCM registration token strings
  • smallIcon — Small icon for status bar (Full HTTPS image URL or image in asset)
  • notificationStyle — Notification style (basic, big text, big picture, individual/group message)
  • extraData — Dictionary of extra key-value pairs
  • callback — procedure(success, messageId, error)
Parameter Type
tokens list
smallIcon text
notificationStyle dictionary
extraData dictionary
callback any

8. CreateBasicStyle

CreateBasicStyle

Creates a basic notification style dictionary configuration payload.

  • Return type: dictionary
Parameter Type
title text
body text

9. CreateBigTextStyle

CreateBigTextStyle

Creates an expanded big text style dictionary configuration payload.

  • Return type: dictionary
Parameter Type
title text
body text

10. CreateBigPictureStyle

CreateBigPictureStyle
CreateBigPictureStyle336×126 7.78 KB

Creates an expanded big picture style dictionary configuration payload.

  • Return type: dictionary
Parameter Type
title text
body text
largeIcon text
bigPicture text

11. CreateIndividualMessageStyle

CreateIndividualMessageStyle
CreateIndividualMessageStyle391×126 9.67 KB

Creates an individual 1-on-1 MessagingStyle notification dictionary configuration layout.

  • Return type: dictionary
Parameter Type
personId text
personName text
personIcon text
message text

12. CreateGroupMessageStyle

CreateGroupMessageStyle
CreateGroupMessageStyle369×201 12.7 KB

Creates a persistent group MessagingStyle notification dictionary configuration layout.

  • Return type: dictionary
Parameter Type
groupId text
groupName text
groupIcon text
personId text
personName text
personIcon text
message text
Properties (2)

1. ServerUrl

ServerUrl


![ServerUrl|228x26](upload://r9Wsvwx6zylgJMJPeiwUoc5qpJP.png)

Deployed web app url of google app-script

  • Input type: text

2. SecretKey

SecretKey


![SecretKey|234x26](upload://jKyO6ZMNHqO3gz88zzA1Bwzzprb.png)

Secret key that matches SECRET_KEY in your script

  • Input type: text

Usage

:police_car_light: Important Step

This extension is not operational without a configured Google Apps Script backend.

You must complete the server setup before invoking any functionality.

Official Server Setup Documentation:

SendNotificationToTopic_IndividualMessageStyle
SendNotificationToTopic_IndividualMessageStyle2120×930 136 KB



SendNotificationToTopic_GroupMessageStyle
SendNotificationToTopic_GroupMessageStyle2160×1098 296 KB



SendNotificationToTopic_BigTextStyle
SendNotificationToTopic_BigTextStyle2034×818 115 KB



SendNotificationToTopic_BigPictureStyle
SendNotificationToTopic_BigPictureStyle2108×930 144 KB



SendNotificationToTopic_BasicStyle
SendNotificationToTopic_BasicStyle2012×818 114 KB



SendDataToTopic
SendDataToTopic1528×322 40.7 KB



SendDataToToken
SendDataToToken1538×322 38.6 KB



SendDataToMultipleTokens
SendDataToMultipleTokens1654×378 45.7 KB


Demo: (Only for FCM Receiver)

Download

Open Source

3 Likes
[F/OS] FCM - Firebase Cloud Messaging [v2.0.0]