sendDtmf.md

{% method %}

XML: <SendDtmf>

The <SendDtmf> element is used to send digits on a live call. This will usually be used to automate the process of navigating through an external phone tree (IVR).

String containing the DTMF characters to be sent in a call. Allows a maximum of 92 characters. The digits will be sent one-by-one with a marginal delay.

• The , and lowercase w characters introduce a half-second pause into the DTMF sequence.
• The uppercase W character introduces a one-second pause.

Example: The DTMF string '1WWW,59#'' will send a 1, wait 3.5 seconds, then send 59# in quick succession.

Example: The DTMF string '1Ww2Ww1Ww#' will send a '1', then '2', then '1', then '#' with a wait time of 1.5 seconds between each character sent. If <SendDtmf> is the last verb in the document then the call will be disconnected 30 seconds after the <SendDtmf> ends.

Attributes

Attribute	Description
None	None

Allowed Values

Maximum of 92 characters.

Value	Behavior
1	Will send the button press for: 1
2	Will send the button press for: 2
3	Will send the button press for: 3
4	Will send the button press for: 4
5	Will send the button press for: 5
6	Will send the button press for: 6
7	Will send the button press for: 7
8	Will send the button press for: 8
9	Will send the button press for: 9
0	Will send the button press for: 0
*	Will send the button press for: *
#	Will send the button press for: #
, or w	Will add a 0.5 seconds delay
W	Will add a 1.0 seconds delay

Callbacks Recevied

Callback	Can reply with more BXML
None	No

{% common %}

Example: Pause then Send DTMF

This shows how to use Bandwidth XML to pause before sending DTMF button presses.

<?xml version="1.0" encoding="UTF-8"?>

<Response>
  <Pause length="5"/>
  <SendDtmf>1234</SendDtmf>
</Response>

Example: Send digits with a 2.5 second delay

This shows how to use Bandwidth XML to pause 2.5 seconds between sending the 1 and 234 button presses.

<?xml version="1.0" encoding="UTF-8"?>

<Response>
  <SendDtmf>1WW,234</SendDtmf>
</Response>

{% endmethod %}