Ring

The Ring verb is used to play ringing audio on a call.

Text Content

There is no text content available to be set for the <Ring> verb.

Attributes

ATTRIBUTE	Description
duration	(optional) How many seconds to play ringing on the call. Default value is 5. Range: decimal values between 0.1 - 86400.
answerCall	(optional) A boolean indicating whether or not to answer the call when Ring is executed on an unanswered incoming call. Default value is 'true'.

Webhooks Received

There are no webhooks received after the <Ring> verb is executed.

Examples

Play Ringing to a Call

XML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
   <Ring duration="10" answerCall="false"/>
</Response>

Java

Ring ring = new Ring().builder()
        .duration(10.0d)
        .answerCall(false)
        .build();

Response response = new Response()
        .with(ring);

System.out.println(response.toBXML());

C#

Ring ring = new Ring
{
    Duration = 10,
    AnswerCall = false
};

var response = new Response();
response.Add(ring);

Console.WriteLine(response.ToBXML());

Ruby

ring = Bandwidth::Bxml::Ring.new({
  duration: 10,
  answer_call: false
})
response = Bandwidth::Bxml::Response.new([ring])

p response.to_bxml

NodeJS

const ring = new Bxml.Ring({
    duration: 10,
    answerCall: false
});
const response = new Bxml.Response(ring);

console.log(response.toBxml());

Python

ring = Ring(
    duration=10,
    answer_call=False
)

response = Response()
response.add_verb(ring)

print(response.to_bxml())

PHP

$ring = new BandwidthLib\Voice\Bxml\Ring();
$ring->duration(10);
$ring->answerCall(false);

$response = new BandwidthLib\Voice\Bxml\Response();
$response->addVerb($ring);

echo $response->toBxml();