Extensions

The extension system organizes phone extensions using dial plans, which allows multiple companies to share one PBX with the same internal numbers.

Dial plans

The system divides extensions into an unlimited number of dial plans. Multiple companies can use the same internal numbers (e.g. 100-110) in separate plans with the option of internal communication using short numbers.

Creating and managing a dial plan

• New: Click “New record” in the toolbar
• Edit: Click the “Edit” button or right-click on the record
• Delete: Click the delete button

Dial plan properties

• Name: Dial plan identifier
• Enable internal call distinction: Adds SIP headers with ring type information
• SIP header: Information for internal call signaling
• Description: Informational text

Extensions

Each dial plan contains a list of extensions accessible by clicking on the plan name.

Creating and managing extensions

• New extension: Click “New record” in the Extensions tab
• Edit: “Edit” button or right-click context menu
• Delete: Delete button or context menu

Extension properties

Basic settings

• Name and description
• Internal number — available only within the same dial plan
• Public numbers — up to three per extension, directly dialable from the external network
• CID 1–4 (Caller Number Identification) — four variants for outgoing number presentation
• Add to phone book — automatic inclusion in the system directory
• Blacklist — numbers blocked from calling this extension
• Outbound routing selection
• Outgoing call permissions: Allowed / Denied / Internal only / API only

Ring type

• Standard: Normal ringing tone
• Music: Music plays immediately upon pickup
• Forced: Immediate tone generation without endpoint confirmation

Call recording

Options: Off / Incoming only / Outgoing only / Both directions / On demand (activate via *5)

Call limits

Daily and monthly spending limits configurable for each extension.

Web interface login credentials

Username, password, failed login attempt limit and interface access permission.

Instant messaging (IM)

Jabber username, password and presence monitoring options.

Mobile extensions

Enables simultaneous ringing on configured phone numbers with adjustable delay and caller number preservation.

Call forwarding

• Unconditional: Immediate forwarding
• Conditional (on busy): Signaling via out-of-band, in-band tone or voice prompt
• Wait for availability: PBX holds the call and retries every 10 seconds
• No answer / unreachable: Handling of unanswered or unreachable calls
• Time rules: Rule-based routing
• Calendar routing: Event-dependent routing

All forwarding modes support:

• Busy tone signaling
• Forwarding to voicemail
• Routing to internal or external number
• Caller number preservation option (SIP DIVERSION recommended)

Extension channels (SIP channels)

Multiple SIP channels on one extension create multi-extensions with shared internal/public numbers.

Basic channel configuration

• Name: Channel identifier
• SIP login name: Authorization username
• Password: Authorization credential
• Host: IP address, FQDN, or empty (for registration)
• Outbound proxy: Optional proxy server address in full SIP URI format
• Domain alias: Alternative domain name
• From domain / From username: Information for SIP headers
• NAT: Ignores IP/port in SIP/SDP; communicates via incoming packets
• ICE support: NAT support for compatible clients
• Transport: SIP communication protocol (automatically set if empty)
• Registration: Automatic registration to remote PBX/device
• Registration expiry: Renewal interval
• Tariff: Billing table selection

Audio and video codecs

Priority codec selection for audio and video streams with user-configurable order.

Extended settings

Language and signaling

• Prompt language selection
• Country tone settings
• DTMF mode (RFC4733 recommended)
• In-band progress generation control
• Qualify frequency: OPTIONS message interval (seconds)
• Keep-alive packet frequency: CRLF message interval (seconds)

Restrictions

• Max registered contacts per SIP account
• Allowed/blocked IP addresses (CIDR notation, comma-separated)
• Call limit
• Caller number override
• CallerID blocking
• SIP Diversion header generation
• RPID/PAI header inclusion
• Call transfer

Auto-configuration

• Device selection
• MAC address (supported formats: 00.11.22.33.44.55, 00:11:22:33:44:55, 00-11-22-33-44-55, 001122334455)
• UUID identifier (for Zoiper clients)
• PBX IP address selection

Expert settings

RTP and audio

• Voice encryption: None / SDES / DTLS
• Direct RTP between endpoints
• RTP inactivity timeout
• RTP hold timeout
• RTP keep-alive for NAT
• Symmetric RTP
• Class of Service (COS) for audio/video
• Type of Service (TOS) for audio/video

FAX

• Fax detection and redirect to extension “f”
• Detection timeout
• T.38 protocol support
• T.38 over NAT / IPv6
• Error correction: None / FEC / Redundancy

Multi-extension membership

List of multi-extensions containing the current extension with add/remove options.

Call center queue membership

List of call center queues containing the extension with add/remove options.

Calendar categories

Routing based on calendar events with actions for individual categories:

• Disabled
• Busy tone signaling
• Forward to voicemail
• Forward to number with caller number preservation option

Button configuration

Speed dial position configuration:

• Position: Record sequence number (%POSITION%)
• Name: Position label (%SPEEDDIAL_LABEL%)
• Number: Phone number (%SPEEDDIAL_NUMBER%)

These values are generated into the template variable %SPEEDDIAL_CONFIG%.

Extension generator

A tool for bulk creation of extensions with SIP channels using iterative number ranges.

Parameters

• Iterate from/to: Number range
• Name: Extension identifier; includes iterator if enabled
• Internal number: Short number
• Public number: Directly dialable number
• CID 1: Outgoing call identifier
• Tariff: Billing table assignment
• SIP login name (password generated randomly)
• Codec priority, NAT, SRTP, TLS, DTMF mode
• Directed pickup code (default **)
• Web interface login/password

Bulk extension editing

Allows bulk editing of all or selected extensions (CTRL+Click to select). The edit form contains checkboxes for selective field editing.

Multi-extensions

A grouping of extensions that ring simultaneously with shared internal/public numbers.

Multi-extension properties

Similar to standard extensions with the addition of:

• “Answered elsewhere” notification: Informs group members when another extension answers an incoming call
• Extension assignment: Multiple extensions forming the multi-extension
• Script execution: Script execution on incoming call with variable passing