Extensions
Setting Primary Phone Numbers
Extensions in MikoPBX are individual users of the system who are assigned internal numbers for making and receiving calls. They have personal accounts that allow you to configure access rights, call forwarding and other personal settings in the system.
Extensions List
The "Extensions" section displays a list of internal user accounts for employees. On the left side of each employee, the status of the authorized device is displayed. If the device is successfully authorized under the respective internal user account, a green circle is shown; otherwise, it appears gray.
In the search bar, you can find the desired contact. You can search by the employee's name, internal number, mobile number, or email address.
The form also provides the ability to sort the list of employees by name, internal number, mobile number, or email address. There are buttons for copying the account password to the clipboard, editing the account, and deleting the account.
Adding an extension
There are two ways to add employees:
1) Adding employees one by one by entering data in the Web interface.
2) Importing multiple employees from a CSV file.
Adding Employees One by One
To add a new employee, click the "Add new employee" button.
Importing and Exporting Employees from a CSV File
There is an option to export and import employees for configuration convenience. To do this, click the arrow to the right of the "Add New Employee" button.
3 options are available:
Import from CSV — load employees from a CSV file into MikoPBX.
Export to CSV — download employees to a CSV file from MikoPBX (employees will not be deleted from the station).
Download template — download a CSV table template to fill in and subsequently import into MikoPBX.
Import
Click "Select CSV file" and choose the previously prepared file with data in the table. It is recommended to use templates from the "Template" tab.
After selecting the file, information about all detected users in the table will be displayed. Select a duplicate handling strategy and click "Confirm import" to start the process.
After the process is complete, you will see the employee creation status as well as a notification about the end of the import.
Click "Back to list" to return to the employee list.
Export
There is an option to export a CSV file with all the data of current employees. Several export formats are available:
Minimal:
number — Internal number (required)
user_username — Employee full name (required)
user_email — Email address
mobile_number — Mobile number
sip_secret — SIP password (will be generated if not specified)
fwd_ringlength — Ring time (seconds) before forwarding
fwd_forwarding — Forwarding number if no answer
Standard:
All parameters from Minimal.
mobile_dialstring — Number for dialing mobile
sip_dtmfmode — DTMF mode (auto/rfc4733/info/inband)
sip_transport — Transport (udp/tcp/tls), default udp,tcp
sip_enableRecording — Call recording (true/false)
fwd_forwardingonbusy — Forwarding number if busy
fwd_forwardingonunavailable — Forwarding number if unavailable
Full:
All parameters from Minimal and Standard.
user_avatar — Photo URL
sip_manualattributes — Additional SIP parameters
You can also specify a range of internal employee numbers to export (the "Filter by number range" section).
Click "Export employees". The file will be downloaded to your device.
Template
On this tab, you can download a blank file template with the specified "columns" to fill in and subsequently import into MikoPBX.
Select the template format (see the "Export" section for more details), then click "Download CSV template".
Main Account Settings
On the "Basic Parameters" tab, you can configure the general settings for an employee's internal account:
Username: This value will be used for name substitution and displayed in the corresponding field on the phone screen.
Internal Number: This is the employee's internal extension number, which is also used as the login when connecting the phone.
Mobile Number: It is used for additional routing purposes.
Email Address: It is used for email notifications.
Password for SIP
Please ensure that the passwords for SIP accounts meet the following requirements:
The password length should be greater than eight characters.
The password should contain both uppercase and lowercase letters. The password should include numbers and special characters: "-", "_", "[]", "{}", "@", ";".
By setting complex passwords, you can enhance the security of the user accounts and protect them from unauthorized access.
Advanced Account Settings
Accesses the Advanced drop-down list:
Redefining the set string
In the "Redefining the set string" field, enter the dialing rule for mobile numbers according to your provider's requirements.
Call recording
If you want employees to have the ability to record conversations, you can enable the Сall recording feature.
DTMF Mode
The setting determines how DTMF (Dual Tone Multi-Frequency) signals are transmitted over the SIP protocol. DTMF signals are used, for example, when dialing phone numbers or interacting with IVR systems.
Transport protocol
This setting allows you to specify the transport protocol used for this account. The transport protocol determines how data is transmitted over the network. The most common transport protocols used in SIP (Session Initiation Protocol) are UDP (User Datagram Protocol), TCP (Transmission Control Protocol), and TLS (Transport Layer Security)
Network filter
The subnet described in the "Network Firewall" section specifies the allowed subnet for this account. It determines which IP addresses or networks are permitted to connect to this account. Connections originating from other subnets will result in authentication errors.
Manual additional attributes for SIP
This field is used to modify/override the configuration files of Asterisk. You can override almost all parameters. For example, when using chan_pjsip, a SIP account for an employee is described by the following sections:
To override fields in the sections, you should fill in the "Additional Parameters" field as follows:
Routing Settings
On this tab, you can set rules for call forwarding when the employee is unavailable, busy, or does not answer.
Set the time period in seconds during which the call will be directed to the employee's internal account. If the employee cannot answer the call within the specified time, indicate to which number the call should be forwarded. By default, the call will be redirected to the employee's mobile number.
You can also specify the numbers to which the call should be redirected in case of busy and unavailable status.
Feel free to configure these parameters according to your preferences and requirements.
Connecting softphones
Configuring telegram as SIP softphone
Connecting telephones
Yealink T19
Yealink T21
Yealink T28
Snom D120
Last updated
Was this helpful?