Incoming call handling
From SIPfoundry sipx, The Open Source SIP PBX for Linux - Calivia
Contents |
[edit] How to define incoming call handling
Call handling parameters determine how incoming calls will be handled by a sipXphone. These parameters set:
- Alert method for incoming calls
- Call forwarding with destinations for forwarded calls
- Call waiting
- Do not disturb with redirection for incoming calls
- Appearance of inbound caller IDs
Because end users may have different and changing needs for these settings, the administrative password is not required to define values for most call handling parameters. Users can supply values for most of these parameters through:
- The browser-based interface: from the sipXphone Web home page, click Preferences, then CallHandling.
- The phone top interface: start the Prefs application, then select Call Handling. An additional parameter, accessible only by administrators, controls access to the phone top interface for call handling preferences.
[edit] Restricting phone top changes
You can change the interfaces that end users can use to set their call handling preferences: through the Prefs application on the phone top as well as through the browser-based interface, or with the browser-based interface only.
PHONESET_PREFS_CALL_HANDLING
This parameter allows you to remove the Call Handling option from the Prefs application on the phone top, so that users cannot change call handling preferences directly on a phone:
- If set to ENABLE, the Prefs application includes the Call Handling option. The default is ENABLE.
- If set to DISABLE, the Prefs application does not include Call Handling. End users can use only the browser-based interface to change call handling settings.
This parameter can only be set by an administrator: in the browser-based interface, click Administration: Phone Configuration then scroll to the Additional Parameters text box at the bottom of this page.
[edit] Selecting the incoming call alert
PHONESET_RINGER
This parameter determines how the user is alerted to an incoming call. Options are VISUAL, AUDIBLE, or BOTH. By default, this parameter is set to BOTH.
- VISUAL flashes the phone’s message waiting indicator.
- AUDIBLE plays the ring tone. Alternatively, if a call is in progress and PHONESET_CALL_WAITING_BEHAVIOR is set to ALERT, a call waiting beep plays.
- BOTH results in both alert types.
Phone users can set alerts with the browser-based or phone top interface (see PHONESET_PREFS_CALL_HANDLING).
[edit] Call forwarding
Call forwarding parameters define a phone’s response to incoming calls under specific circumstances (that is, forward all of the time, on no answer, or when busy). The values set for these parameters apply to the phone as a whole; you specify whether or not this configuration applies to each of the phone’s lines.
PHONESET_FORWARD_UNCONDITIONAL
When this parameter is set to ENABLE, the phone immediately forwards all calls to the destination specified by the SIP_FORWARD_UNCONDITIONAL parameter. If a phone is set to forward all calls, it ignores the setting for the PHONESET_AVAILABLE_BEHAVIOR parameter. Options are ENABLE and DISABLE. By default, this parameter is set to DISABLE. When this parameter is set to ENABLE, this reminder icon displays on the phone’s home screen:
SIP_FORWARD_UNCONDITIONAL
You use this parameter to define the address of another phone or voice mailbox. All incoming calls are redirected to this SIP URL or telephone number automatically when PHONESET_FORWARD_UNCONDITIONAL is set to ENABLE.
PHONESET_AVAILABLE_BEHAVIOR
When PHONESET_FORWARD_UNCONDITIONAL is set to DISABLE, this parameter defines what happens when this phone receives an incoming call. Options are FORWARD_ON_NO_ ANSWER and RING. By default, this parameter is set to RING. The phone handles incoming calls based on both its current status, idle or busy, and the setting of this parameter:
- If the phone is idle (available) when a call comes in, it will either RING or FORWARD_ON_NO_ANSWER, as set for this parameter.
- If the phone is busy (not available) when a call comes in, the phone uses the setting for the PHONESET_CALL_WAITING_BEHAVIOR parameter, or for the PHONESET_BUSY_BEHAVIOR parameter if call waiting is not enabled.
If you set this parameter to FORWARD_ON_NO_ ANSWER, you should also set:
- A destination address for SIP_FORWARD_ON_NO_ANSWER.
- A time period for PHONESET_NO_ANSWER_TIMEOUT.
SIP_FORWARD_ON_NO_ANSWER
You use this parameter to define the address of another phone or voice mailbox. Incoming calls are redirected to this destination automatically if your phone is idle; that is, you do not answer. To enable this feature, you set PHONESET_AVAILABLE_BEHAVIOR to FORWARD_ON_NO_ANSWER.
PHONESET_NO_ANSWER_TIMEOUT
This parameter defines the number of seconds that a phone must ring before it is considered to be unanswered (idle). This parameter defaults to 24; that is, after four rings of six seconds each. Tip: Enter a value that is a multiple of six for this parameter: 18, 24, 36, etc.
[edit] Setting up call waiting
PHONESET_CALL_WAITING_BEHAVIOR
You set this parameter to define whether or not to use call waiting when the phone is busy. The options for this parameter are ALERT or BUSY.
- By default, this parameter is set to ALERT. This enables call waiting and overrides any setting for the PHONESET_BUSY_BEHAVIOR parameter.
- If BUSY, call waiting is disabled and the PHONESET_BUSY_BEHAVIOR value is used.
PHONESET_BUSY_BEHAVIOR
This parameter defines what will happen when a call is placed to this phone and it is busy. To enable this parameter, PHONESET_CALL_WAITING_BEHAVIOR must be set to BUSY. You can set this parameter to BUSY or FORWARD. By default, this parameter is set to BUSY.
Set to BUSY: The caller hears a continuous busy signal.
Set to FORWARD: Forwards any incoming calls to a previously defined destination. Use the SIP_FORWARD_ON_BUSY parameter to define the address of the forwarding destination.
SIP_FORWARD_ON_BUSY
If you set PHONESET_BUSY_BEHAVIOR to FORWARD, this parameter defines the address of another phone or voice mailbox. Incoming calls are redirected to this SIP URL or telephone number automatically if the phone is busy.
[edit] Setting up Do Not Disturb
Users can override all of their other call handling preferences by enabling the Do Not Disturb feature. Do Not Disturb prevents the phone from giving any visual or audible alerts for incoming calls. Two parameters control the Do Not Disturb feature:
PHONESET_DND PHONESET_DND_METHOD
All phone users can set the Do Not Disturb feature; however, only an administrator can set the handling method for incoming calls when Do Not Disturb is enabled. Tip: The setting for Do Not Disturb applies to all phone lines.
PHONESET_DND
All users can set the PHONESET_DND parameter to ENABLE or DISABLE using the browser-based or phone top interface. When a user enables this feature, the phone does not provide notification for any incoming calls. Instead, incoming calls are handled as specified by the PHONESET_DND_METHOD. By default, this parameter is set to DISABLE. When Do Not Disturb is enabled, this reminder icon displays on the phone’s home screen. Tip: When enabled, Do Not Disturb overrides all other call handing options.
PHONESET_DND_METHOD
Although any user can control when to enable or disable the Do Not Disturb feature, only administrators can set the PHONESET_DND_METHOD parameter to define how incoming calls will be handled when Do Not Disturb is enabled. You can set the PHONESET_DND_METHOD parameter to SEND_BUSY, FORWARD_ON_BUSY, or FORWARD_ON_NO_ANSWER through the browser-based interface. By default, this parameter is set to FORWARD_ ON_BUSY.
Results when PHONESET_DND = ENABLE:
- Set to SEND_BUSY: At the SIP messaging level, the phone sends a busy response to all call invitations. You can optionally configure a SIP server in your network to act on these messages and redirect “do not disturb” calls to another destination; otherwise, the caller hears a busy signal.
- Set to FORWARD_ON_BUSY: The phone responds to incoming calls as though it is busy. The caller either hears a busy signal or is forwarded if a destination has been specified as follows: PHONESET_CALL_WAITING_BEHAVIOR = BUSY, PHONESET_BUSY_BEHAVIOR = FORWARD, and SIP_FORWARD_ON_BUSY = valid address.
- Set to FORWARD_ON_NO_ANSWER: The phone responds to incoming calls as though there is no answer. The caller either hears ringing or is forwarded immediately if a destination has been specified as follows: PHONESET_AVAILABLE_BEHAVIOR = FORWARD_ON_NO_ANSWER and SIP_FORWARD_ON_NO_ANSWER = a valid address. Note: that PHONESET_NO_ANSWER_TIMEOUT is not applied.
The method you select for this parameter is invoked only when PHONESET_DND is set to ENABLE for the phone. The administrative password is required to set the PHONESET_DND_METHOD. You use only the browser-based interface to set this parameter.
[edit] Defining inbound caller ID format
PHONESET_REMOTE_ID_FORMAT
This parameter customizes the caller ID information presented for incoming calls. Caller ID information displays on these screens:
- Receiving Call
- Held Calls
- Conference Call
- Call Log
To customize the data that displays, you specify one or more of these options to derive data from the calling party's SIP URL. Option Description
- {displayname}: The display name from the SIP URL. If no display name is provided, “Unknown” displays.
- {hostname}: The domain name of the host in the SIP URL.
- {name}: The display name from the SIP URL (if available); otherwise, the resource ID is presented. If no resource ID is provided, “Unknown” displays.
- {sipurl}: The SIP URL in the format {username}@{hostname}.
- {username}: The resource ID from the SIP URL.
- \n: Defines a line feed. A maximum of two lines display on the Receiving Call screen; other screens display only the first line.
Defaults to {name}\n{sipurl}. This parameter can only be set by an administrator: in the browser-based interface, click Administration: Phone Configuration then scroll to the Additional Parameters text box at the bottom of this page.
[edit] Defining the locale for sipXphone
PHONESET_LOCALE_COUNTRY
Stores a two-character ISO country code that identifies the country where this phone is located. Using the specified country code, the phone plays locale-specific versions of the following call progress tones:
- Dial Tone: the phone system is ready to receive call information.
- Ringback Tone: a connection has been made and the dialed address is ringing.
- Busy Tone: the destination address is busy.
- Call Failed Tone: the destination address cannot be reached for reasons other than busy.
Defaults to US. Supply one of these valid ISO codes:
DE Germany FR France GB Great Britain IL Israel NL Netherlands US United States
Tip: If you supply any other ISO code, the phone uses US. This parameter can only be set by an administrator: in the browser-based interface, click Administration: Phone Configuration then scroll to the Additional Parameters text box at the bottom of this page.
