Enabling push notifications, snooze, and Do not disturb in SendBird

Push notifications are essential for keeping users engaged in chats they care most about. Read here to learn about SendBird’s many options for push.

'Helvetica Neue', Helvetica, Arial, sans-serif

SendBird Blog

<p>Push notifications are essential for any app with chat and messaging because users receive messages from people they care about, about topics highly relevant to them, or from interactions they value. Users participate in conversations for good reasons and they don’t want to miss a message. The need for push notifications only increases if a user is responsible for reading and responding to a message as in, for example, work settings.</p>

<p>It is now a common standard to give users options to control when they receive push notifications. In fact, users expect it. As users try to balance the utility of notifications with setting boundaries around them, users now expect to set up “Do not disturb” statuses, snooze notifications, or control when they receive a push notification.&nbsp;</p>
<p>This article describes SendBird’s push notification options and, importantly, references how to implement them in the client and backend using the iOS, Android, Javascript SDKs or Platform API.&nbsp;</p>
<h1>Push notification preferences in SendBird</h1>
<p>SendBird has three categories of options for push notifications:</p>
<ol>
<li>General options for users and channels - these allow your users to control when they receive push notifications</li>
<li>Snooze - allows the user to suspend notifications for a set a period</li>
<li>Do not disturb - allows users to routinely suspend notifications for set periods each day</li>
</ol>
<h3>Push notification preferences, aka ‘Push Trigger Options’</h3>
<p>SendBird allows your users to set preferences for push notifications using two dimensions:&nbsp;</p>
<ul>
<li>User preference</li>
<li>Group channel preference</li>
</ul>
<p>SendBird calls these general options for push notifications, “Push Trigger Options.”</p>
<p>To allow users to configure their own preferences, you can use a SendBird object for Android, the JavaScript SDK, or SBDMain for iOS. This is available in all SDKs since Android SDK 3.0.86, JavaScript SDK 3.0.93, and iOS SDK 3.0.128.&nbsp;</p>
<h3>Push notification preferences for users</h3>
<p>There are three user options available for setting push notification preferences. Note that the SendBird documentation refers to these as <strong>Push Trigger Options</strong>.</p>
<ol>
<li><span style="font-family: 'courier new', courier;">‘all’</span> : User receives push notifications for all new messages while offline, including mentioned messages</li>
<li><span style="font-family: 'courier new', courier;">‘off’</span> : User does not receive any push notifications</li>
<li><span style="font-family: 'courier new', courier;">‘mention_only’</span> : User receives push notifications only for messages in which the user is mentioned</li>
</ol>
<h3>Push notification options for Group Channels</h3>
<p>Please note that options for push notifications are only available in group channels. They are not available for open channels.</p>
<p>There is one additional group channel preference compared to the user preferences described in the last section: <span style="font-family: 'courier new', courier;">default</span>. Note that the SendBird documentation refers to these as <strong>Push Trigger Options</strong>.</p>
<ol>
<li><span style="font-family: 'courier new', courier;">‘all’ </span>: User receives push notifications for all new messages in this channel while offline, including mentioned messages</li>
<li><span style="font-family: 'courier new', courier;">‘off’</span> : User does not receive any push notifications for any messages in this channel</li>
<li><span style="font-family: 'courier new', courier;">‘mention_only’</span> : User receives push notifications only for messages in which the user is mentioned in this channel</li>
<li><span style="font-family: 'courier new', courier;">‘default’</span>: The user’s push notification preferences applies to this channel</li>
</ol>
<h3>References for general push notification options</h3>
<p>The following is a table of references for Push Trigger Options from our iOS, Android, and JavaScript SDKs. Where possible we linked directly to the reference library or indicate the line in the source code.&nbsp;</p>
<p>For iOS,</p>
<p>
<script src="https://gist.github.com/imju/fc5aa28106cba3f9fd3da38ac6c9990e.js"></script>
</p>
<p>For Android,</p>
<p>
<script src="https://gist.github.com/imju/ed6975a25bea033fe231110673c131e7.js"></script>
</p>
<p>For JavaScript,</p>
<p>
<script src="https://gist.github.com/imju/ec3cfceb831a2bd9fde3cfab97e3f0fe.js"></script>
</p>
<p>See our documentation for further reference:&nbsp;</p>
<ul>
<li><a href="https://docs.sendbird.com/ios/push_notifications#3_notification_preferences">iOS</a>&nbsp;</li>
<li><a href="https://docs.sendbird.com/android/push_notifications#3_notification_preferences">Android</a>&nbsp;</li>
<li><a href="https://docs.sendbird.com/javascript/push_notifications#3_notification_preferences">JavaScript</a></li>
<li>Platform API: <a href="https://docs.sendbird.com/android/push_notifications#3_notification_preferences">User</a> | <a href="https://docs.sendbird.com/platform/user#3_update_push_preferences_for_a_channel">Channel</a></li>
</ul>
<h2>Option to snooze push notifications</h2>
<p>In SendBird’s parlance, to ‘Snooze’ push notifications means the user does not receive any notifications for a specific period of time, which has a user-defined start and end. This period does not repeat.&nbsp;</p>
<p>Please note that Snooze is only a user option and <strong>not</strong> a group channel option. A user’s Snooze setting will override any other user or channel push preferences during the Snooze period.</p>
<p>You can enable the option to ‘Snooze’ in the client app or from Platform API. The start- and end-time are in <a href="https://docs.sendbird.com/platform/misc#3_timestamps">Unix Milliseconds</a>, or 13-digit numbers.</p>
<h3>References for snooze</h3>
<p>The following is a table of references for Snooze from our iOS, Android, and JavaScript SDKs. Where possible we linked directly to the reference library or indicate the line in the source code.&nbsp;</p>
<p>For iOS,</p>
<p>
<script src="https://gist.github.com/imju/86b663dfdce72d4da5a972373a005169.js"></script>
</p>
<p>For Android,</p>
<p>
<script src="https://gist.github.com/imju/ac94f8923ffba4e28140e720fb0590d5.js"></script>
</p>
<p>For JavaScript,</p>
<p>
<script src="https://gist.github.com/imju/e1a4b3626c694cdd9407ca711399926c.js"></script>
</p>
<p>See additional references for setting a snooze on notifications:&nbsp;</p>
<ul>
<li><a href="https://docs.sendbird.com/ref/ios/Classes/SBDMain.html#//api/name/setSnoozePeriodEnable:startTimestamp:endTimestamp:completionHandler:">iOS</a></li>
<li><a href="https://docs.sendbird.com/ref/android/com/sendbird/android/SendBird.html#setSnoozePeriod-boolean-long-long-com.sendbird.android.SendBird.SetSnoozePeriodHandler-">Android</a></li>
<li><a href="https://docs.sendbird.com/javascript/push_notifications#3_notification_preferences">JavaScript</a></li>
<li><a href="https://docs.sendbird.com/platform/user#3_update_push_preferences">Platform API</a></li>
</ul>
<h2>Options for ‘Do not disturb’</h2>
<p>In SendBird’s parlance, to set a ‘Do not disturb’ (DND) means that the user routinely does not receive any notifications at certain times of the day. These periods repeat every day.&nbsp;</p>
<p>Note that DND is a user option and <strong>not</strong> an option for group channels. A user’s DND setting will routinely override any user or channel preferences for push notifications during the set period of time.</p>
<p>You can enable DND in the client app or from Platform API. The start- and end-time are expressed as integers: <span style="font-family: 'courier new', courier;">start_hour</span> and <span style="font-family: 'courier new', courier;">start_min</span>, <span style="font-family: 'courier new', courier;">end_hour</span> and <span style="font-family: 'courier new', courier;">end_min</span>.</p>
<h3>References for ‘Do not disturb’</h3>
<p>The following is a table of references for ‘Do not disturb’ from our iOS, Android, and JavaScript SDKs. Where possible we linked directly to the reference library or indicate the line in the source code.</p>
<p>For iOS,</p>
<p>
<script src="https://gist.github.com/imju/a5e88d42085f830d095a8bc750e2f839.js"></script>
</p>
<p>For Android,</p>
<p>
<script src="https://gist.github.com/imju/c1c89195b2fa0458abea2bb326637ffc.js"></script>
</p>
<p>For JavaScript,</p>
<p>
<script src="https://gist.github.com/imju/804bb007f4cf8c7cd99dee29c08c8126.js"></script>
</p>
<p><span style="background-color: transparent;">See our references for setting a ‘Do not disturb’ on notifications:&nbsp;</span></p>
<ul>
<li><a href="https://docs.sendbird.com/ref/ios/Classes/SBDMain.html#//api/name/setDoNotDisturbWithEnable:startHour:startMin:endHour:endMin:timezone:completionHandler:">iOS</a>&nbsp;</li>
<li><a href="https://docs.sendbird.com/ref/android/com/sendbird/android/SendBird.html#setDoNotDisturb-boolean-int-int-int-int-java.lang.String-com.sendbird.android.SendBird.SetDoNotDisturbHandler-">Android</a></li>
<li><a href="https://docs.sendbird.com/javascript/push_notifications#3_notification_preferences">JavaScript</a></li>
<li><a href="https://docs.sendbird.com/platform/user#3_update_push_preferences">Platform API</a></li>
</ul>
<h2>Setting push preferences at the message level</h2>
<p>SendBird also gives you an option to set the push notification preference at the message level.&nbsp;</p>
<p>Both text and file messages have an optional Boolean property, <span style="font-family: 'courier new', courier;">send_push</span>, that allows you to toggle on or off a push notification for a message. It defaults to being on, or True.</p>
<p>You can read more about the <span style="font-family: 'courier new', courier;">send_push</span> optional message property in <a href="https://docs.sendbird.com/platform/messages#3_send_a_message">the Platform API documentation here</a>.</p>
<h2>How SendBird applies notification preferences</h2>
<p>Given many options for notifications, it’s important to understand how the options are applied and what results from the combination of user, group channel, and other options.</p>
<p>Basically, you enable push notification preferences at the message, user, and group channel level. DND and Snooze, if in effect, always supersede Trigger Options (at the user and group channel level).</p>
<p><img src="https://cdn2.hubspot.net/hubfs/3417319/push%20notifications%202.png" alt="push notifications 2" width="1241" style="width: 1241px;"></p>
<p>The following flow chart gives you the permissions hierarchy in granular detail.</p>
<p><img src="https://cdn2.hubspot.net/hubfs/3417319/push%20notifications%201.png" alt="push notifications 1" width="1241" style="width: 1241px;"></p>
<h1>User controls for push notifications are now standard</h1>
<p>Thanks to the proliferation of messenger apps and chat collaboration software, user options for controlling push notifications are now a standard feature, more or less expected by users. SendBird’s SDKs and Platform API enable you to easily build these features for your users and deliver the excellent messaging experience they’ve come to expect.</p>
<p>&nbsp;</p>
<p style="text-align: center;">{{cta('600bf1cb-8bba-43e1-9a53-693854e0b262')}}</p>

<html>
 <head></head>
 <body>
  <p>Push notifications are essential for any app with chat and messaging because users receive messages from people they care about, about topics highly relevant to them, or from interactions they value. Users participate in conversations for good reasons and they don’t want to miss a message. The need for push notifications only increases if a user is responsible for reading and responding to a message as in, for example, work settings.</p> 
 </body>
</html>

https://cdn2.hubspot.net/hubfs/3417319/blogcover_push%20notification.png

<p>Push notifications are essential for any app with chat and messaging because users receive messages from people they care about, about topics highly relevant to them, or from interactions they value. Users participate in conversations for good reasons and they don’t want to miss a message. The need for push notifications only increases if a user is responsible for reading and responding to a message as in, for example, work settings.</p>
