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

メニュー

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 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.

ベータ

SIP Trunking <Refer> is currently available as a beta release. Beta products are not covered by a Twilio SLA. See this article for more information on beta product support.

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

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ヘッダーをTwiMLをアプリケーションに渡す

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

Rate this page:

ヘルプが必要ですか?

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