Notifications
Desktop and sound alerts that fire when a conversation is handed off to a human agent.
The Notifications tab of Settings controls per-user alerts. Both alerts fire only when a conversation is handed off — not on every new conversation.
Where to find it
Open /app/settings/notifications. Same Settings header and sub-nav as the other settings pages, with the Notifications tab 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."
- A permission line reads "Browser permission: [status]", where the status is one of:
| Browser state | Label shown | Color |
|---|---|---|
| Allowed | Allowed | green |
| Blocked | Blocked by browser | red |
| Not asked yet | Not requested yet | muted |
| Unsupported browser | Not supported | muted |
- Enable checkbox — disabled unless the browser has granted permission.
-
Enable browser notifications button (outline) — shown only when the browser has not granted permission yet and your browser does support notifications. Clicking it:
- If permission is already granted, just turns the preference on.
- If permission has been blocked, an alert appears: "Your browser has blocked notifications for this site. Please enable them in your browser settings." You have to fix this in your browser — there's no way around it from inside the app.
- Otherwise, it asks the browser for permission. If you click Allow, the preference turns on automatically.
Sound alert
- Label: Sound alert
- Body: "Play a short chime when a handoff arrives."
- Enable checkbox — always interactive, no browser permission needed.
Saving
Submit button: Save preferences. Flips to "Saving..." while saving.
Defaults on first load: both preferences are on.
What triggers these notifications
Both alerts fire only when a conversation is handed off to a human agent. New messages, new conversations, training completions, and so on 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