Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now


Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

TwiML™ Voice: <Queue>

The <Dial> verb's <Queue> 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 <Dial> timeout duration is reached. If the queue does not exist, Dial will post an error status to its action URL.



属性名 許容値 初期値
url 相対または絶対 URL none
reservationSid 予約 Sid none
postWorkActivitySid アクティビティ Sid none


The url attribute takes an absolute or relative URL as a value. The url points to a Twiml document that will be executed on the queued caller's end before the two parties are connected. This is typically used to be able to notify the queued caller that he or she is about to be connected to an agent or that the call may be recorded. The allowed verbs in this TwiML document are Play, Say, Pause and Redirect.


Twilio は url 属性の値となる URL へのリクエストとともに、 標準的な TwiML 音声通話リクエスト パラメーター に加え、次のパラメーターを渡します。

パラメーター 概要
QueueSid キューの SID です。
CallSid キューから外れた通話の、CallSid です。
QueueTime 通話が待ち行列内に存在した時間を秒単位で返します。
DequeingCallSid 発信者をキューから外した通話の、CallSid です。


The method attribute takes the value 'GET' or 'POST'. This tells Twilio whether to request the url above via HTTP GET or POST. This attribute is modeled after the HTML form method attribute. 'POST' is the default value.


TaskRouter Workflow Sidを伴って通話が待ち行列に入れられる場合、この通話を待ち行列に入れられた発信者と接続するためReservation Sidを指定できます。 通話の接続に成功すると、保留中のReservationは「accepted」に設定されます。


If a call is bridged using the 'reservationSid' attribute, you may specify an optional postWorkActivitySid value to indicate the what activity state that the Worker should be moved to after the call completes.


例 1: キューへダイヤルする

この例では、発信者は「support」キューから通話を外します。 接続前に、次の TwiML が実行されます。


        キューで待機している発信者に向けて再生される about_to_connect.xml の TwiML 文書は、次のようになります。

              Rate this page:


              誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。