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

# Notification settings

> Choose desktop notifications, session sounds, call sounds and admin security emails in OpenCX, and see which choices are yours and which apply to everyone.

**Settings → Notifications** controls how the OpenCX dashboard gets your attention: desktop notifications, the sounds for session activity and calls, and the security emails sent to admins. Some choices are yours alone; others apply to everyone in the workspace.

> [!NOTE]
>
> **Settings → Notifications** in your [OpenCX dashboard](https://platform.open.cx/settings/notifications). Every member can open it. **Session sounds** and **Security emails** appear only for members with full admin access.

## Who each section affects

| Section | Applies to | Saved | Who can change it |
| - | - | - | - |
| **Desktop notifications** | You | In this browser | Any member |
| **Session sounds** | Everyone in the workspace | For the workspace | Full admins |
| **Call sounds** | You | To your account, across browsers | Any member |
| **Security emails** | Members with full admin access | For the workspace | Full admins |

## Turn on desktop notifications

Desktop notifications appear only while the dashboard tab is in the background. Selecting one brings the dashboard forward and opens what it is about.

**1. Allow notifications**

Select **Enable** beside **Desktop notifications** and allow notifications when your browser asks.

**2. Choose the types you want**

Once allowed, each type has its own switch. All of them start on.

| Type | You are notified when |
| - | - |
| **Customer replies** | A customer replies to a session assigned to you |
| **Mentions** | You or your team are mentioned in comments |
| **Comment threads** | Someone adds a comment to a thread you follow |
| **Deep research** | A deep research report completes |
| **Exports** | A CSV export from Voice of Customer is ready to download |
| **Session exports** | A session export finishes or fails |
| **Insight assignments** | A Voice of Customer insight is assigned to your team |

These switches control only the desktop pop-up. The same events still reach your **Notifications** list in the sidebar. Most of them also play a short alert sound when they arrive; customer replies do not.

If you blocked notifications earlier, the section says so. Allow notifications for the dashboard in your browser's site settings, then reload the page.

## How customer reply notifications are controlled

Two switches decide whether you hear about customer replies, and the workspace one wins:

* **Disable customer reply notifications**, under [**Settings → Workspace → Agents**](https://docs.open.cx/ticketing/workspace-settings.md#agents), is set by an admin for everyone. While it is on, OpenCX creates no customer reply notifications at all: nothing in the **Notifications** list and no desktop pop-up, whatever each agent chose here. It is off by default.
* **Customer replies**, in your **Desktop notifications**, only decides whether you also get a desktop pop-up for a reply the workspace already notifies you about.

Neither switch affects the **Customer reply** session sound below, which plays from your inbox view.

## Choose session sounds for the workspace

**Session sounds** sets the sounds everyone in the workspace hears while the inbox is open. Pick a sound for each event and select **Preview** to hear it.

| Event | Plays when | Default |
| - | - | - |
| **Session activity** | A different session moves to the top of your inbox view | **Default** |
| **Customer reply** | A new customer reply appears in a session in your inbox view | **Pop** |

Choose from **Default**, **Chime**, **Pop**, **Bell**, **Soft ping**, **Double beep**, **Doorbell** and **Gentle chord**, or **Off** to silence an event for the whole workspace. Agents can mute both sounds for themselves with **New message notifications** in a session's **⋯** menu. The exact rules for when each sound plays are in the [inbox guide](https://docs.open.cx/inbox/intro.md#session-notification-sounds).

## Set your call sounds

**Call sounds** sets how incoming calls ring for you. It is saved to your account, so it follows you to other browsers.

| Setting | What it does | Default |
| - | - | - |
| **Ringtone** | **Classic**, **Chime**, **Pulse** or **Soft**. Picking one plays a short preview; **Preview** and **Stop** replay it. | **Classic** |
| **Ring volume** | How loud the ringtone plays, from 0 to 100%. | 80% |
| **Play a sound when a call ends** | Plays a cue when the other side hangs up, even from another tab. | On |

## Manage security emails

**Security emails** are sent to members with full admin access when a sensitive change happens in the workspace. Every event is on by default, and each one can be turned off for the workspace.

| Event | Sent when |
| - | - |
| **Member added** | A new member joins the organization |
| **Member removed** | A member is removed from the organization |
| **Admin role granted** | A member is given a role with full admin access |
| **Role permissions changed** | The permissions of a role are changed |
| **API key created** | A new API key is created |
| **PII redaction turned on or off** | Automatic PII redaction is enabled or disabled |
| **MCP server connected** | An MCP server is connected to the AI agent |
| **Secret created** | A new credential secret is created |
| **Webhook endpoint changed** | The webhook endpoint that receives your events is changed |
| **Ownership transferred** | Ownership of the organization moves to another member |

The same changes are recorded in the [audit log](https://docs.open.cx/security/audit-logs.md) whether or not their email is on.

## Troubleshooting

| Symptom | Likely cause | Fix |
| - | - | - |
| **Desktop notifications** says notifications are blocked | Your browser denied the dashboard permission | Allow notifications for the dashboard in your browser's site settings and reload. |
| No desktop pop-up while you are looking at the dashboard | Pop-ups show only while the tab is in the background | Check the **Notifications** list in the sidebar, which receives the same events. |
| No customer reply notifications at all, even with **Customer replies** on | An admin turned on **Disable customer reply notifications** | Ask an admin to review it under **Settings → Workspace → Agents**. |
| **Session sounds** or **Security emails** is missing | Your role does not have full admin access | Ask an admin to change these sections. |

***

## Related Documentation

> [card] [Workspace settings](https://docs.open.cx/ticketing/workspace-settings.md)
>
> Workspace-wide defaults

> [card] [Personalization](https://docs.open.cx/ticketing/personalization.md)
>
> Your own inbox preferences

> [card] [Inbox](https://docs.open.cx/inbox/intro.md)
>
> Notification list and sounds

> [card] [Audit logs](https://docs.open.cx/security/audit-logs.md)
>
> Who changed what


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.