Extensions

Overview

On IC-talk HC Chan_SIP is the preferred option for an extension please DO NOT use PJSIP or other options unless specifically instructed to do so for a specific item. The default port number will be 5160 for Chan_SIP.

This guide walks you through information related to SIP extensions.

This guide is for chan_sip. In Asterisk 12+ there is a PJSIP option which is not covered on this page.
Options will vary based on installed modules. Configuration of these settings is covered by their respective user guides.

Logging in

From the top menu click Modules / Applications
From the drop down click Extensions

Adding a SIP Extension

There are multiple ways to add an extension but we shall show a quick method and the full comprehensive options;

Quick Create Extensions

From the Extensions landing page click on the Quick Create Extension button.
A pop up window will appear complete this with the desired details using the format shown below for full explanations of each item requested see further below in full extension configuration

On pressing finish the user will be created and the password for the user will be emailed out tot he email address for the user that has been specified. If using an IC-talk HC or Sangoma handset simply plug in and once booted select Login Ext on the screen, enter your extension number followed by the PIN number entered in the quick setup and your device will connect to your system.

Adding an Extension in full user mode

From the Extensions landing page click on the Add New Chan_SIP Extension button.

General

Add Extension

User Extension

This will be the extension number associated with this user and cannot be changed once saved. We recommend using 3- or 4-digit extension numbers.

Display Name

This is the name associated with this extension and can be edited any time. This will become the Caller ID Name. Only enter the name, NOT the number.

Outbound CID

Overrides the CallerID when dialing out a trunk. Any setting here will override the common outbound CallerID set in the Trunks module. Format: "caller name" <#######>

Leave this field blank to disable the outbound CallerID feature for this user. If you leave it blank, the system will use the route or trunk Caller ID, if set.

Secret

Password (secret) configured for the device. Should be alphanumeric with at least 2 letters and numbers to keep secure. A secret is auto-generated but you may edit it. A color-coded bar will display the strength of the secret, ranging from "really weak" to "strong."

User Manager Settings

Link to a Default User

Select a user that this extension should be linked to in the User Management module. Default = Create New User. An extension may only be linked to one user, and a user may only be linked to one extension.

- Create New User: Creates a new user in User Manager that will be linked to this extension.
- None: The extension will not be associated with a user in User Manager
- Existing User: If you have any existing users in User Manager who are not already linked to an extension, you can select one here in order to link the user to this extension.

Username

If Create New User is selected above, this will be the new user's login username. If you leave the Username field is blank (grayed-out), the username will be the same as the extension number. To customize the username, check the Use Custom Username box and enter a username.

Password for New User

If Create New User is selected above, this will be the auto-generated user's new password. A password is automatically generated, but you can edit it here.

Groups

If Create New User is selected above, or if you are linking this extension to an existing user, you can add the user to one or more groups. Groups are defined in the User Management module, so if you haven't created any groups, none will show up here. To add this user to a group, click inside the field, and available groups will show up in a menu. You can start typing to quickly find a group. Click on a group name to add it to the field. Repeat the process if you with to enter multiple groups.

Voicemail

Click on the Voicemail tab.
If you wish to enable voicemail, click the Yes button next to Enabled in order to allow editing the options below.

Voicemail

Enabled

Yes/No: Whether to enable voicemail for the user.

Voicemail Password

Enter the password (numbers only) the user will use to access the voicemail system. If left blank, it will default to the extension number. The user can change the password after logging into the voicemail system (*98) with a phone.

Require From Same Extension

Yes/No: Whether to require the user to enter their password after they reach the voicemail system from their own extension, by dialing *97. This option does not apply to *98 calls, which will always prompt for a password. For security purposes, a Yes setting is recommended in an environment where other users will have physical access to this extension.

Disable ( * ) in Voicemail Menu

Yes/No: Whether to disable access to the voicemail menu. Default = Yes. If set to Yes, a user will not be able to access the voicemail menu by pressing "*". If you have no plans to access your mailbox remotely, set this to Yes. If set to No, the user can access voicemail remotely by calling into their extension and pressing "*" to reach the menu.

Email Address

Optional - The e-mail that voicemail notifications will be sent to. Further down the page, you have the option of whether to attach the actual voicemail message to the e-mail.

Pager Email Address

Optional - A pager e-mail address or mobile email address that short voicemail notifications will be sent to.

Email Attachment

Yes/No: Whether to attach the voicemail to the e-mail notification. Requires an email address to be set above.

Play CID

Yes/No: Whether to read back the caller's telephone number prior to playing the voicemail, just after announcing the date and time the message was left.

Play Envelope

Yes/No: Whether the system will play the message envelope information (date/time) before playing the voicemail message. This setting does not affect the operation of the envelope option in the advanced voicemail menu.

Delete Voicemail

Yes/No: Whether to delete the voicemail message from the mailbox after it is e-mailed to the user. If set to Yes, this would provide functionality that allows users to receive their voicemail via e-mail alone, rather than needing to retrieve it from the web interface or a telephone.

If Delete Voicemail = Yes, then you MUST set an e-mail address for the user above, and also set Email Attachment = Yes. Otherwise, the voicemail message would be lost forever, because it would not be e-mailed, and would be deleted from the system.

VM Settings

Optional: Advanced settings. Enter voicemail options, separated by the pipe symbol (|). For example, "review=yes | maxmessage=60" May be left blank.

VM Context

This is the Voicemail Context, which is normally set to "default." Do not change unless you understand the implications.

VMX Locater™

VMX Locater is designed to help a caller reach an operator and/or find you when you are not at your main phone. If enabled, the user will want to consider recording voicemail greetings that instruct a caller on which options to press (0, 1, and/or 2).

Whenever you enter information into the 0, 1, and/or 2 options below, you should run a test to make sure the number is functional, because otherwise the caller might become stranded or receive messages about a number being invalid.

Enabled

Yes/No: Whether to enable the VMX Locater feature. Set to Yes if you would like to enable this feature and edit the options below.

Use When

Select one or more of the buttons to enable VMX Locater for these types of greetings: Unavailable, Busy, and/or Temporary.

Voicemail Instructions

Yes/No: Whether to play instructions after playing your greeting. If set to No, only a beep will be played after your personal voicemail greeting.

Press 0

Check the Go to Operator box to send the caller to the operator when they press 0. Uncheck the Go to Operator box and enter an alternative destination if you want the caller to be sent to a different destination when they press 0. This feature is still accessible to callers even when VMX Locater is disabled for the user.

Press 1

Optional - Enter a destination to send the caller to when they press 1. This can be an internal extension, ring group, queue, or external number such as a cell phone number.

Press 2

Optional - Enter a destination to send the caller to when they press 2. This can be an internal extension, ring group, queue, or external number such as a cell phone number.

Find Me / Follow Me

Click on the Find Me / Follow Me tab.
Find Me / Follow Me is enabled by default here so that you may edit the settings. After entering settings, you can disable it if desired.

General Settings

Enabled

Yes/No: Whether to enable Find Me / Follow Me. Must be set to Yes (at least temporarily) in order to edit other settings on this page. If you leave it set to Yes, Find Me / Follow Me will be active for this extension when you save the extension and apply config. You can set to No to disable Find Me / Follow Me for an extension until the user activates it.

Initial Ring Time

Use the drop-down menu to select initial ring time, in seconds. This is the number of seconds to ring the primary extension prior to proceeding to the follow-me list. If "0," the primary extension will not be rung before proceeding to the follow-me list. The extension can also be included in the follow-me list.

Ring Strategy

- ringallv2: ring Extension for duration set in Initial Ring Time, and then, while continuing call to extension, ring Follow-Me List for duration set in Ring Time.
- ringall: ring Extension for duration set in Initial Ring Time, and then terminate call to Extension and ring Follow-Me List for duration set in Ring Time.
- hunt: take turns ringing each available extension
- memoryhunt: ring first extension in the list, then ring the 1st and 2nd extension, then ring 1st 2nd and 3rd extension in the list.... etc.
- *-prim: these modes act as described above. However, if the primary extension (first in list) is occupied, the other extensions will not be rung. If the primary is in do-not-disturb (DND) mode, it won't be rung. If the primary is in call forward (CF) unconditional mode, then all will be rung.
- firstavailable: ring only the first available channel
- firstnotonphone: ring only the first channel which is not off hook - ignore CW

Ring Time

Time in seconds that the phones will ring. For all hunt-style ring strategies, this is the time for each iteration of phone(s) that are rung.

Follow-Me List

Enter a list of extensions to ring, one per line, or use the Extension Quick Pick menu below. You can include an extension on a remote system, or an external number, by suffixing a number with a hash (#). ex: 2448089# would dial 2448089 on the appropriate trunk (see Outbound Routing).

Extension Quick Pick

This drop-down menu gives you the option to select existing extensions to add to the Follow-Me List above.

Announcement

Select the message to be played to the caller before dialing the find me / follow me list. Default = none. The drop-down menu shows available system recordings. To add additional recordings, please use the System Recordings module.

Play Music On Hold

If you select a Music on Hold class to play, instead of the default "Ring," the caller will hear that MoH instead of ringing while they are waiting for someone to pick up.

CID Name Prefix

Optional - You can optionally prefix the Caller ID name when ringing extensions in this group. For example, if you prefix with "Sales:", a call from John Doe would display as "Sales:John Doe" on the find me / follow me list extensions that ring.

Alert Info

Optional - You can optionally include an Alert Info, which can create distinctive rings on SIP phones.

Call Confirmation Configuration

Confirm Calls

Yes/No: Whether to confirm external calls. Call confirmation requires the remote party to press 1 to accept the call. This can help prevent an unanswered find me / follow me call from reaching an external voicemail box. This feature only works with the ringall or ringall-prim ring strategies.

Remote Announce

Message to be played to the person receiving the call if Confirm Calls = Yes. You can use the default message or select one of your System Recordings.

Too-Late Announce

Message to be played to the person receiving the call if Confirm Calls = Yes and the call has already been accepted elsewhere.

Change External CID Configuration

Mode

Default: Transmits the caller's CID if allowed by the trunk.
Fixed CID Value: Always transmit the Fixed CID Value below.
Outside Calls Fixed CID Value: Transmit the Fixed CID Value below on calls that come in from outside only. Internal extension-to-extension calls will continue to operate in default mode.
Use Dialed Number: Transmit the number that was dialed as the CID for calls coming from outside. Internal extension-to-extension calls will continue to operate in default mode. There must be a DID on the inbound route for this. This will be BLOCKED on trunks that block foreign CallerID.
Force Dialed Number: Transmit the number that was dialed as the CID for calls coming from outside. Internal extension-to-extension calls will continue to operate in default mode. There must be a DID on the inbound route for this. This WILL be transmitted on trunks that block foreign CallerID.

Fixed CID Value

Fixed value to replace the CID used with some of the modes above. Should be in a format of digits only with an option of E164 format using a leading "+".

Destinations

No Answer

Optional destination call is routed to when the call is not answered on an otherwise idle phone. If the phone is in use and the call is simply ignored, then the busy destination will be used.

Remember to set Enabled = No at the top of the page after you're done changing settings if you do not want find me / follow me to be active. Otherwise, it will be active for the extension after you save settings and apply config.

Advanced

Click on the Advanced tab.
There are many settings in this tab. See below for explanations of the options.

Assigned DID/CID

DID Description

A description for this DID, such as "Fax"

Add Inbound DID

A DID that is directly associated with this extension. The DID should be in the same format as provided by the provider (e.g. full number, 4 digits for 10x4, etc). Format should be: XXXXXXXXXX

Add Inbound CID

Add a CID for more specific DID + CID routing. A DID must be specified in the above Add Inbound DID field. In addition to standard dial sequences, you can also enter Private, Blocked, Unknown, Restricted, Anonymous, Withheld, and Unavailable in order to catch these special cases if the Telco transmits them.