TwiML™ Voice： <Number>

<Number> is a noun for the Twiml verb <Dial> and it specifies a phone number to dial. Using the noun's attributes you can specify particular behaviors that Twilio should apply when dialing the number.

<Dial> 動詞で最大 10 件の <Number> 名詞を使用して、全宛先に同時に電話をかけることができます。最初に応答があった電話が現在の通話に接続され、残りの電話は切断されます。各 <Number> 名詞について、webhook を受け取るコールプログレスイベントの種類を指定できます。

名詞の属性

この名詞<Number>は振る舞いを変更する属性をサポートします。

電話番号には「+」と国番号が必要です。例 : +16175551212 (E.164 フォーマット) Twilio はこのフォーマット以外のアメリカの番号も扱えます (例 : (415) 555-1212 または 415-555-1212)。

sendDigits

sendDigits 属性は、相手が応答したら DTMF を送信するよう、Twilio に指示します。 電話番号と内線番号をダイヤルする場合に便利です。 Twilio は電話番号をダイヤルし、自動システムが応答すると、DTMF を送信して内線を呼び出します。

url

The 'url' attribute allows you to specify a url for a TwiML document that will run on the called party's end, after she answers, but before the parties are connected. You can use this TwiML to privately play or say information to the called party, or provide a chance to decline the phone call using <Gather> and <Hangup>. If answerOnBridge attribute is used on <Dial>, the current caller will continue to hear ringing while the TwiML document executes on the other end. TwiML documents executed in this manner are not allowed to contain the <Dial> verb.

method

method 属性には、url 属性の URL へのリクエスト送信に使う HTTP メソッドを指定します。 初期値はPOSTです。

statusCallbackEvent

<Dial>を使ってClientに発信した時、アウトバウンドコールが開始されます。initiatedからringingへのコール遷移は、電話が鳴り始めた時起こります。answeredは受話した時に、最後に通話が終わった時にcompletedへと遷移します。statusCallbackEventと共に、異なったコールプログレスイベントのwebhook を受け取ることができます。initiated、ringing、answered、completedをそれぞれ受け取ることができます。相対URL以外では、有効なホスト名を指定しなければなりません（アンダースコアは使用できません）。

statusCallbackEvent属性はTwilioがどのイベントを webhook するべきかを認めます。複数のイベントを指定する際は右記の通りスペースで区切ります。 : initiated ringing answered completedstatusCallbackあり、ステータスコールバックイベントが特定されない場合、completedイベントがデフォルトで送信されます。

一報APIを通じてアウトバウンドコールが生成されるとき、<Dial>を使ってアウトバウンドコールはすぐさま開始され、キュー(queue)に入ることがありません。下記の返却されうるコールイベントのタイムラインです。異なるコールステータスが<Dial>レグ(leg)で発生します。

statusCallback

statusCallback属性は statusCallbackEvent属性に含まれるそれぞれの指定されたイベントに送るwebhookリクエストのURL特定します。

statusCallbackMethod

statusCallbackMethod属性では、TwilioがstatusCallback属性で与えられたURLにアクセスする際に、どのHTTPメソッドを用いるかを指定します。デフォルトは POST です。

Status Callback HTTP パラメーター

TwilioがTwilio番号の一つのコールを受信した時、Twilioがアプリケーションに渡すStatusCallbackに送信される非同期のリクエスト中のパラメーターはTwiML検索するために非同期のリクエストにパラメーターを含めます。全てのリストと詳細はTwiML Voiceリクエストドキュメントをご覧ください。

コールプログレスイベントが発動された時、コールバックリクエストは、この他にも次のパラメーターを渡します。

サンプル

例 1: sendDigits を使う

ここでは、415-123-4567 の内線 1928 へダイヤルします。 <Number> 名詞を使って電話番号を記述し、sendDigits 属性を追加します。 内線をダイヤルする前にウエイトを入れたいので、先頭に「W」の文字を追加します。 Twilio は、「W」 1 文字につき 0.5 秒待ってから、番号を送信します。 これで、番号のダイヤルを始めるタイミングを、自動応答システムに合わせます。

例 2: 一斉発信

ここでは、複数の <Number> を使って、3 つの電話番号へ一斉にダイヤルします。3 つの通話のうち、最初に相手が応答した通話が発信者へ接続され、それ以外の通話はキャンセルされます。

例 3: コールプログレスイベント

ここでは、<Dial> で番号をダイヤルするときに、コールプログレスイベントが発生するたびに webhook を受け取ります。

例 4：コールプログレスイベントによる複数のダイヤル

ここでは、<Dial> で複数の番号にダイヤルするときに、各番号でコールプログレスイベントが発生するたびに webhook を受け取ります。

ヒントとテクニック

• <Dial>動詞を含めて10個の番号に同時にダイヤルできます。

• 一斉発信は、着信通話を受けた時に複数の番号 (または人) を呼び出したい場合に役立ちます。 最初に通話が接続されると、残りの通話の呼び出しはキャンセルされますので、注意してください。 オフィスの電話システムや、フライト モードに設定された携帯電話へダイヤルすると、1 回の呼び出し音で応答があります。このため、他の通話がすぐにキャンセルされてしまい、人が応答するまで長く呼び出し音を鳴らすことができません。

  一斉発信は相手の状況を知っている場合に使うよう、注意する必要があります。