Nouns

<Client>

Dial a registered SIP client by identity.

Used inside<Dial>.

Element body

The client identity — either as the bare body or a nested <Identity> child.

Example

<Response>
  <Dial>
    <Client>
      <Identity>joey</Identity>
    </Client>
  </Dial>
</Response>

Attributes

Attribute Default Behaviour
sendDigits unset Touch-tone digits sent after answer (same as <Number>).
url unset VoiceML screening prompt run on the dialled leg before the bridge (same as <Number>).
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 (same as <Number>).
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: AccountSid, CallSid, AnsweredBy, and MachineDetectionDuration.
amdStatusCallbackMethod POST HTTP method for the detection-result callback.

Nesting

<Client> accepts these nested elements:

Notes

  • Both <Client>joey</Client> and the nested <Identity> form are accepted.