メニュー

Expand
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?

SIPとTwiMLインタラクション

SIP通話は通常のインバウンド通話やクライアントと同様にTwiMLと強いつながりがあります。TwilioはあなたのSIPドメインにINVITEを送り、認証をします。その後180 Ringing SIPレスポンスをSIPエンドポイントに送ります。その後あなたのSIPドメインに関連付けられたURLを呼び出し、HTTPリクエストをVoiceURLに送信します。

TwiMLが呼び出される際、Twilioは元々のSIP通話にいくつかのパラメータを渡します。

パラメーター名 概要
To INVITEするURI
From INVITEに渡される”From”ヘッダー
SipDomain INVITEの送信元Twilio SIP ドメイン
SIPドメイン SID The Originating Twilio SIP Domain SID
SipUsername クレデンシャルリストが有効になっている際に認証に使われるユーザー名
SipCallId インカミングINVITEの Call-ID
SipSourceIp インカミングINVITEの送信元IPアドレス
SipHeader_<name> SipHeader_<name> としてインカミングINVITEに含まれるX- header。<name>がヘッダーキーになります。複数の値を受信できます。

有効なTwiMLと共にリクエストを受信すると、TwilioはTwiMLを実行します。<Say>, <Play>, <Record>, <Dial>, <Gather>が含まれる場合、Twilioは200 OK SIPレスポンスをSIPエンドポイントと、成立している通話に送信します。

If your application passes back a <Redirect> verb, the redirect document is requested and Twilio continues in the 180 Ringing state.

If your application sends back a <Reject reason=”busy”>, Twilio returns a 486 Busy SIP response code and the call setup is denied. If your application sends back a <Reject reason=”rejected”>, Twilio returns a 404 Not Found response code and the call setup is denied.

SIP Refer From Twilio

If your TwiML instructions use <Refer>, Twilio will generate a SIP REFER toward the customer's PBX and handle any NOTIFY messages. The transfer is entirely handled by the customer's PBX.

Note: If <Refer> is the last verb and has no action URL the call leg will be ended, otherwise, TwiML execution continues as normal.

Interested in learning more about SIP REFER see here.

SIPヘッダーをTwiMLをアプリケーションに渡す

リモートSIPアプリケーションとより良く統合するため、TwilioのSIP接続はinitial INVITEのヘッダーを読み、アプリケーションに渡すことができます。Twilioは”X”から始まるヘッダーを読み、SipHeader_X-headername=headervalue のフォーマットでTwiML HTTPコールバックに渡すことができます。通話とともに行いたいことを追加で記述することができます。

Rate this page:

ヘルプが必要ですか?

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