Notification Preferences
Each user can configure which notification types appear in the bell, which go to email, and which generate browser push notifications. Do-not-disturb hours suppress in-app toasts during specified periods.
Per-Type Channel Configuration
Open Settings > Notification Preferences in WorkDesk to configure your preferences:
Do-Not-Disturb (DND)
DND hours suppress browser toast notifications and browser push notifications. Bell notifications are still created and counted — they appear when the user opens the panel after DND ends. Email notifications are also suppressed during DND unless marked priority: urgent.
// DND configuration example
{
"dnd": {
"enabled": true,
"startTime": "18:00", // 6 PM local time
"endTime": "08:00", // 8 AM local time
"timezone": "America/New_York",
"overrideForUrgent": true // urgent notifications bypass DND
}
}Preferences API
// Get current preferences
GET /api/workdesk/notifications/preferences
Authorization: Bearer {token}
// Response
{
"typePreferences": {
"hil_task_assigned": { "bell": true, "email": true, "push": true },
"workflow_completed": { "bell": true, "email": false, "push": false },
"hil_task_overdue": { "bell": true, "email": true, "push": true },
"system_alert": { "bell": true, "email": true, "push": false }
},
"dnd": {
"enabled": true,
"startTime": "18:00",
"endTime": "08:00",
"timezone": "America/New_York",
"overrideForUrgent": true
},
"emailAddress": "alice@acme.com"
}
// Update preferences
PUT /api/workdesk/notifications/preferences
Content-Type: application/json
{ /* same shape as response */ }Administrators can lock certain notification types and channels. For example, an admin may require that hil_task_overdue always sends email and cannot be turned off. Locked channels appear grayed out in the preferences UI with a lock icon.
Browser Push Notification Setup
Browser push notifications require the user to grant permission when first prompted. If permission was denied, a banner in the preferences page explains how to re-enable it in browser settings. Push notifications work even when the WorkDesk tab is not in the foreground.