play_and_get_digits Misc. Dialplan Tools play and get digits

Contents

 [hide] 

• 1 Description
• 2 Usage
• 3 Parameters
• 4 Channel Variables
• 5 Examples
• 6 See Also

Description

Play a prompt and get digits.

Usage

<min> <max> <tries> <timeout> <terminators> <file> <invalid_file> <var_name> <regexp> <digit_timeout> <transfer_on_failure>

Parameters

• min = Minimum number of digits to fetch (minimum value of 0)
• max = Maximum number of digits to fetch (maximum value of 128)
• tries = numbers of tries for the sound to play
• timeout = Number of milliseconds to wait for a dialed response after the file playback ends and before PAGD does a retry.
• terminators = digits used to end input if less than <max> digits have been pressed. (Typically '#')
• file = Sound file to play while digits are fetched
• invalid_file = Sound file to play when digits don't match the regexp
• var_name = Channel variable into which digits should be placed
• regexp = Regular expression to match digits
• digit_timeout = Inter-digit timeout; number of milliseconds allowed between digits; once this number is reached, PAGD assumes that the caller has no more digits to dial
• transfer_on_failure = where to transfer call when max tries has been reached, example: 1 XML hangup
  • Note: digit_timeout is optional and defaults to the value of <timeout>

Channel Variables

On exit, there may be some useful values in channel variables

• read_terminator_used = The digit used to terminate entry (if a digit was used). Note that if termination was due to a timeout or hangup, then this channel variable is not touched (so may be left as nil or whatever it was on entry)

Examples

<extension name="play_and_get_digits example">  <condition field="destination_number" expression="^(1888)$">    <action application="play_and_get_digits" data="2 5 3 7000 # $${base_dir}/sounds/en/us/callie/conference/8000/conf-pin.wav /invalid.wav foobar \d+"/>    <action application="log" data="CRIT ${foobar}"/>  </condition></extension>

This example demonstrates using say (or phrase) to get one digit after 3s, 250ms of silence on fail (no digit entered). Quote the text string!

<extension name="play_and_get_digits with say">  <condition field="destination_number" expression="^(6500)$">    <action application="play_and_get_digits" data="1 1 1 3000 # say:'press one for technicial support' silence_stream://250 res \d+" />  </condition></extension>

Note that the parameters are slightly different in the lua version (and you can't use "say"!)

       session:setVariable("read_terminator_used","-")       destnum = session:playAndGetDigits(3, 20, 3, 5000, "#*", "phrase:getnum", "phrase:error", "\\d+")       terminator = session:getVariable("read_terminator_used")

See Also

• Dialplan