Aysali logo

Notifications

When Settings → Notifications → Sound settings are enabled, Aysali Bot plays a short audio cue when a new message or new conversation arrives — in the admin panel and/or on pages that embed the chat widget, depending on which options you turn on.

The help link on Sound settings points here.

Enable sounds

  1. •

    Open notifications settings

    In the admin panel go to Settings → Notifications → Sound settings.

  2. •

    Enable the right scope

    Turn on Active for the chat widget (visitor-facing pages) and/or Active - admin for the admin area.

  3. •

    Adjust volume and repeat (optional)

    Set Volume / Volume - admin (1–10, or leave Default for the built-in level). Use Repeat / Repeat - admin if you want the alert to play more than once when the tab is in the background.

  4. •

    Save

    Save settings. Agents and visitors must interact with the page once before audio can play (see below).

FieldApplies toPurpose
ActiveChat widgetPlay sound on new messages/conversations for users on the website (when other conditions in the app are met)
Active - adminAdmin panelPlay sound when agents receive new user messages or conversations
VolumeChat widgetLoudness multiplier (1–10); empty = default (~60%)
Volume - adminAdmin panelSame as Volume, for admin alerts
RepeatChat widgetHow many extra times to replay the sound while the browser tab is not active
Repeat - adminAdmin panelSame as Repeat, for admin alerts
Audio file URL - adminAdmin panelOptional URL to a custom audio file (MP3). If empty, \{bot-host\}/media/sound.mp3 is used

Default widget audio uses \{your-bot-host\}/media/sound.mp3 unless your theme overrides it.

Browser autoplay policy

Modern browsers block audio until the visitor or agent has engaged with the page — for example by clicking anywhere in the admin area or on the page that shows the chat widget. This is a browser security rule, not an Aysali Bot limitation.

If sounds never play:

  1. Click once inside the admin panel or chat page after it loads.
  2. Confirm Active or Active - admin is enabled and settings are saved.
  3. Check that the tab is not muted at the OS or browser level.

Repeat behavior

If Repeat (or Repeat - admin) is set above Default, the sound can loop while the admin tab or chat widget page is in the background (another tab focused, window minimized, or tab hidden). Each repeat waits for the clip to finish, then plays again until the repeat count is reached, or Infinite loop is selected.

Sound is separate from desktop notifications and flash (title bar) alerts under the same Settings → Notifications section. You can combine them: for example desktop notification when the tab is hidden, without sound when the panel is focused.