Push notification preferences

By registering or unregistering the current user's registration token to the Sendbird server as below, you can turn push notifications on or off in the user's app. The registration and unregistration methods in the code below should be called after a user has established a connection with the Sendbird server via the connect() method.

Through setPushTriggerOption() and setMyPushTriggerOption(), the current user can set which message can trigger a push notification or completely turn it off as well. Besides, they can enable the Do Not Disturb (DND) and snooze features through setDoNotDisturb() and setSnoozePeriod() methods.

Note: Push notifications are only supported in group channels.

JavaScriptTypeScript

const setPushNotification = (enable, os) => {
    if (enable) {
        if (os === 'ios') {
            await sb.registerAPNSPushTokenForCurrentUser(TOKEN);
        } else {
            await sb.registerFCMPushTokenForCurrentUser(TOKEN);
        }
    } else {
        if (os === 'ios') {
            await sb.unregisterAPNSPushTokenForCurrentUser(TOKEN);
        } else {
            await sb.unregisterFCMPushTokenForCurrentUser(TOKEN);
        }
    }
}

Push trigger options allow users to configure when to receive notification messages as well as what type of messages will trigger notification messages on the application level. The following three options are provided.

List of push trigger options

Option	Description
all	When disconnected from the Sendbird server, the current user receives notifications for all new messages including messages the user has been mentioned in.
mention_only	When disconnected from the Sendbird server, the current user only receives notifications for messages the user has been mentioned in.
off	The current user doesn't receive any notifications.

JavaScriptTypeScript

await sb.setPushTriggerOption('mention_only');

Push trigger options for channel also allow users to configure the trigger for notification messages as well as turn notifications on or off for each group channel. The following four options are provided.

List of push trigger options for channel

Option	Description
default	The current user’s push notification trigger settings are automatically applied to the channel. This is the default setting.
all	When disconnected from the Sendbird server, the current user receives notifications for all new messages in the channel including messages the user has been mentioned in.
mention_only	When disconnected from the Sendbird server, the current user only receives notifications for messages in the channel the user has been mentioned in.
off	The current user doesn't receive any notifications in the channel.

JavaScriptTypeScript

await groupChannel.setMyPushTriggerOption('default');

Do not disturb

If you want to routinely turn off push notification on the current user's client app according to a specified schedule, use our Do Not Disturb feature like the following.

Note: Do Not Disturb can also be set for a user with our platform API's update push preferences action.

JavaScriptTypeScript

await sb.setDoNotDisturb(true, START_HOUR, START_MIN, END_HOUR, END_MIN, 'Asia/Seoul');

Snooze

To snooze notification messages for a specific period of time, use our snooze feature like the following.

Note: snooze can also be set for a user with our platform API's update push preferences action.

JavaScriptTypeScript

await sb.setSnoozePeriod(true, START_TS, END_TS);

On this page

Do not disturb Snooze

Sample app