Nouns

<Number>

Dial a phone number.

Used inside<Dial>.

Element body

The E.164 phone number to dial.

Example

<Response>
  <Dial>
    <Number sendDigits="wwww1928">+18005551234</Number>
  </Dial>
</Response>

Attributes

Attribute Default Behaviour
sendDigits unset Touch-tone digits sent on the dialled leg after answer — extensions and access codes. Charset 0-9 * # A-D w W — w is a 500 ms pause, W a 1 second pause.
url unset VoiceML fetched and executed on the dialled leg before the bridge — "press 1 to accept" screening prompts. Best-effort: a fetch failure is logged and the call proceeds.
method POST HTTP method for the screening-URL fetch.
statusCallback unset Per-leg lifecycle webhook URL: the dialled leg's own lifecycle events are posted here as it progresses, carrying the leg's CallSid, its ParentCallSid, and Direction outbound-dial.
statusCallbackMethod POST HTTP method for the per-leg webhook.
statusCallbackEvent completed Space-separated list of leg lifecycle events to deliver: initiated, ringing, answered, completed. Omit to receive completed only.
machineDetection unset Answering-machine detection on the dialled leg: Enable classifies the answerer as soon as possible; DetectMessageEnd waits for the end of the greeting so a message can be left on voicemail. Any other value disables detection.
machineDetectionTimeout 30 Seconds the detector listens before giving up.
machineDetectionSpeechThreshold 2400 Milliseconds of continuous speech that tip the classification toward machine.
machineDetectionSpeechEndThreshold 1200 Milliseconds of silence after speech that mark the end of the greeting.
machineDetectionSilenceTimeout 5000 Milliseconds of initial silence before the detector times out.
amdStatusCallback unset URL that receives the detection result as soon as it is known: AccountSid, CallSid, AnsweredBy (human, machine_start, machine_end_*, fax, unknown — plus the screened, screened_ivr, and disconnected extensions on screened calls), and MachineDetectionDuration.
amdStatusCallbackMethod POST HTTP method for the detection-result callback.
byoc unset Accepted for compatibility and ignored — no effect.