> ## Documentation Index
> Fetch the complete documentation index at: https://documents.xobito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> Control in-app notifications, browser alerts, and notification sounds.

Xobito keeps you informed of new messages, campaign events, and team activity through three layers of notifications: in-app, browser push, and sound.

<Note>
  Notification settings are **per-user**. Each staff member controls their own preferences — admins cannot silence someone else's laptop.
</Note>

## Opening notification settings

Click your avatar in the top-right → **My Profile → Notifications**.

Alternatively, click the bell icon in the header to see recent notifications and access quick settings.

## Kinds of notifications

<CardGroup cols={3}>
  <Card title="In-app" icon="bell">
    A red dot on the bell icon and an entry in the notification panel.
  </Card>

  <Card title="Browser push" icon="desktop">
    A toast on your desktop even when the Xobito tab is not focused.
  </Card>

  <Card title="Sound" icon="volume-high">
    An audio chime whenever a new event arrives.
  </Card>
</CardGroup>

## Events that trigger a notification

| Event                                            | Default | Who gets it        |
| ------------------------------------------------ | ------- | ------------------ |
| New message arrives in a chat assigned to you    | On      | The assigned agent |
| New message in an unassigned chat                | On      | All online agents  |
| You are mentioned (`@name`) in a note            | On      | The mentioned user |
| A chat is assigned to you                        | On      | The new assignee   |
| A ticket is assigned to you                      | On      | The new assignee   |
| Your campaign finishes sending                   | On      | The campaign owner |
| A template you submitted is approved or rejected | On      | Template creator   |
| Your WABA is disconnected                        | On      | All admins         |
| A staff member joins or leaves                   | Off     | All admins         |
| A contact opts out                               | Off     | The contact owner  |

You can toggle each event independently.

## In-app notifications

The bell icon in the top bar shows a red dot whenever there are unread notifications. Click the bell to see the list.

<Steps>
  <Step title="Click the bell">
    The notification panel slides in from the right.
  </Step>

  <Step title="Click any notification">
    You jump directly to the related chat, campaign, or ticket.
  </Step>

  <Step title="Mark as read">
    Click **Mark all as read** at the top to clear the red dot.
  </Step>
</Steps>

## Browser push notifications

Browser push allows Xobito to pop up a toast on your desktop even if the tab is in the background.

### Enabling browser push

<Steps>
  <Step title="Click 'Enable notifications'">
    Found on your profile page or as a banner at the top of the dashboard.
  </Step>

  <Step title="Allow in your browser">
    Your browser asks permission. Click **Allow**.
  </Step>

  <Step title="Test">
    Ask a teammate to send a test message. A toast should appear.
  </Step>
</Steps>

<Warning>
  If you click **Block** by mistake, the only way to re-enable is through your browser's site settings. In Chrome: click the padlock next to the URL → **Site settings → Notifications → Allow**.
</Warning>

### Per-browser rules

* **Chrome / Edge:** Works on all platforms when the browser is running.
* **Firefox:** Same as Chrome.
* **Safari (macOS 13+):** Requires you to "install" the Xobito web app first — click the share icon → **Add to Dock**.
* **Mobile browsers:** Use the mobile app for reliable push.

## Notification sounds

Xobito plays a short chime for new messages and important events. You can change the sound or mute it.

### Changing the sound

<Steps>
  <Step title="Open notification settings">
    Profile → Notifications → **Sound**.
  </Step>

  <Step title="Pick a sound">
    Preview each option by clicking the play icon next to it. Built-in sounds include:

    * **Chime** (default)
    * **Ping**
    * **Pop**
    * **Bell**
    * **Subtle**
  </Step>

  <Step title="Save">
    Click **Save preferences**.
  </Step>
</Steps>

### Mute everything (do not disturb)

Toggle **Do Not Disturb** at the top of the notification panel. This silences all sounds and browser push for the chosen duration (30 min, 1 hour, until tomorrow, or indefinite).

<Tip>
  Use Do Not Disturb during meetings — in-app red dots still appear so you can catch up, but your laptop stays quiet.
</Tip>

### Why am I not hearing sounds?

<AccordionGroup>
  <Accordion title="Your browser tab is muted.">
    Right-click the Xobito tab → ensure **Mute Site** is unchecked.
  </Accordion>

  <Accordion title="Your OS volume is at zero.">
    Check the volume slider. Try a different audio output.
  </Accordion>

  <Accordion title="Another tab is playing audio and your browser is throttling Xobito.">
    Click inside the Xobito tab once — browsers often require a recent click before playing audio.
  </Accordion>

  <Accordion title="You selected 'Silent' as the sound.">
    Re-open **Profile → Notifications → Sound** and pick any option.
  </Accordion>
</AccordionGroup>

## Email notifications

Some events also trigger an email:

* You are invited to a workspace
* A staff member creates an account under your workspace
* A campaign finishes
* Your WABA is disconnected (admins only)
* Your subscription renewal succeeds / fails

You can't turn off transactional emails, but you can adjust which campaign events send an email in **Settings → Email Templates**.

## Mobile app notifications

If you've installed the Xobito mobile app, notifications follow your phone's standard notification permissions.

* **iOS:** Settings → Notifications → Xobito → Allow.
* **Android:** Settings → Apps → Xobito → Notifications → On.

Per-user notification toggles in the web app also apply to mobile push.

## Related

<CardGroup cols={2}>
  <Card title="Real-time Updates (Pusher)" icon="bolt" href="/settings/pusher-realtime">
    How new messages reach you instantly.
  </Card>

  <Card title="Email Templates" icon="envelope" href="/settings/email-templates">
    Customise the emails Xobito sends.
  </Card>
</CardGroup>