Skip to main content
You can use the Number element to specify a phone number to dial. You can use multiple Number elements within a Dial element to simultaneously call multiple numbers. The first call to pick up is connected to the current call and the rest are hung up. Use the Number element to
  • Forward an incoming call on a Vobiz number to a mobile or a landline number.
    • Make an outbound call to an agent and then bridge the call to a client’s number for call center use cases.
    • Enable click to call, where you input a number on a web-based form and request a connection with another person.
Note: When dialing multiple numbers simultaneously, if confirmSound and confirmKey are specified for the Dial element, the number that confirms the key correctly is bridged and all others fail.

​
Attributes

sendDigits (string) Tells the API to play DTMF tones when the call is answered. This is useful when dialing a phone number and an extension. The API dials the number, and when the automated system picks up, it sends DTMF tones to connect to the extension. Allowed values: any digits and the w character. Each w character tells the Vobiz API to wait 0.5 seconds. No default value. sendOnPreanswer (boolean) If set to true, sendDigits is executed when the called party is in early media instead of answer state. Allowed values: true, false Defaults to false.

​
Setting the caller ID

The caller ID shown to the dialed number is controlled by the callerId attribute on the parent Dial element - not on Number itself. Set it to override the number displayed to the called party (for example, to present your own Vobiz number when forwarding or transferring a call): 
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Speak>Please hold while we transfer your call.</Speak>
    <Dial callerId="+14155551234">
        <Number>+14156667890</Number>
    </Dial>
</Response>
If callerId is omitted, the current caller’s caller ID is used by default. See Transfer a Call for a full walkthrough of using the Dial element to transfer and forward calls.

​
Dialing extensions

This code dials the extension 2410 at the number 15671234567. The Number element describes the phone number and gives it the sendDigits attribute. To dial the extension a couple of seconds after the number is dialed, we add a few leading w characters, telling Vobiz to wait 0.5 seconds for each w.

​
Response

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Dial>
      <Number sendDigits="wwww2410">15671234567</Number>
    </Dial>
</Response>