Extensions
Extensions are part of phonegroups and serve as end points for calls, or where calls can be placed from. Extensions are set to use a Class of Service to define how calls from this extension are handled.
Adding an Extension
1) Enter the CLI's configuration mode.
2) Enter the number of the Extension you wish to create. You will be prompted with the minimum required settings. An extension does not necessarily need to be a number, but in most this cases this is recommended.
servername(config)# extension 5000
servername(config-extension 5000)#
|
4) Select a device type. (TabPress "Tab" after device_type
to see available options)
servername(config-extension 5000)# device_type
SIP IAX2 DAHDI VIRTUAL SIP-VIRTUAL
servername(config-extension 5000)# device_type SIP
servername(config-extension 5000)#
Option
servername(config-extension
5000
)# device_type
SIP IAX2 DAHDI VIRTUAL SIP-VIRTUAL
servername(config-extension
5000
)# device_type SIP
servername(config-extension
5000
)#
Description
SIP | Physical phone (such as Polycom) or a software phone (such as Linphone or X-lite) |
IAX2 | Inter-Asterisk exchange |
DAHDI | Phone cards physically installed in computers, not commonly used |
VIRTUAL | Used mainly for mailboxes |
SIP-VIRTUAL | Acts as a secondary extension (or tertiary, if using two) for a SIP device, but is still considering a separate extension. |
5) By default the extension is created using your system defaults. Use the show command to see the default values for the extension.
! Generating running-config !!!!! ! -------------- Extensions ---------------- extension 5000
always_autoanswer no
callerid_number 5000
call_screening no
cos internal+local+ld
device_type SIP
in_directory yes
phonegroup internal
phonemake_id generic
phonemodel_id generic
phone_type Generic
record no
tenant_name default
voicemail_enable no sip
allow ulaw,alaw,adpcm,gsm
call-limit 4
canreinvite no
disallow g723,slin,ilbc,lpc10,g729,speex,g726aal2,g722
host dynamic
nat yes
qualify yes
rtpholdtimeout 60
rtptimeout 60
secret 35712c6fd77554c7d6902ebb5831030f
sendrpid yes
trustrpid no
username 5000 exit
exit
exit
|
6) A couple of settings that may need to be changed first are Phonegroups and Class of Service (cos). Let's see what options we have for these.
carpet_agents hard_surface_agents internal servername(config-extension
internal+local+ld+intl internal+local+ld internal+local internal |
7) Change the phonegroup.
servername(config-extension 5000)# phonegroup
carpet_agents hard_surface_agents internal
servername(config-extension 5000)# phonegroup carpet_agents
|
8) Next change the Class of Service (cos)
servername(config-extension 5000)# cos
internal+local+ld+intl internal+local+ld internal+local internal
servername(config-extension 5000)# cos internal+local
|
9) Afterwards check to ensure the changes were saved.
! Generating running-config !!!!! ! -------------- Extensions ---------------- extension 5000
always_autoanswer no
callerid_number 5000
call_screening no
cos internal+local ### changes saves successfully
device_type SIP
in_directory yes
phonegroup carpet_agents ### changes saves successfully
phonemake_id generic
phonemodel_id generic
phone_type Generic
record no
tenant_name default
voicemail_enable no sip
allow ulaw,alaw,adpcm,gsm
call-limit 4
canreinvite no
disallow g723,slin,ilbc,lpc10,g729,speex,g726aal2,g722
host dynamic
nat yes
qualify yes
rtpholdtimeout 60
rtptimeout 60
secret 35712c6fd77554c7d6902ebb5831030f
sendrpid yes
trustrpid no
username 5000 exit
exit
exit
|
Voicemail Setup
In order to setup voicemail thisVoicemail must be enabled manually on an extension. On most systemssystems, voicemail is disabled by default
1) Enter the CLI's configuration mode.
2) Select the extension to setupset up voicemail on.
vbox-markm(config)# extension
1000 1001 1005 1234 5000 1050 AB 560
vbox-markm(config)# extension 5000
vbox-markm(config-extension 5000)#
|
3) Enable voicemail using the following command.
vbox-markm(config-extension 5000)# voicemail_enable yes
|
4) Use the show command to show voicemail has been enabled. show
! Generating running-config !!!!! ! -------------- Extensions ---------------- extension 5000
always_autoanswer no
callerid_number 5000
call_screening no
cos internal+local+ld
device_type SIP
in_directory yes
phonegroup carpet_agents
phonemake_id generic
phonemodel_id generic
phone_type Generic
record no
tenant_name default
vmail_phonegroup_override internal
voicemail_enable yes ### Voicemail has been enabled sip
allow ulaw,alaw,adpcm,gsm
call-limit 4
canreinvite no
disallow g723,slin,ilbc,lpc10,g729,speex,g726aal2,g722
host dynamic
nat yes
qualify yes
rtpholdtimeout 60
rtptimeout 60
secret 35712c6fd77554c7d6902ebb5831030f
sendrpid yes
trustrpid no
username 5000 exit
voicemail ### Voicemail has been enabled, when
s settings will not show.
format sln
override_phonegroup_name internal
pin 5000
voicemail yes exit
exit
exit
|
5) There are additional voicemail options, such as the option to setsetting an email thatto voicemailforward can be forwarded to.voicemail.
vbox-markm(config-extension 5000 voicemail)# ### Use ? to see the available options, it will also show the description as shown below
attach Enable/Disable attach voicemail recording to email
callback Context to call back from
delete Enable/Disable deleting voicemail from the server after notification
dialout Context to dial out from (option 4 from advanced menu if enabled) do
To run exec commands in config mode
email Email address to use when sending voicemail email notification
envelope Enable/Disable envelope information playback before message playback
exit Exit from this level (with notification of incomplete config)
forcegreetings Force greeting to be recorded if the mailbox password is the same as the mailbox number
forcename Force name to be recorded if the mailbox password is the same as the mailbox number
format Format for the voicemail recording
fromstring The 'From' name when sending a voicemail email notification
hidefromdir Enable/Disable hiding this mailbox from the company directory
maxgreetingstime Maximum number of seconds for a voicemail greeting
maxlogins Maximum number of failed login attempts before hanging up on user
maxmsgs Maximum number of messages that this voicemail box can contain before it is considered full
maxsecs Maximum number of seconds that a voicemail message can be
minsecs Minimum number of seconds that a voicemail must be in order to be saved
nextaftercmd Enable/Disable automatically proceeding to the next message after the user enters a command
no Clear setting
operator Enable/Disable the ability for the caller to dial 0 from voicemail
override_phonegroup_name Optionally put this mailbox into a different phonegroup than the one the extension is a part of
pin (*) Voicemail pin number
portal_voicemail_folders_hide
review Enable/Disable the ability for the caller leaving a message to review and/or rerecord message before saving it
saycid Enable/Disable say callerid for voicemail message
sayduration Enable/Disable saying the message duration before playing the message
saydurationm Minimum number of minutes of duration needed when saying the duration
sendvoicemail Enable/Disable the ability for the user to compose and send a voicemail while inside voicemail (option 5 from advanced menu if enabled)
show Show the running-config for the current item
silencethreshold What level do we consider silence. Lower numbers mean more sensitive
tz Timezone to use for this mailbox
voicemail
|
6) Enable the voicemail to email feature, then set the appropriateemail emailwhere voicemail should be forwardedforwarded, to.and Thenthen use the show command to ensure your settingsettings were savedsaved.
vbox-markm(config-extension 5000 voicemail)# email
vbox-markm(config-extension 5000 voicemail)# show ! Generating running-config !!!!! ! -------------- Extensions ---------------- extension 5000
always_autoanswer no
callerid_number 5000
call_screening no
cos internal+local+ld
device_type SIP
in_directory yes
phonegroup carpet_agents
phonemake_id generic
phonemodel_id generic
phone_type Generic
record no
tenant_name default
vmail_phonegroup_override internal
voicemail_enable yes sip
allow ulaw,alaw,adpcm,gsm
call-limit 4
canreinvite no
disallow g723,slin,ilbc,lpc10,g729,speex,g726aal2,g722
host dynamic
nat yes
qualify yes
rtpholdtimeout 60
rtptimeout 60
secret 35712c6fd77554c7d6902ebb5831030f
sendrpid yes
trustrpid no
username 5000 exit
voicemail
attach yes ### saved successfully
email
" "
format sln
override_phonegroup_name internal
pin 5000
voicemail yes exit
exit
exit
|
It is important to remember that youto use the correct email address. That being saidsaid, it is NOT recommended to disable voicemail's saving tothe voicemail on the extension itself toand only have it sent through email since your voicemail could be sentlost only through email, in the event thatif there is something wrong outside of the Intellasoft platform (transmission issues, email server (SMTP) issues).
7) Lastly it is important to set a PIN for the voicemail, so the user of the extension can access their voicemail securely and prevent unwanted access.
vbox-markm(config-extension 5000 voicemail)# pin 0011
|
Extension Settings Description
You can also use the "?" key to view the description while in the CLI. * indicates a requiresrequired setting.
Setting |
Description |
all_call_forward | Call forwarding |
always_autoanswer | Whether or not to send an always answer header when calling this extension |
autoanswergroup_id | |
busy_call_forward | If the extension is busy or unava |
call_screening | |
callerid_name | Caller ID name |
callerid_number | Caller ID number |
cos | Class of service when this extension makes a call |
department_name | |
device_type | (*) Protocol that this device will use |
did | Inbound DID (Direct Inward Dialing) |
do | To run exec commands in config mode |
exit | Exit from this level (with notification of incomplete config) |
external_callerid | What callerid to use when the extension dials out a route |
iax | Change IAX-specific extension settings |
in_directory | Enable/Disable showing this extension in company directories |
no | Clear settings |
override_extension | Override the dialable extension |
phone_type | Extension type |
phonegroup | Phonegroup that this extension is a member of |
phonemake_id | |
phonemodel_id | |
polycom | MAC Address of the physical phone this extension is assigned to |
polycom_reg | Registration number on the physical phone (ie: polycom reg number) |
record | Whether to record all calls to/from this device |
ringseconds_till_voicemail | |
show | Show the running-config for the current item |
sip | Change SIP-specific extension settings |
tenant_name | Tenant that owns this phone |
twinning_number | Twinning number. Ring an external number such as a cell phone. |
user_id | |
username | Web portal username that is assigned to this extension (Note: a username can be assigned to more than one extension) |
vmail_phonegroup_override | Override what phonegroup this extension's mailbox is a member of |
vmail_subscribe_override | Override what mailbox this extension subscribes to |
voicemail | Change voicemail settings |
voicemail_enable | Enable/disable voicemail for this extension |