The Number Element

The Number element is used 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.

Number element is usually used in the following cases -

  • Forwarding an incoming call on a Plivo number to your mobile or a landline number.
  • Making an outbound call to an agent and then bridging the call to a client's number for call center use-cases.
  • For click to call use-cases, where you will input your 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 which confirms the key correctly will be bridged while all others will fail.

Attributes

sendDigits string

The sendDigits attribute 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 will dial the number, and when the automated system picks up, the DTMF tones are sent to connect to the extension.

Allowed values - any digits and the w character. Each w character tells the Plivo API to wait 0.5 seconds instead of playing a digit. No default value.

sendOnPreanswer boolean

If sendOnPreanswer attribute is true, sendDigits is executed when the called party is in early media instead of answer state.

Allowed values - true or false. Defaults to false.