Skip to main content

Do not disturb overview

The Chat SDK supports fine-grained, multi-level do-not-disturb (DND) settings. Configure DND at different levels to control when and how users receive push notifications.

DND configuration levels

The service supports DND settings at multiple levels. When evaluating whether to send a push notification, the server checks settings in the following priority order (highest to lowest):

  1. User-level settings — Per-user DND configuration
  2. Community subchannel default — Default DND for a specific community subchannel
  3. Community channel default — Default DND for a specific community channel
  4. App Key-level settings — Global DND default for the entire app
LevelScopeClient APIServer API
App Key-levelDirect, Group, CommunityNot availableNot available (contact support)
Community channel defaultCommunity channels onlySet community/subchannel default DNDDND overview
Community subchannel defaultCommunity channels onlySet community/subchannel default DNDDND overview
User-levelDirect, Group, CommunitySee belowSet DND

User-level DND settings (highest to lowest priority)

  1. Global DND time window — Set a recurring daily time window during which all notifications are suppressed. Not available on Web (applies to mobile only).
  2. Per-subchannel DND (community only) — See Set community subchannel DND.
  3. Per-channel DND — See Set channel DND.
info

Web does not receive push notifications directly. DND settings configured from the Web SDK affect push behavior on mobile devices.