AiPBX
Features Install Videos Mobile Docs Live demo Contact Sponsor on GitHub UpCloud ($250 Free Credit) YouTube GitHub
ODOO Connect AiPBX with Odoo CRM & ERP — manage calls & customers in one place. Try Odoo Free →
Home / Documentation / Extensions

Extensions

PBX → Extensions lists every extension with its state (Registered, On a Call, Unreachable), its SIP password and its settings. A user and an extension are one record: a user added under System → Users with an extension appears here. An extension can also be marked Device only (no portal user) for a shared or unattended phone; it cannot sign in to the portal or mobile app. Portal users may have no extension at all. Fax users are not listed here; they are on Fax → Fax Units (see Fax users).

Every change goes to Asterisk with Apply (Portal basics). Each extension becomes /etc/asterisk/pbx/pjsip_ext_<number>.conf.

The table

  • Copy the SIP password (the copy button beside the hidden password) puts it on the clipboard without showing it, for typing into a phone or softphone.
  • Phone keys (⊞) opens the user's key layout for desk phones (Desk phones).
  • Remove deletes the extension only; the user account stays.

The form

The editor has five tabs: Basic Settings, Call Routing & Forwarding, Groups & Pickup, Voicemail and Advanced SIP & Media. Save the form, then Apply the pending changes.

FieldMeaning
Full name, Extension noRequired. The name is shown to the people this extension calls.
SIP passwordFor desk phones, softphones, the web phone and the apps. Separate from the portal password.
SIP authenticationEnabled (default) asks every phone for the password. Disabled lets a device in by its From header alone: only for devices on a trusted network that cannot authenticate. The web phone and the mobile app always use a password: left empty, a random one is set and handed to them.
Internal / External Call CIDThe number sent on internal and outbound calls. Which one an outbound route uses is set on the route; a fixed caller ID on the route comes first.
Calling permission group, Outbound route groupWhich numbers the extension may dial and which outbound routes it uses (Outbound routes).
Boss - Secretary groupPuts the extension into a boss/secretary pair. The secretary filter applies to internal calls and to every call that reaches the boss from outside: an inbound route, an IVR key, a time condition or an announcement.
VoicemailBox on or off, PIN (empty: the extension number), e-mail with or without the recording, and when calls go there: no answer, unreachable or always (Voicemail).
Send the caller in a headerSends the caller in P-Asserted-Identity. On by default; some desk phones (NEC DT700/DT800) show "asterisk" as the caller without it. A caller who hides their number stays hidden. Turn it off only for a phone that has trouble with it.
ActiveOff: the extension cannot register or call, and the user cannot sign in.
Device only (no portal user)For a lobby, door or meeting-room phone or a shared line. The extension registers as a SIP phone and is an extension everywhere (ring groups, queues, BLF keys, inbound routes, provisioning, call records), but it is no person: it cannot sign in to the portal or the mobile app by any way, is not listed under System Users and does not appear in chat. Off by default. An administrator's or your own account cannot be made device only. A line key of a desk phone can carry such an extension next to the user's own.

SIP settings

For the extension's desk phone or softphone only; the web phone and the mobile apps keep their own. Default leaves the system's value, so leave a field on Default unless a phone needs otherwise.

SettingValuesNote
TransportUDP, TCP, TLSDefault follows the transport the phone registered on, which suits nearly every phone. A chosen one must match the phone, or calls do not reach it. See Transports.
DTMF modeRFC 4733, Inband, SIP INFO, AutoHow key presses are sent.
Media encryptionOff, SRTP (SDES), DTLS-SRTPChoose the method the device supports; DTLS-SRTP is normally used for WebRTC-capable devices.
Optimistic media encryption, ICEYes / NoDevice-specific negotiation/NAT behavior. Leave Default unless the device requires an override.
Media addressaddressAdvertised media address override for this endpoint. Check the server NAT configuration before setting it.
Force rport, Rewrite contact, Symmetric RTPYes / NoNAT options, for a phone behind a router that rewrites its addresses.
Direct mediaYes / NoLets audio flow between two phones directly, past the PBX.
Codecs, in orderopus, g722, alaw, ulaw, g729Comma separated. Empty: the system list.
Devices at oncea numberHow many devices may register with this extension at the same time.
Check interval (seconds)a numberHow often Asterisk checks the phone. 0: never. Empty: the system value.
RTP timeout, RTP keepalivesecondsTimeout controls how long missing RTP is tolerated; keepalive sends periodic RTP to maintain NAT state. Empty inherits the system value.
Prompt languagea languageThe language of the prompts this extension hears.

For anything not listed, use Advanced Configuration, which can also apply a setting to all extensions at once.

View or edit this page on GitHub

On This Page