DigitTimeout (dialplan application)

6.1.2.24. DigitTimeout (dialplan application)

1. DigitTimeout - this application allows you to limit the time interval between digits when the user is typing an extension.

NOTE: This application is valid for Asterisk version 1.0.9 and above.

Syntax:

DigitTimeout(delay) ; the delay is in seconds

Purpose and usage

With the help of this application you can limit the time, which the users have to type the digits from an extension. If the timeout expire while the user is typing in the extension then the Asterisk PBX will consider the extension as complete and it will try to interpret it.

Prerequisites

To use this application you need a working Asterisk PBX with registered users in iax.conf, sip.conf or mgcp.conf(It depends on which protocol you would like to use) and made extensions.

To see how the application works we recommend to use our IAX softphone Idefisk. You can download it from here. Please also read our tutorial to learn how to configure it to work with Asterisk PBX.

Asterisk PBX configurations

NOTE: This is only an example of what for you can use this application. Of course you can use it and for other things.

We need two registered users in iax.conf file. This is because we are going to use the IAX2 protocol. If you want to use other protocol such as SIP or MGCP, you have to do the configurations below respectively in sip.conf or mgcp.conf.

So, we have registered the users anatoliy and user1

Type=friend means that this user can make and receive calls. Host=dynamic means that the IP is not static but dynamic through a DHCP server. Allow=all means that the line which this user will use, could support all audio codecs. Context=test - this shows that this user is working with the extensions in this context of the configuration file extensions.conf.

Now, when somebody dials 113, the first executed extension will be Answer. Then we have the DigitTimeout application. This application can take an argument in seconds. In our example this is 5. By default it is also 5.Now, with this application the caller has maximum time of 5 seconds to type a digit and also between the digits when he enters an extension. If the timeout expires the system will consider the extension completed and it will try to call this extension.

Here we have a specific moment. If you have typed a valid number the Asterisk PBX will interpreted it immediately and no timeout will be waited. However if there is a timeout executed this very probably means, that the typed number is invalid. In this way the execution will be transferred to an invalid extension. If such extension does not exist the next step will be the transfer of the call to a timeout extension. If even such extension does not exist then the call will be hung up.

Invalid and Timeout are special predefined extension names such as start.

An example for Invalid extension is:

exten => i,1,Answer()
exten => i,2,Playback(pbx-invalid)
exten => i,3,Hangup()

The extension with the next priority contains the Dial application. this application will allow you to connect the user anatoliy through IAX2 channel.

We recommend you always to make an extension for hanging up. In this way you will be sure that the Asterisk PBX will hang up the line after the conversation is over.

2. Screenshots of what you can see on the CLI of the Asterisk PBX

3. Additional information

For more information about extensions.conf you can check here.
For more information about iax.conf you can check here.

This application is tested with our IAX softphone Idefisk. You can download it from here. For more information about this softphone please read our tutorial.

If you would like to test this application with the SIP channel you can read our tutorials about the SIP Softphones to learn how to configure them to work with Asterisk PBX

4. Similar dialplan applications

AbsoluteTimeout()
ResponseTimeout()

User Comments

bobb (bobbo at bobobb dot com)
04 November 2007 05:08:06
Deprecated in 1.4, you have to use
Set(TIMEOUT(digit)=5)

jawad (segnatory_end at yahoo dot com)
20 March 2007 07:33:29
Is it possible that put pbx syetem with my telephone and then i will generatethe pins of 30 to 1hour and i can use that from my cell no plz write me back

Add Comment

Latest Headlines:

T.38 faxing with Zoiper 2.15 is now easier than ever
section: voip software
Asterisk 1.4.21 Released
section: Asterisk
Asterisk 1.4.20 Released
section: Asterisk
Asterisk 1.4.20-rc2 Released
section: Asterisk
Asterisk 1.4.20-rc1 Now Available
section: Asterisk
News Archives (older news)

Latest Tutorials:

Sending Fax from Zoiper to Zoiper using T.38
added 08/Dec/2008 18:16
VMAuthenticate (dialplan application)
added 01/Mar/2008 15:57
Siptronic ST-530
added 06/Nov/2007 17:57
Siemens C455 IP hardphone
added 05/Nov/2007 10:24
Zoiper
added 22/Oct/2007 17:53

Latest Comments:

https://donde-ver-ant-man-y-la-avispa-qu...
tutorial: Digium Wildcard TE405 / Wildcard TE410P
https://donde-ver-scream-6-tyt.statuspag...
tutorial: Digium Wildcard TE405 / Wildcard TE410P
https://donde-ver-guardianes-de-la-noche...
tutorial: Digium Wildcard TE405 / Wildcard TE410P
https://donde-ver-demon-slayer-villa-de-...
tutorial: Digium Wildcard TE405 / Wildcard TE410P
https://www.reddit.com/r/BenavidezvPlant...
tutorial: Digium Wildcard TE405 / Wildcard TE410P

Name:
Email:
Comment:
In order to prevent automatic posting on our website, we kindly request you to type in the number you see in the picture below.
Image Verification: