---
title: "System General Settings Module Documentation"
description: "Documentation for System General"
---

## Table of Contents
1. [Navigation & Access](#navigation--access)
2. [Screenshots & Visual Interface](#screenshots--visual-interface)
3. [Module Overview (Technical)](#1-module-overview-technical)
4. [Module Overview (Commercial/Business)](#2-module-overview-commercialbusiness)
5. [Module Overview (End User/Administrator)](#3-module-overview-end-useradministrator)
6. [User Roles & Key Capabilities](#-user-roles--key-capabilities)
7. [Configuration Sections](#4-configuration-sections)
8. [Settings Reference](#5-settings-reference)
9. [Common Scenarios & Examples](#6-common-scenarios--examples)
10. [Limitations & Important Notes](#7-limitations--important-notes)
11. [Troubleshooting Tips](#8-troubleshooting-tips)
12. [Glossary](#9-glossary)
13. [Model Context Protocol (MCP) AI Integration](#model-context-protocol-mcp-ai-integration)
---

## Navigation & Access

To access the System General configuration module:
1. Log in to the Ring2All Web Portal (`https://<domain-or-ip>/login`).
2. In the left navigation sidebar, expand **Settings**.
3. Under **PBX**, click **System General** (`/settings/pbx/system-general`).
4. Configure domain-wide defaults across the General, Voicemail, and Codecs tabs, and click **Save Changes** in the bottom action bar.

---

## Screenshots & Visual Interface

### System General Configuration Interface
Centralized domain defaults panel for setting system language, text-to-speech voice engines, default ringtones, music-on-hold audio streams, global voicemail thresholds, and inbound/outbound audio codec negotiation hierarchies.
![System General Form](/screenshots/settings/pbx/system-general-form.png)

---

## 1. Module Overview (Technical)

### What Is System General Settings?

System General Settings is a **domain-wide configuration module** that defines default values for new extensions. When creating a new extension, these settings are applied automatically, ensuring consistent configuration across the tenant.

### Architecture

```
┌─────────────────────────────────────────────────────────────────┐
│             System General Settings Architecture               │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Admin Panel                                                    │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        System General Settings                           │   │
│  │                                                          │   │
│  │  Tabs:                                                   │   │
│  │  ├─ General (Language, Timezone, SIP)                   │   │
│  │  ├─ Voicemail & Recording                               │   │
│  │  └─ Codecs & Media                                      │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│       │                                                         │
│       ▼ Stored per domain                                      │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        public.domain_settings                            │   │
│  │                                                          │   │
│  │  domain_id | setting_key | setting_value                │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│       │                                                         │
│       ▼ Applied to new extensions                              │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │        Extension Creation                                │   │
│  │                                                          │   │
│  │  New Extension 1010:                                    │   │
│  │  ├─ Language = Default Language (es_MX)                 │   │
│  │  ├─ Timezone = Default Timezone (America/Chicago)       │   │
│  │  ├─ Voicemail = Enabled (from defaults)                 │   │
│  │  ├─ Recording = Incoming (from defaults)                │   │
│  │  └─ (other defaults applied)                            │   │
│  │                                                          │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

---

## 2. Module Overview (Commercial/Business)

### Business Value

System General Settings provides **consistent defaults**:

| Without System Defaults | With System Defaults |
|-------------------------|---------------------|
| Configure each extension | Set once, apply always |
| Inconsistent settings | Standardized config |
| Time-consuming setup | Quick extension creation |
| Forgotten settings | Nothing overlooked |

### Use Cases

1. **Standardized Extensions**
   - All new extensions use same defaults
   - Consistent user experience

2. **Regional Compliance**
   - Set default language/timezone
   - Recording policies

3. **Security Policies**
   - Password length requirements
   - Call restrictions

4. **Voicemail Defaults**
   - Email notifications
   - Transcription settings

### Feature Highlights

| Feature | Benefit |
|---------|---------|
| **Localization** | Language/timezone defaults |
| **SIP Settings** | Max registrations, DTMF |
| **Voicemail** | Enable/transcribe/email |
| **Recording** | In/Out/Internal defaults |
| **Call Behavior** | Ring timeout, call waiting |
| **Media** | Hold music, ringtone |

---

## 3. Module Overview (End User/Administrator)

### What Can You Do?

- Set default language for new extensions
- Configure default timezone
- Set codec preferences
- Configure voicemail defaults
- Set recording policies
- Configure call behavior
- Set media preferences

### System General Settings Interface

```
┌─────────────────────────────────────────────────────────────────┐
│              System General Settings                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Default configurations for extension creation                  │
│                                                                 │
│  [General] [Voicemail & Recording] [Codecs & Media]            │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  ▼ Language & Localization                                      │
│  ├─ Default Language: [Spanish (Mexico) ▼]                     │
│  ├─ Default Voice: [Polly - Mia ▼]                             │
│  └─ Default Timezone: [America/Chicago ▼]                      │
│                                                                 │
│  ▼ SIP Device Settings                                          │
│  ├─ Max Registrations: [3                 ]                    │
│  ├─ DTMF Mode: [RFC 2833 ▼]                                    │
│  └─ Auto-Password Length: [20 ▼]                               │
│                                                                 │
│  ▼ Call Behavior                                                │
│  ├─ Ring Timeout (seconds): [30           ]                    │
│  ├─ Call Waiting: ✓                                            │
│  ├─ Caller ID Privacy: [Screen ▼]                              │
│  ├─ Max Concurrent Calls: [5              ]                    │
│  ├─ Reject Anonymous: ☐                                        │
│  └─ PINless Dialing: ☐                                         │
│                                                                 │
│  [Save Changes] [Reset to Default]                              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

### Voicemail & Recording Tab

```
┌─────────────────────────────────────────────────────────────────┐
│              System General Settings                            │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  [General] [Voicemail & Recording] [Codecs & Media]            │
│  ─────────────────────────────────────────────────────────────  │
│                                                                 │
│  ▼ Voicemail Settings                                           │
│  ├─ Voicemail Enabled: ✓                                       │
│  ├─ Max Messages: [50                     ]                    │
│  ├─ Email Notifications: ✓                                     │
│  ├─ Transcription: ☐                                           │
│  └─ Email Attachment: ✓                                        │
│                                                                 │
│  ▼ Call Recording Settings                                      │
│  ├─ Record Incoming: ✓                                         │
│  ├─ Record Outgoing: ☐                                         │
│  ├─ Record Internal: ☐                                         │
│  ├─ Record On Demand: ✓                                        │
│  └─ Recording Format: [MP3 ▼]                                  │
│                                                                 │
│  [Save Changes] [Reset to Default]                              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

### Quick Tips

> [!TIP]
> **Domain Selection**: Select a domain from the header first.

> [!TIP]
> **Reset to Default**: Click reset icon next to any field.

> [!NOTE]
> **New Extensions Only**: Changes apply to new extensions, not existing ones.

---

## 🎯 User Roles & Key Capabilities

| Role | Permissions | Key Capabilities |
|------|-------------|------------------|
| **Super Administrator** | Global Full Access (`read`, `write`) | Manage platform default timezones, global audio codec negotiation lists, and system-wide emergency caller ID defaults. |
| **Tenant Administrator** | Domain Management (`read`, `write`) | Configure domain-specific language (English, Spanish), text-to-speech voice providers, voicemail inbox limits, and call recording formats. |
| **Telecom / PBX Engineer** | Operational Configuration (`read`, `write`) | Set RTP media port ranges, configure DTMF signaling defaults, and fine-tune media bypass parameters. |
| **Auditor / Support Specialist** | Read-Only (`read`) | Audit domain general settings, verify localization consistency, and check codec hierarchies. |

---

## 4. Configuration Sections

### General Tab

| Section | Settings |
|---------|----------|
| **Language & Localization** | Default Language, Voice, Timezone |
| **SIP Device Settings** | Max Registrations, DTMF, Password Length |
| **Call Behavior** | Ring Timeout, Call Waiting, Privacy, etc. |

### Voicemail & Recording Tab

| Section | Settings |
|---------|----------|
| **Voicemail Settings** | Enabled, Max Messages, Email, Transcription |
| **Recording Settings** | In/Out/Internal, On Demand, Format |

### Codecs & Media Tab

| Section | Settings |
|---------|----------|
| **Codecs** | Inbound/Outbound Preferences |
| **Media** | Hold Music, Ringtone |

---

## 5. Settings Reference

### Language & Localization

| Setting | Description |
|---------|-------------|
| **Default Language** | Language for prompts |
| **Default Voice** | TTS voice (e.g., Polly) |
| **Default Timezone** | For voicemail timestamps |

### SIP Device Settings

| Setting | Description |
|---------|-------------|
| **Max Registrations** | Max devices per extension |
| **DTMF Mode** | RFC4733, RFC2833, INFO, Inband |
| **Auto-Password Length** | Generated password length |

### Call Behavior

| Setting | Description |
|---------|-------------|
| **Ring Timeout** | Seconds before timeout |
| **Call Waiting** | Allow call waiting |
| **Caller ID Privacy** | Screen, Name, Number, Full |
| **Max Concurrent Calls** | Per extension (0 = unlimited) |
| **Reject Anonymous** | Block no-CID calls |
| **PINless Dialing** | Allow without PIN |

### Voicemail Settings

| Setting | Description |
|---------|-------------|
| **Voicemail Enabled** | Enable by default |
| **Max Messages** | Message limit |
| **Email Notifications** | Send email alerts |
| **Transcription** | Speech-to-text |
| **Email Attachment** | Attach audio file |

### Recording Settings

| Setting | Description |
|---------|-------------|
| **Record Incoming** | Record inbound calls |
| **Record Outgoing** | Record outbound calls |
| **Record Internal** | Record ext-to-ext |
| **Record On Demand** | Enable * to record |
| **Recording Format** | WAV, MP3, GSM |

### Codecs & Media

| Setting | Description |
|---------|-------------|
| **Inbound Codec Prefs** | Incoming codec order |
| **Outbound Codec Prefs** | Outgoing codec order |
| **Hold Music** | MOH source |
| **Ringtone** | Default ringtone |

---

## 6. Common Scenarios & Examples

### Scenario 1: Set Regional Defaults

1. Open System General Settings
2. Set Default Language = Spanish
3. Set Default Timezone = America/Mexico_City
4. Save changes

### Scenario 2: Enable Recording Policy

1. Go to Voicemail & Recording tab
2. Enable Record Incoming = Yes
3. Set Recording Format = MP3
4. Enable Record On Demand = Yes
5. Save changes

### Scenario 3: Security Hardening

1. Set Auto-Password Length = 25
2. Set Max Registrations = 2
3. Enable Reject Anonymous = Yes
4. Disable PINless Dialing
5. Save changes

### Scenario 4: Voicemail Defaults

1. Go to Voicemail & Recording tab
2. Enable Voicemail Enabled = Yes
3. Set Max Messages = 50
4. Enable Email Notifications
5. Enable Email Attachment
6. Save changes

---

## 7. Limitations & Important Notes

### Technical Notes

> [!NOTE]
> **Domain-Scoped**: Settings apply per domain/tenant.

> [!NOTE]
> **New Extensions Only**: Existing extensions keep their settings.

> [!WARNING]
> **No Bulk Update**: Changing defaults doesn't update existing extensions.

### Best Practices

1. **Set Before Creating**: Configure before creating extensions
2. **Document Policies**: Note company recording policies
3. **Consistent Language**: Match user language preferences
4. **Timezone Accuracy**: Set correct timezone for voicemail
5. **Security First**: Use strong password lengths

### Privacy Options

| Option | Hidden From |
|--------|-------------|
| **Screen** | Name + Number on call |
| **Name** | Name hidden |
| **Number** | Number hidden |
| **Full** | All hidden |

---

## 8. Troubleshooting Tips

### Common Issues

| Symptom | Possible Cause | Solution |
|---------|---------------|----------|
| Defaults not applied | Wrong domain | Check domain selection |
| Existing ext unchanged | By design | Update extensions manually |
| Wrong language | Not saved | Save changes |
| Recording not working | Recording disabled | Check recording settings |
| Voicemail off | Disabled in defaults | Enable voicemail |

### Check Domain Settings

```sql
SELECT 
  setting_key,
  setting_value
FROM public.domain_settings
WHERE domain_id = [domain_id]
ORDER BY setting_key;
```

---

## 9. Glossary

| Term | Definition |
|------|------------|
| **Domain Defaults** | Settings applied to new extensions |
| **Localization** | Language and timezone settings |
| **Max Registrations** | Device limit per extension |
| **Transcription** | Voicemail speech-to-text |
| **Recording Format** | Audio file format (MP3/WAV) |
| **Privacy** | Caller ID visibility settings |

---

## Model Context Protocol (MCP) AI Integration

The Ring2All PBX platform integrates deep AI assistance via the Model Context Protocol (MCP). The System General Settings module allows the PBX AI Copilot to safely query domain defaults, inspect active codecs and localization parameters, and verify platform operational readiness.

### Available MCP Tools

| Tool Name | Operation Type | RBAC Risk Level | Description |
|-----------|----------------|-----------------|-------------|
| `get_system_general_settings` | Read / Query | `low` | Retrieves global PBX System General Settings including default domain, timezone, language, emergency caller ID, RTP ports, and media parameters. |

### Tool Input Schemas & Parameters

#### 1. `get_system_general_settings`
```json
{
  "name": "get_system_general_settings",
  "description": "Get global PBX System General Settings including default domain, timezone, language, emergency caller ID, RTP ports, and media parameters.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}
```

### Natural Language Prompts

| User Request | Invoked MCP Tool | Expected AI Response |
|--------------|------------------|----------------------|
| *"What is our system's default timezone and language?"* | `get_system_general_settings` | Returns domain default timezone (e.g. `America/Chicago`), language (`en-US`), and currency settings. |
| *"Check our default audio codecs configured for new extensions."* | `get_system_general_settings` | Lists default inbound/outbound codecs (e.g. `OPUS, PCMU, PCMA, G729`). |
| *"Is call recording enabled by default on new extensions?"* | `get_system_general_settings` | Reports default recording flags (`record_inbound`, `record_outbound`) and audio storage format (`mp3`/`wav`). |

### Multi-Tenant & Security Safeguards

- **Strict Domain Isolation**: Settings are resolved strictly for the requesting tenant's primary domain (`domain_id`), ensuring settings cannot bleed across multi-tenant boundaries.
- **Read-Only Inspection**: Copilot access is read-only by default; altering tenant-wide defaults requires administrative authentication.
- **Sensitive Key Masking**: Any internal API tokens or integration secrets configured under general settings are redacted before AI delivery.
- **Audit Logging**: All configuration queries and updates are timestamped and logged with user credentials.

---

*Documentation last updated: January 2026*