Top
Basic Concepts
DTMF Maps
A DTMF map (also called digit map or dial map) allows you to compare the number users just dialed to a pattern string. Depending on the DTMF maps, the call can be accepted or rejected.
- If the dialed number matches an entry of the Allowed DTMF Map, the call is accepted.
- If the dialed number matches an entry of the Refused DTMF Map table, then the call is refused and an error tone i.e. reorder tone, network congestion, or fast busy tone is played.
- If the dialed number matches no entry of either the Allowed DTMF Map or the Refused DTMF Map, the call is refused and an error tone i.e. reorder tone, network congestion, or fast busy tone is played.
- If the dialed number matches an entry of both the Allowed DTMF Map and the Refused DTMF Map, the call is refused and
an error tone i.e. reorder tone, network congestion, or fast busy tone is played.Note: The Refused DTMF Map table has precedence over the Allowed DTMF Map table.
Top
DTMF Maps Order
The order in which the DTMF maps are used is very important. You must use specific DTMF maps first and then more generic ones. Otherwise you may end up with all calls being directed the same way. This is true when creating the DTMF maps in the Allowed DTMF Map table and in the DTMF Map field of this table.
- all employees have a 3-digit extension all starting with 1, 2 or 3.
- All managers have an extension finishing with 9
[1-3]x9
[1-3]xx
calls
made to a managers, will always be redirected to the Manager's assistant extension. [1-3]xx
[1-3]x9
managers will always
directly receive their calls without going through the Manager's assistant extension. Top
DTMF Map vs DTMF Map Transformation
When creating DTMF maps to allow or refuse calls, the DTMF maps must be written and a transformation to be applied to the dialed number may be required.
The DTMF map is used to recognise the dialed numbers and the transformation modifies the dialed numbers before sending the call. A transformation is not mandatory, it depends if the dialed number must be changed or not before the call is made.
For example, when the dialed number is the extension of a colleague, no transformation is required. The DTMF map will recognise that the dialed numbers are the allowed extension of a colleague, and the call will be made with the dialed number.
However, in the example where calls made to management extensions are redirected to the management's assistant, a transformation is required. For example, if the DTMF is xx9 and the transformation 123, this means that whenever an extension finishing by 9 is dialed, the call is sent to extension 123.
Top
DTMF Maps Syntax
The permitted DTMF map syntax is taken from the core MGCP specification, RFC 2705, section 3.4:
DigitMap = DigitString / '(' DigitStringList ')'
DigitStringList = DigitString 0*( '|' DigitString )
DigitString = 1*(DigitStringElement)
DigitStringElement = DigitPosition ['.']
DigitPosition = DigitMapLetter / DigitMapRange
DigitMapLetter = DIGIT / '#' / '*' / 'A' / 'B' / 'C' / 'D' / 'T'
DigitMapRange = 'x' / '[' 1*DigitLetter ']'
DigitLetter ::= *((DIGIT '-' DIGIT ) / DigitMapLetter)
Top
DTMF Maps Special Characters
DTMF maps use specific characters and digits in a particular syntax
Character | Use |
---|---|
Digits (0, 1, 2... 9) | Indicates specific digits in a telephone number expression. |
T | The Timer indicates that if users have not dialed a digit for the time defined, it is likely that they have finished dialing and the SIP Server can make the call. |
x | Matches any digit, excluding “#” and “*”. |
| | Indicates a choice of matching expressions (OR). Note: Enclose the DTMF map in
parenthesis when using the “|” option. |
. | Matches an arbitrary number of occurrences of the preceding digit, including 0. |
[ | Indicates the start of a range of characters. |
] | Indicates the end of a range of characters. |
Top
Basic Tasks
Configuring Endpoint-Specific DTMF Timers
- Go to Telephony/DTMF Maps.
- In the General Configuration table, click Edit Endpoints.
- In the Endpoint Specific table, for each Endpoint to configure, from the Override selection list, choose Enable.
- For each enabled endpoint, complete the timeout fields as required.
- Click Apply
Top
Creating a DTMF Map that Applies to all Endpoints
Top
Creating a DTMF Map that Applies to Specific Endpoints
Top
Examples
Default DTMF Maps

- x.# indicates to dial, right away, a number that finishes by a #. The transformation indicates to not dial the #.
- x.T indicates to dial the number if not digit is dialed after 3 seconds.
Top
Configuring a DTMF Map to Use a Timer to Make a Call

Top
Configuring a DTMF Map to make a Call with an Extension
- Go to Telephony/DTMF Maps.
- Make sure the DTMF Map selection list, is set to Allowed.
- In the Allowed DTMF Map table, from the Enable selection list, choose, Enable.
- From the Apply to selection list, choose Endpoint.
- From the Suggestion selection list, choose the endpoints for which you wish to associate a DTMF map.
- in the DTMF Map field enter [2-4]xx
- Click Apply
Top
Configuring a DTMF Map to make an Internal (extension) or External Call
Top
Configuring a DTMF Map to Force the Use of the # OR * to Dial a Number

Top
Configuring a DTMF Map to Make a Call Outside the Country

Top
Basic DTMF Transformations
DTMF Transformations will modify the dialed number. For example, let's say that the dialed number is 18195551111#.
Action | Transformation | Result |
---|---|---|
Add the prefix “0” to the dialed number | 0x | 018195551111# |
Remove the suffix “#” from the dialed number | x{#} | 018195551111 |
Remove the first four DTMFs from the dialed number | (4)x | 5551111# |
Remove the international code and termination and replace the area code by another one | (1){819}514x{#} | 5145551111 |
Replace the signalled DTMFs by a extension "123" | 123 | 123 |
Top
Online Help
If you are not familiar with the meaning of the fields and buttons, click Show Help, located at the upper right corner of the Web page. When activated, the fields and buttons that offer online help will change to green and if you hover over them, the description will bedisplayed.
Top
DGW Documentation
Mediatrix devices are supplied with an exhaustive set of documentation.
Mediatrix user documentation is available on the Media5 Documentation Portal.
- Release notes: Generated at each GA release, this document includes the known and solved issues of the software. It also outlines the changes and the new features the release includes.
- Configuration notes: These documents are created to facilitate the configuration of a specific use case. They address a configuration aspect we consider that most users will need to perform. However, in some cases, a configuration note is created after receiving a question from a customer. They provide standard step-by-step procedures detailing the values of the parameters to use. They provide a means of validation and present some conceptual information. The configuration notes are specifically created to guide the user through an aspect of the configuration.
- Technical bulletins: These documents are created to facilitate the configuration of a specific technical action, such as performing a firmware upgrade.
- Hardware installation guide: They provide the detailed procedure on how to safely and adequately install the unit. It provides information on card installation, cable connections, and how to access for the first time the Management interface.
- User guide: The user guide explains how to customise to your needs the configuration of the unit. Although this document is task oriented, it provides conceptual information to help the user understand the purpose and impact of each task. The User Guide will provide information such as where and how TR-069 can be configured in the Management Interface, how to set firewalls, or how to use the CLI to configure parameters that are not available in the Management Interface.
- Reference guide: This exhaustive document has been created for advanced users. It includes a description of all the parameters used by all the services of the Mediatrix units. You will find, for example, scripts to configure a specific parameter, notification messages sent by a service, or an action description used to create Rulesets. This document includes reference information such as a dictionary, and it does not include any step-by-step procedures.
Top
Copyright Notice
Copyright © 2023 Media5 Corporation.
This document contains information that is proprietary to Media5 Corporation.
Media5 Corporation reserves all rights to this document as well as to the Intellectual Property of the document and the technology and know-how that it includes and represents.
This publication cannot be reproduced, neither in whole nor in part, in any form whatsoever, without written prior approval by Media5 Corporation.
Media5 Corporation reserves the right to revise this publication and make changes at any time and without the obligation to notify any person and/or entity of such revisions and/or changes.