Reference9:PBX/Objects/DTMF Features

From innovaphone wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

The DTMF Features PBX object is no longer used just to configure call diversions via DTMF but also to use several other features. This is usefull for analog, dect (which already have their own feature codes) and softphone devices.

Each configured feature code will be represented as own pbx object, but will be only editable through the main object.

See Reference9:PBX/Objects#General_Object_Properties for generic object properties.

Configuration

Featurecodes can contain variable digits, which are defined by an '$', followed by a certain number of digits in brackets like '$(3)', which means, that three digits must be dialed or by a '#', which means, that a not specified count of digits is dialed, completed by a #, like '$#'.
Note: do not use a '$' without brackets or '#', otherwise the code won't work as intended.

You can configure feature codes according to the following image:

DTMF Features

For all features a default for the invocation code is defined, but this default can be changed on a per system basis. The following features are available:

Mobility features

Feature codes used in mobility scenarios have no default code and are disabled per default.
If you want to use these codes you have to define their numbers according to your numbering plan, because one can't use the digits '*' and '#' from the mobile phone.

Not working features with mobility

Mobility users currently can't use the following features:

  • pickup
  • park
  • call completion

Calling over a gateway object

From V8 Hotfix 3 on it won't be possible to call over a gateway object into the dtmf object, e.g. to prevent incoming mobility calls, which can't be assigned to a mobility user, to set a CFU on a trunk object.

Call handling

If you are calling the feature code with enblock dialing (setup contains the complete code), the call won't be connected, so there won't be any costs for this call.
If you are calling with overlap dialing, the call will be connected just for the feature codes join and leave a single group.

Features

CFU activate/deactivate

These codes allows to activate and deactivate unconditional call forward for a given endpoint. The default codes are *21*$# to activate and #21# to deactivate. $ stands for the number to which calls are forwarded.

CFB activate/deactivate

These codes allows to activate and deactivate call forward on busy for a given endpoint. The default codes are *67*$# to activate and #67# to deactivate. $ stands for the number to which calls are forwarded.

CFNR activate/deactivate

These codes allows to activate and deactivate call forward on no response for a given endpoint. The default codes are *61*$# to activate and #61# to deactivate. $ stands for the number to which calls are forwarded.

Pickup Group

With this feature code any call which is ringing within the configured groups can be picked.

The default code is *0#

Please note that pickup is not supported for mobility calls (neither group nor directed).

Pickup Directed

With this feature code a call which is ringing at a indicated extension number can be picked.

The default code is *0*$#. $ stands for the extension number from which the call shall be picked.

Park

These codes allow to park and uppark a call at the own extension number to a specified parking position.

The default code is *16$(1) to park and #16$(1) to unpark. $(1) stands for the single digit park position.

To dial the code for the park a consultation call has to be initiated with R (Flash).

Multidigit park positions are now possible. To use multidigit park positions, define the code like *16$#. $# stands for one or more digits, terminated by #. No digit will be canceled.

Park To

These codes allow to park and unpark a call to a specified park position at an specified extension number.

The default code is *17$(1)$# to park and #17$(1)$# to unpark. $(1) stands for the one digit park position and $ for the extension number.

To dial the code for the park a consultation call has to be initiated with R (Flash).

Multidigit park positions are now possible. To use multidigit park positions, define the code like #16$#. $# stands for one or more digits, terminated by #. No digit will be canceled.

Completion of Calls/CC Cancel

This code has to be dialed to initiate call completion to busy subscriber/call completion no response (ccbs/ccnr). The default code for call completion is *37*$#. $ stands for the number to call complete. The default code to cancel an active call completion is #37*$#.

Join/Leave Group

This code can be used to join or leave dynamic groups. After dialing the first part of the code, e.g. *31*, you get the first entry of an alphabetical sorted list of all available groups. You can scroll through this list using the '*' for the next group and the '1' for the previous group. You select the desired group with '#'.

Example with five groups:

1. group1   dynamic in
2. group2   dynamic in
3. group3   dynamic out
4. group4   static (static groups won't be shown)
5. group5   dynamic in

If you now dial the default join code *31*, you will first get group1 displayed. By pressing * twice, you have group3 and by using # you are joining this group.

If you are dialing the default leave code #31*, you will first get group1 too, as all in and out groups are shown independet of their current state.

There is also the possibility to select the desired group by index. So if you know that your desired group to join is the third group in the list (just the list of available groups, e.g. out state OR in state), just dial the index after the default code:
#31*3# would select the third group, in this case group3 and leave it.

 Group index 1 has to be followed by a *, as the 1 jumps to the previous group and the following * will jump to the next group, which is index 1 again.
 From V8 Hotfix 9 onwards, dynamic in groups will be preceeded with '* '

Join/Leave all groups

With this feature code you can join or leave all dynamic groups at once.
Default code for joining: *32#
Default code for leaving: #32#

Enable/disable mobility

With this feature code you can enable or disable the mobility by calling from the mobile phone.
There are no default codes for these features. Suitable codes could look like this:
Enabling: 041
Disabling: 042

Enable/disable mobility call waiting

With this feature code you can enable or disable the mobility call waiting flag by calling from the mobile phone.
There are no default codes for these features. Suitable codes could look like this:
enabling: 043
disabling: 044

Un/Set presence

This allows you to set presence information for the calling user.
There is no default code for this feature, as you have to define it according to your numbering plan. There is one parameters for this feature. It sets the activity and the note to a preconfigured pair (exactly one digit).
So a suitable code could look like 040$(1).

You have a third tab on the configuration page of the pbx dtmf object, where you can configure 10 activity/note pairs (digit 0 - 9).

The unset presence feature code is used to unset the current presence activity and note. A suitable code could look like 041, as no parameter is needed..

For both the set and unset presence feature codes, a further parameter can be configured to enable/disable mobility.
If given, the parameter must be one char long and enables mobility on digit '1' and disables it on digit '0'.

A suitable set presence code would be 040$(1)$(1) and unset 041$(1).

Common node and loc configuration for DTMF CTRL

Concept 1

pbx - empty
node - empty
local - on

Object should be called on the pbx, where the endpoint is registered. Independent of node/pbx of the calling endpoint and also from escapes, which might be set on the node of the calling endpoint.

DTMF CTRL is replicated via LDAP, independent of pbx/node.

Concept 2

pbx - empty
node - root
local - off

Similar to 1, but DTMF CTRL can't be called out of nodes with prefixes. If an endpoint is registered on a slave, but redirected from a master, the call is rerouted to master and back.

DTMF CTRL is replicated via LDAP, independent of pbx.

Concept 3

pbx - name of pbx
node - name of node
local - off

Must be dialed with node prefix if called from another node. Is processed on configured pbx.

Known Problems

An alarm might occur if you upgrade from a V6, because the pickup string is currently configured under PBX->General. See the alarm description for more information.

Join/leave Group over Number Map if you have more than 9 Groups

If you use more than 9 groups and a number-map object to join/leave groups you have to use a * for each digit from the group number. Example. In your number map you map the *31# for the first group, *31**# for the second group etc.