メニュー

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 ドメイン
SipDomainSid 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エンドポイントと、成立している通話に送信します。

<Redirect>動詞をアプリケーションから受け取った場合、リダイレクトドキュメントがリクエストされ、Twilioは180 Ringingを続けます。

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:

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.