Get Started

TwiMLTM Voice: <Leave>

The <Leave> verb transfers control of a call that is in a queue so that the caller exits the queue and execution continues with the next verb after the original <Enqueue>.

Verb Attributes

The <Leave> verb doesn't support any attributes.

Example: Leaving a Queue

In this example, we have a number of people who are waiting in a queue for a support line. Unfortunately the support line closes at 9PM and the callers will have to be notified that they are out of the queue and will have to try again tomorrow.

The original call TwiML might look like this:

enqueue.xml
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Enqueue waitUrl="wait.xml">support</Enqueue>
    <Say>Unfortunately, the support line has closed. Please call again tomorrow.</Say>
</Response>

Configure wait.xml to play hold music before 9pm:

wait.xml
<?xml version="1.0" encoding="UTF-8"?>
<Response>
     <Play>http://com.twilio.sounds.music.s3.amazonaws.com/MARKOVICHAMP-Borghestral.mp3</Play>
</Response>

After 9PM, wait.xml will dequeue the user and return control to the <Say> block in the original call TwiML:

wait.xml
<?xml version="1.0" encoding="UTF-8"?>
<Response>
     <Leave />
</Response>