CallXML 2.0 Development Guide Home  |  Frameset Home

This documentation is for CallXML 2, which has been superceded by CallXML 3. The CallXML 2 language is not being updated any longer. CallXML 3, however, has many new features and is actively being enhanced. If you're writing a new CallXML application, you should use CallXML 3. Click here for the CallXML 3.0 documentation.

<playdtmf>  element


The playdtmf element allows the developer to play a sequence of dtmf tones to the call destination, (most often used when using a http token inititiated outbound call). This is useful for postdialing operations, where you may wish to programmatically navigate to a particular extension, or to navigate through a PBX menu. Note that when using this element, care must be taken to 'marry' a particular dtmf string to the specific menu that you wish to step through, as no two PBX menus are the same in regards to timing.


usage

<playdtmf duration="(m|s|ms)" pause="(m|s|ms)" value="(1234567890*#)">


attributes

duration Data Type: (m|s|ms) Default: Optional
The 'duration' attribute specifies how long each dtmf tone should be played to the called party. For instance, if specified as '10s', then each dtmf tone will be played for 10 seconds. Note that if this attribute is left unspecified, then the value will default to 120 milliseconds.
pause Data Type: (m|s|ms) Default: Optional
The 'pause' attribute defines the duration of the silence, (if any), between the dtmf tones specified in the 'value' attribute. If left unspecified, then this will default to 240 milliseconds.
value Data Type: (1234567890*#) Default: Required
The 'value' attribute defines the dtmf string to play to the caller when the element is executed.



possible events

none


code samples

<playdtmf-duration-pause-value>
<?xml version="1.0" encoding="UTF-8"?> 
<callxml version="2.0">
    <block label="MessageBlock" repeat="3">
    <wait value="1s"/>
    <playdtmf value="1234" duration="20s" pause="1s"/>
    </block>
</callxml>



additional links

none


  ANNOTATIONS: EXISTING POSTS
0 posts - click the button below to add a note to this page

login



© 2011 Voxeo Corporation  |  Voxeo IVR  |  VoiceXML & CCXML IVR Developer Site