Push Notifications

• Offline messages. Send a chat message when a recipient is offline. In this case, a push notification will be sent automatically if the user is offline.
• Offline calls. Make a video/audio call with offline opponents. In this case, a push notification will be sent manually.
• Requests to contact list. Send requests to add a user to the contact list. In this case, a push notification will be sent manually).
• User tags. Send notifications to specific user groups defined by tags.

​

Before you begin

1. Register a QuickBlox account. This is a matter of a few minutes and you will be able to use this account to build your apps.
2. Configure QuickBlox SDK for your app. Check out Setup page for more details.
3. Create a user session to be able to use QuickBlox functionality. See Authentication page to learn how to do it.

​

Configuration

​

iOS

1. Open Xcode and choose your project file.
2. Choose the Signing & Capabilities tab.
3. Add a Push Notifications and Background Modes capabilities. To see these sections, you should be logged in to Xcode with your Apple ID that is enrolled in the Apple developer program.
4. Turn on a Push Notifications capability.
5. Turn on a Background modes capability. This section requires you to add specific app permissions.
6. Select a Remote notifications checkbox if you want to receive push notifications when the app goes to background mode.
7. Select a Voice over IP checkbox if you want your app to receive incoming Voice-over-IP (VoIP) push notifications and use them to display the system call interface to the user when the app is in the background mode.

​

Android

1. Open the Firebase console and select your project.
2. Go to Project settings > Service Accounts.
3. Click on Generate new private key and confirm by clicking Generate key.
4. Securely store the JSON file containing the private key that will be downloaded

1. Head over to QuickBlox dashboard, and choose your application.
2. Select the push notifications tab and navigate to the settings page.
3. Select the Service account key tab

1. Choose the environment for your service account key. (Development/Production)
2. Click on the Browse button and select the JSON file containing the key that was downloaded in Step 2.
3. Hit the Upload button.

1. As part of enabling Firebase services in your Android application, you need to add the google-services dependency to your project-level build.gradle file.

buildscript {

    // ...

    dependencies {
        // ...
        classpath 'com.google.gms:google-services:4.4.2'
    }
}

2. Add FCM dependency to your app level build.gradle file.

implementation(platform("com.google.firebase:firebase-bom:33.4.0"))

3. Include a gms plugin to your app level build.gradle file.

apply plugin: 'com.google.gms.google-services'

4. Download the google-services.json file from your Firebase Project dashboard and put it into your app folder in your Android project.

​

Subscribe to push notifications

//Push Channels
//QBPushChannelNames.GCM;
//QBPushChannelNames.APNS;
//QBPushChannelNames.APNS_VOIP;
//QBPushChannelNames.EMAIL;

String channelName = "";
String? token  = "";
try {
  if (Platform.isAndroid) {
    token = await FirebaseMessaging.instance.getToken();
    channelName = QBPushChannelNames.GCM;
  } else if (Platform.isIOS) {
    token = await FirebaseMessaging.instance.getAPNSToken();
    channelName = QBPushChannelNames.APNS;
  }
  await QB.subscriptions.create(token!,channelName);
} on PlatformException catch (e) {
  // Some error occurred, look at the exception message for more detai
}

​

Send push notifications

//Event Types
//QBNotificationEventTypes.FIXED_DATE;
//QBNotificationEventTypes.PERIOD_DATE;
//QBNotificationEventTypes.ONE_SHOT;

//Notification Event Types
//QBNotificationTypes.PUSH;
//QBNotificationTypes.EMAIL;

//Notification Push Types
//QBNotificationPushTypes.APNS
//QBNotificationPushTypes.APNS_VOIP
//QBNotificationPushTypes.GCM
//QBNotificationPushTypes.MPNS

String eventType = QBNotificationEventTypes.ONE_SHOT;
String notificationEventType = QBNotificationTypes.PUSH;
int pushType = QBNotificationPushTypes.APNS_VOIP;
int senderId = 329873;

Map<String, Object> payload = new Map();
payload["message"] = "test";

try {
  List<QBEvent?  events = await QB.events.create(eventType, notificationEventType, senderId, payload, pushType: pushType);
} on PlatformException catch (e) {
  // Some error occurred, look at the exception message for more details
}

​

Recieve push notifications

FirebaseMessaging.onMessage.listen((message) {
  AndroidNotificationChannel channel = const AndroidNotificationChannel("channel_id", "some_title", "some_description",
  importance: Importance.high);

  AndroidNotificationDetails details = AndroidNotificationDetails(channel.id, channel.name, channel.description,
  icon: "launch_background");

  FlutterLocalNotificationsPlugin plugin = FlutterLocalNotificationsPlugin();

  int id = message.hashCode;
  String title = "some message title";
  String body = message.data["message"];

  plugin.show(id, title, body, NotificationDetails(android: details));
});

​

Unsubscribe from push notifications

int id = 929988234923;

try {
  await QB.subscriptions.remove(id);
} on PlatformException catch (e) {
  // Some error occurred, look at the exception message for more details
}

​

Troubleshooting

​

A subscription is removed after a push is sent and the push isn’t delivered

1. Some other data is set instead of a correct device registration token. For example, a Firebase project ID, Firebase user token, etc.
2. The client app unregistered itself from GCM/FCM. This can happen if the user uninstalls the application or, on iOS, if the APNs Feedback Service reported the APNs token as invalid.
3. The registration token expired. For example, Google might decide to refresh registration tokens or the APNs token may have expired for iOS devices.
4. The client app was updated, but the new version is not configured to receive messages.