---
title: "My Settings & Personal Profile"
description: "User profile management, personal telephony audio alerts, custom ringtone upload, desktop notification toggles, and remote phonebook directory synchronization."
---

## 📖 Introduction

The **My Settings** module empowers operators, receptionists, and supervisors to configure their individual identity credentials, desktop notification behavior, ringtone alerts, and remote corporate directories. Changes made here apply exclusively to the authenticated user's session without impacting global tenant configurations.

User profile identity fields synchronize directly with the central SoftSwitch Identity Provider (IdP) service, ensuring consistency across the Ring2All Web Portal, Switchboard, and Mobile apps.

![My Settings Console](/screenshots/apps/switchboard/my-settings.png)

---

## 👤 Personal Information

The **Personal Information** card allows operators to review and maintain their core identity attributes:

| Field | Description | Synchronization Target |
| :--- | :--- | :--- |
| **Full Name** | The user's complete legal or display name shown on operator activity logs and BLF caller transfers. | Central IdP (`users.full_name`) |
| **Username** | Unique alphanumeric account handle used during SSO and local login credentials. (Read-only after initial provisioning). | Central IdP (`users.username`) |
| **Email Address** | Primary corporate email address for password resets, voicemail-to-email notifications, and supervisor alerts. | Central IdP (`users.email`) |
| **New Password** | Secure password reset input. Enforces enterprise complexity policies (Argon2id hashing, minimum 8 characters). | Central IdP (`users.password_hash`) |

---

## ⚙️ General Preferences

Fine-tune the operator workstation responsiveness and ambient alerts:

| Preference | Type | Default | Operational Impact |
| :--- | :--- | :--- | :--- |
| **Sound Alerts** | Toggle | `Enabled` | Enables auditory cues upon incoming calls, queue threshold warnings, and transfer completions. |
| **Desktop Notifications** | Toggle | `Enabled` | Triggers browser Web Notifications when the Switchboard tab is in the background or minimized, showing caller ID and target extension. |
| **Auto Refresh Interval** | Dropdown | `5 seconds` | Frequency of background polling synchronization for non-WebSocket auxiliary feeds (`Disabled`, `3s`, `5s`, `10s`, `30s`, `1m`). |

> [!TIP]
> Always grant browser permissions for **Notifications** and **Audio Autoplay** when prompted. If notifications do not appear, verify that your operating system's *Do Not Disturb* or *Focus Assist* mode is turned off.

---

## 🔔 Audio & Ringtone Settings

Operators working in open reception areas or quiet dispatch centers can personalize their ringing experience:

```text
[ Sound Alerts: ON ] ──> [ Select Ringtone: Vintage Telephone ] ──> [ ▶ Test Playback ]
```

### Stock Ringtone Library
- **Vintage Telephone**: Classic dual-bell mechanical chime (`mixkit-vintage-telephone-ringtone-1356.wav`).
- **Old Telephone**: Traditional analog resonant pulse (`mixkit-old-telephone-ring-1357.wav`).
- **Office Telephone**: Subtle modern electronic warble (`mixkit-office-telephone-ring-1350.wav`).
- **None (Silent)**: Visual-only flashing notifications without audio playback.

### Custom Ringtone Upload
Operators can upload customized WAV or MP3 audio files:
1. Click **Upload Custom Ringtone**.
2. Select an audio file (maximum file size: `5MB`, recommended format: `PCM 16-bit 48kHz WAV`).
3. Once uploaded, the audio file is stored in `/var/www/softswitch/switchboard/audio/custom/` and immediately available in the dropdown with instantaneous playback preview (`▶ Play`).

---

## 📖 Phonebook & Directory Integration

Integrate the Switchboard search dock with external CRM or corporate LDAP/XML phonebooks:

| Configuration Parameter | Format | Description |
| :--- | :--- | :--- |
| **Remote Phonebook URL** | `https://crm.company.com/api/contacts.json` | Remote endpoint serving structured JSON or Grandstream/Yealink XML contact directories. |
| **Sync Protocol** | HTTPS GET with Bearer / Basic Auth | Secure encrypted fetch scheduled automatically during user login sessions. |

When configured, the Switchboard extension search bar automatically aggregates remote phonebook entries, allowing operators to search external vendors, VIP clients, and partners alongside internal PBX extensions.

---

## 💾 Saving & Discarding Changes

The bottom **Fixed Action Bar** monitors form dirtiness:
- **Save Changes**: Persists all preferences to the backend database (`ss_switchboard.user_settings`) and triggers notification confirmation.
- **Cancel**: Reverts all fields back to their database values without persisting changes, keeping the user securely on the page.