Notification Sounds

Notification Sounds let you customize the audio that plays when your agent session changes state — for example, when a long-running task completes or when an error occurs. Upload your own audio files or use built-in tones, and configure which sound plays for which event.

Scopes

Sounds operate at two visibility levels:

Scope	Who can use it	Who can manage it
Personal	Only you	Only you
Team	All team members	Team owners and moderators

Team sounds are great for shared alert tones — for example, a distinctive sound for CI/CD failures that the whole team recognizes. Personal sounds let each member customize their own notification experience.

Supported Formats

Format	MIME Type
AAC	`audio/aac`
MP3	`audio/mpeg`, `audio/mp3`
WAV	`audio/wav`
OGG	`audio/ogg`
M4A	`audio/mp4`, `audio/x-m4a`
WebM	`audio/webm`

File extensions: .aac, .mp3, .wav, .ogg, .m4a, .webm

Configuring Sounds

Open the Sound Settings dialog from the agent chat toolbar (![speaker icon]). The dialog has two tabs:

Events Tab

Configure which sound plays for each agent session event:

Event	When it fires
Session idle	Agent completes a task and returns to idle, waiting for your next prompt
Session error	Agent encounters an unrecoverable error or a task fails

For each event, you can:

Enable/disable the sound notification entirely
Choose a sound from built-in tones, your personal uploads, or team uploads
Preview the sound by clicking the Play button

A master volume slider controls the overall notification volume independent of your system volume.

Uploads Tab

Manage your audio files:

Action	Description
Upload (Personal)	Click the upload area or drag-and-drop an audio file. It uploads directly to secure cloud storage.
Upload (Team)	Same as personal, but the sound becomes available to all team members. Requires owner or moderator role.
Delete	Remove a sound permanently. Team sound deletion requires owner or moderator role.

How It Works

Agent Session Event
        │
        ▼
  Event Matcher (idle / error)
        │
        ▼
  Look up configured sound
        │
    ┌───┴───┐
    │ Enabled? │
    └───┬───┘
    No  │  Yes
    ▼   │   ▼
  Skip  │ Fetch audio URL
        │   │
        │   ▼
        │ Play via Web Audio API
        │   │
        │   ▼
        │ Browser notification
        │ (if also enabled)

Sounds play through the browser's Web Audio API — no external player needed. They fire alongside browser notifications (if enabled), so you get both audio and visual alerts.

Access Control

Action	Required Role
List team sounds	Team member
Upload team sound	Owner or Moderator
Delete team sound	Owner or Moderator
List/upload/delete personal sounds	Authenticated user (self)

Next Steps

Teams & Collaboration — Manage team members and roles
Agent Overview — Learn about agent session lifecycle