Extension Parameters

Descriptions for parameters in exported and imported Extension CSV file.

Parameter Description Importance Restriction Default Value
First Name The first name of extension user. At lease one is required The maximum character length is 63.
Note: First Name will be filled with a value of Extension Number if you leave these fields empty.
Extension number
Last name The last name of extension user. N/A
Email Address The email address of extension user. Optional

Only numbers, letters, and characters @ _ - . are allowed. Must start with a number, letter, or character _ and follow the email address format XXX@XXX.XX.

Extension's email address cannot be duplicated.

The maximum character length is 255.

N/A
Mobile Number The mobile number of extension user. Optional Numbers, letters, and characters ( ) . - + * # are allowed.

The maximum character length is 31.

N/A
User Password The password for extension user to log in to Linkus client and PBX management portal. Required Must contain numbers, uppercase, and lowercase letters.
The minimum character length is 10 and the maximum is 63.
Note: User Password will be generated randomly if you leave this field empty.
Generate Randomly
User Role The role for extension user with PBX management permission. Required Permitted value: 0 or one of the role names defined in the PBX. 0 means [None].
Note: User Role will be filled with default value 0 if you leave this field empty.
0
Extension Number The extension's number. Required Extension Number cannot be duplicated, and only numbers are allowed.

The maximum character length is 7.

N/A
Caller ID The caller ID that is displayed on the callee's device. Required Numbers, letters, and special characters ( ) . - + * # are allowed.
The maximum character length is 31.
Note: Caller ID will be filled with default value Extension Number if you leave this field empty.
Extension Number
Registration Name The registration name that is used to validate extension registration. Required The maximum character length is 63.
Note: Registration Name will be generated randomly if you leave this field empty.
Generate Randomly
Registration Password The password for the user to register the SIP extension. Required
The minimum character length is 8 and the maximum is 63.
Note: Registration Password will be generated randomly if you leave this field empty.
Generate Randomly
IP Phone Concurrent Registrations How many SIP phones are allowed to register with the extension. Required Permitted value:
  • 1: Allow one phone to register with the extension.
  • 2: Allow two phones to register with the extension.
  • 3: Allow three phones to register with the extension.
Note: IP Phone Concurrent Registrations will be filled with default value if you leave this field empty.
1
Emergency Outbound Caller ID The outbound Caller ID for the extension when it makes emergency calls. Optional Numbers, letters, and characters ( ) . - + * # are allowed.

The maximum character length is 31.

N/A
Enable Voicemail Whether to enable or disable voicemail feature. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Enable Voicemail will be filled with default value if you leave this field empty.
1
Voicemail PIN Authentication Whether to enable or disable voicemail PIN authentication. Required if Enable Voicemail = 1 Permitted value:
  • 0: Disable
  • 1: Enable
Note: Voicemail PIN Authentication will be filled with default value if you leave this field empty.
1
Voicemail Access PIN The PIN for authentication when accessing voicemail box. Required if Enable Voicemail = 1 & Voicemail PIN Authentication = 1

Only numbers are allowed.

The minimum character length is 3 and the maximum is 15.
Note: Voicemail Access PIN will be generated randomly if you leave this field empty.
Generate Randomly
New Voicemail Notification The notification type for new voicemail Required if Enable Voicemail = 1 Permitted value:
  • no: No Email Notifications
  • with_attach: Send Email Notifications with Attachment
  • without_attach: Send Email Notifications without Attachment
Note: New Voicemail Notification will be filled with default value if you leave this field or Email Address empty.
no
After Notification The way to handle voicemail message in mailbox after receiving the message notification via email. Required if Enable Voicemail = 1 & New Voicemail Notification = with_attach Permitted value:
  • no: Do Nothing
  • mark_read: Mark as read
  • delete: Delete Voicemail
    Note: After Notification will be filled with default value no if you leave these fields empty.
no
Required if Enable Voicemail = 1 & New Voicemail Notification = without_attach Permitted value:
  • no: Do Nothing
  • mark_read: Mark as read
    Note: After Notification will be filled with default value no if you leave these fields empty.
no
Play Date and Time Whether to announce arrival time of the message before playing the voicemail message. Required if Enable Voicemail = 1 Permitted value:
  • 0: Disable
  • 1: Enable
Note: Play Date and Time will be filled with default value if you leave this field empty.
0
Play Caller ID Whether to announce caller ID of the party that left the message before playing the voicemail message. Required if Enable Voicemail = 1 Permitted value:
  • 0: Disable
  • 1: Enable
Note: Play Caller ID will be filled with default value if you leave this field empty.
0
Play Message Duration The duration of the message (in minutes) will be announced before playing the voicemail message. Required if Enable Voicemail = 1 Permitted value:
  • 0: Disable
  • 1: Enable
Note: Play Message Duration will be filled with default value if you leave this field empty.
0
Send email notification when the User Password is changed Whether to send email notification when the User Password is changed. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Send email notification when the User Password is changed will be filled with default value if you leave this field empty.
1
Send email notifications on missed calls Whether to send email notifications on missed calls. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Send email notifications on missed calls will be filled with default value if you leave this field empty.
0
Allow the extension to view recordings Whether to allow users to view and manage their own recordings. Required

Permitted value:

  • 0: Disable
  • 1: Enable
Note: Allow the extension to view recordings will be filled with default value if you leave this field empty.
1
Allow users to pause or resume recording Whether to allow users to pause or resume recording. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Allow users to pause or resume recording will be filled with default value if you leave this field empty.
1
All Busy Mode for Endpoints Whether to forward a new incoming call to the Busy destination when one of the endpoints with extension registered is busy in a call. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: All Busy Mode for Endpoints will be filled with default value if you leave this field empty.
0
Call Popup URL Whether to automatically open a custom URL (web page) upon receiving an incoming call. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Call Popup URL will be filled with default value if you leave this field empty.
0
Popup URL The address of third-party URL, followed by the variables that you want to pass. Required if Call Popup URL = 1 The maximum character length is 255. http://example.com/somepage.php?number={{.CallerNumber}}&name={{.CallerDisplayName}}
Communication type The types of calls that will trigger the call popup. Required if Call Popup URL = 1 Permitted value: Internal and Inbound.
  • For multiple types, enter values in order and use & as a separator, e.g. Internal & Inbound.
  • If the value you enter is not permitted, it will be skipped.
Inbound
Trigger Event When the call popup will be automatically triggered. Required if Call Popup URL = 1 Permitted value: Ringing, Answered, and Call End.
Note: Trigger Event will be filled with default value Ringing if you leave the field empty.
Ringing
DTMF Mode The mode for sending DTMF tones. Required Permitted value: rfc4733, info, inband or auto.
Note: DTMF Mode will be filled with default value rfc4733 if you leave this field empty.
rfc4733
Transport The protocol for transport. Required Permitted value: udp, tcp, or tls.
Note: Transport will be filled with default value udp if you leave these fields empty.
udp
Qualify Whether to send the SIP OPTIONS packet periodically to the SIP device to check if the device is online. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Qualify will be filled with default value if you leave this field empty.
1
T.38 Support Whether to support T.38 fax for this extension. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: T.38 Support will be filled with default value if you leave this field empty.
0
NAT Whether to enable NAT for this extension. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: NAT will be filled with default value if you leave this field empty.
1
SRTP Whether to encrypt RTP packets. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: SRTP will be filled with default value if you leave this field empty.
0
Allow Remote Registration Whether to allow user to register a remote SIP extension to PBX. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Allow Remote Registration will be filled with default value if you leave this field empty.
0
Disable Outbound Calls Whether to restrict the user from making outbound calls. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Disable Outbound Calls will be filled with default value if you leave this field empty.
0
Disable Outbound Calls outside Business Hours Whether to restrict the user from making outbound calls outside business hours. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Disable Outbound Calls outside Business Hours will be filled with default value if you leave this field empty.
0
Disallow International Calls Whether to restrict the user from making international calls. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Disable International Calls will be filled with default value if you leave this field empty.
1
Outbound Route Permission Specify the outbound routes that this extension is allowed to use. Optional

Permitted value: one or more outbound route names existed in PBX.

Note:
  • If the outbound route name you enter does not exist in PBX, it will be skipped.
  • For multiple outbound routes, please enter outbound route names and use & as a separator, e.g. name1&name2.
N/A
Max Outbound Call Duration (s) The maximum call duration in seconds for making outbound calls from this extension. Required Only numbers are allowed.

Specially, -1 means follow system and 0 means unlimited.

The maximum character length is 7.

Note: Max Outbound Call Duration (s) will be filled with default value follow_system if you leave these fields empty.
-1
Outbound Call Frequency Restriction The restriction rule(s) that used to limit the extension outbound call frequency within specified time period. Optional

Permitted value: One or more Outbound Call Frequency Restriction names existed in PBX.

Note:
  • Use & to separate multiple names, e.g. name1&name2.
  • If you leave this field empty, it will be filled with default value.
  • If the names you entered are not existing in PBX, it will be skipped.
Default_Ext_Outbound Call Frequency
Linkus Mobile Client Whether to allow the extension user to log in to Linkus Mobile Client. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Linkus Mobile Client will be filled with default value if you leave this field empty.
1
Linkus Desktop Client Whether to allow the extension user to log in to Linkus Desktop Client. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Linkus Desktop Client will be filled with default value if you leave this field empty.
1
Linkus Web Client Whether to allow the extension user to log in to Linkus Web Client. Required Permitted value:
  • 0: Disable
  • 1: Enable
Note: Linkus Web Client will be filled with default value if you leave this field empty.
1