Managing Notifications

Detailed in this page is how you can manage in-app notifications for new in-app chat messages for your React Native apps.

Push Notifications

In order to enable Push Notifications on React Native, please make sure to follow the steps for each platform's individual steps.

iOS

In order to enable push notifications on iOS, you will need to follow the steps here.

Please note that calling Replies.didReceiveRemoteNotification(notification) in your application:didFinishLaunchingWithOptions: to check whether this is an Luciq notification will not work in iOS due to a known limitation; an alternative solution would be to manually check if the key LCQHost exists in the payload, which flags it as an Luciq notification.

Android

Start Receiving Push Notifications

To allow us to send push notifications to your app, you will need to configure your Firebase Cloud Messaging (FCM) Server Key on our Dashboard by navigating to Settings -> Push Notifications and setting the API_KEY field.

Once that's done, you can start receiving push notifications by passing the registration token to our SDK:

JavaScript

Replies.setPushNotificationRegistrationTokenAndroid('TOKEN');

When a background notification is received, you can pass it to the SDK in order to display the notification:

JavaScript

Replies.showNotificationAndroid(data);

Configure Channels

You can use channels to group the incoming Luciq notifications into a manageable group. To do this, pass the channel ID to the API below:

JavaScript

Replies.setPushNotificationChannelIdAndroid('CHANNEL_ID');

Change Notification Icon

The icon that is shown with each push notification can be changed to match your application's icon. Use the API below to change this icon:

JavaScript

Replies.setNotificationIconAndroid(ICON);

Enabling/Disabling Push Notifications

Push Notifications are enabled by default, but they can be turned on and off via the following API:

JavaScript

// Enable
Replies.setPushNotificationsEnabled(true);

// Disable
Replies.setPushNotificationsEnabled(false);

In-App Notifications

By default, a notification will be shown on top of your app's UI when a new message is received.

Disabling In-App Notifications

Use the following method to disable notifications that appear in-app.

React Native

Replies.setInAppNotificationsEnabled(false);

In-App Notification Sound

When your app users receive an in-app notification through Luciq, sound is enabled by default. You can disable it by using the following method.

JavaScript

Replies.setInAppNotificationSound(false);

Get Unread Messages Count

You can use the following method to get the number of messages the user has yet to read.

JavaScript

const unreadRepliesCount = await Replies.getUnreadRepliesCount();