The Notifications tab of Settings controls per-user alerts. Both alerts fire only on a handoff event — not on every new conversation.

Where to find it

/app/settings/notifications. Settings

+ settings sub-nav; the Notifications tab is active.

The card

• Title: Notifications
• Description: "Get alerted when a conversation is handed off to a human agent."

Two toggles (and one conditional button) live inside.

Desktop notifications

• Label: Desktop notifications
• Body: "Get a system notification even when this tab is in the background."
• Permission line: "Browser permission: {label}" — one of four values depending on Notification.permission:

Browser state	Label shown	Color
granted	Allowed	green
denied	Blocked by browser	red
default	Not requested yet	muted
unsupported (no Notification API)	Not supported	muted

• Enable checkbox — disabled unless the browser permission is granted.
• Enable browser notifications button (outline) — shown only when the browser state is not granted and not unsupported. Clicking it:
  • If already granted: just flips the in-form preference to true.
  • If denied: shows an alert() saying "Your browser has blocked notifications for this site. Please enable them in your browser settings." — browser-level setting is the only way out.
  • Otherwise: calls Notification.requestPermission(); if the result is granted, the preference flips to true automatically.

Sound alert

• Label: Sound alert
• Body: "Play a short chime when a handoff arrives."
• Enable checkbox — always interactive, no browser gate.

Saving

Submit button: Save preferences. Flips to "Saving..." during the request. Submits PUT /app/settings/notifications.

Defaults on first load (when the backend hasn't returned any notification_settings): both preferences are true.

What triggers these notifications

Verified from the card's subtitle in the UI: both alerts fire only on handoff events — the moment a conversation transitions to handed_off. New messages, new conversations, training completions, etc. don't trigger notifications from this settings page.

Related

• Human handoff — the source of these events
• Replying as an agent — what to do once you're notified