Queue RCML
The verb’s noun specifies a queue to dial. When dialing a queue, the caller will be connected with the first enqueued call in the specified queue. If the queue is empty, Dial will wait until the next person joins the queue or until the timeout duration is reached. As of today recording is not supported. This feature is on our roadmap.

Attributes

Attribute
Description
waitUrl
Attribute takes a URL as an argument. The URL points to a RCML document that is executed on the queued caller’s end (Customer) when the caller is put in the queue and waiting for the next available enqueue (Agent). The waitUrl RCML supports Say, Play, Redirect verbs. If total duration of , together is less than timeout value, Call Queue will put the waitUrl response in a loop and play untill a timeout occurs or the call is connected. verb can be used for calling RCML document again and the Application can add some dynamic business logic that can change in next loop. Call Queue will pass the parameters explained in Request Parameters in its request to the value of the waitUrl attribute.
waitUrlMethod
The method attribute takes the value 'GET' or 'POST'. This tells Call Queue whether to request the waitUrl above via HTTP GET or POST. This attribute is modeled after the HTML form method attribute. The default value is 'POST'.
joinUrl
Set to a URL that points to a RCML document that will be executed on the queued caller’s end when the caller is about to be connected to next available enqueue. The joinUrl RCML supports Say, Play, Redirect verbs. The Call Queue will pass the parameters explained in Request Parameters in its request to the value of the joinUrl attribute.
joinUrlMethod
The method attribute takes the value 'GET' or 'POST'. This tells the Call Queue whether to request the joinUrl above via HTTP GET or POST. This attribute is modeled after the HTML form method attribute. 'POST' is the default value.

Request Parameters

Parameter
Description
CallSid
A unique call identifier.
AccountSid
Your account sid.
From
Caller’s phone number.
To
Phone number receiving the call.
CallStatus
Status of call. Possible values are queued, ringing, in-progress, completed, busy, failed and no-answer.

Example

The following example shows how RCML can be formed:
1
<Response>
2
<Dial timeout="300" record="true">
3
<Queue waitUrl="http://www.mocky.io/v2/5dadc3592d00006e00e4bcc9" joinUrl="http://www.mocky.io/v2/5d92d5d23000005b001b7085">support
4
</Queue>
5
</Dial>
6
</Response>
Copied!
Mocky.io returns the following RCML.
1
<Response>
2
<Say>
3
All our Agents are busy. Your call is important to us. Please hold your line and we will connect you in sometime.
4
</Say>
5
<Play>
6
https://yourcompany.com/teleapi/music/electronica/teru_-_110_Downtempo_Electronic_4.wav
7
</Play>
8
</Response>
Copied!
Mocky.io returns RCML as follows.
1
<Response>
2
<Say language="google.en-IN-Wavenet-C" voice="woman">
3
Thanks for holding line. You will now be connected to Agent.
4
</Say>
5
</Response>
Copied!