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通話の発信

TwilioのREST APIを使って、SIPが動作しているエンドポイントへ接続してみましょう。この機能を使うと、SIPを用いてVoIP通信を実現できます。SIPにあまり詳しくない方、TwilioがどのようにあなたのSIPエンドポイントに働きかけるかの詳細は、SIP概要を参照してください。

CallsへのHTTP POSTリクエスト

REST API 経由で、一般的な音声通話をPOSTすることでSIPセッションを開始することができます。(詳しくは、音声通話も参照してください)音声通話が成立すると、Twilioはその通話に対するTwiMLを取得しにいきます。例えば、通話リストリソースURLへPOSTすることでSIP通信を開始します。

 /2010-04-01/Accounts/{AccountSid}/Calls 

POSTパラメーター

すべての発信通話機能とパラメーターがサポートされます - 唯一の相違点は、「To」および「From」パラメーターに異なる値を渡すことです。 「To」パラメーターには、接続先のSIP URIを指定します。 「From」パラメーターには、SIPリクエスト内のFromヘッダーに表示させたいユーザー名を指定します。

必須パラメーター

以下のパラメータをPOSTする必要があります。

パラメーター 概要
To あなたが接続したいSIP URL

To パラメータで、Twilioに接続させる先の SIPアドレスを記載します。URIエレメントの本体には、有効なSIP URI を255文字以内で記載します。

例:

sip:michael@example.com

ヘッダー

Pass headers in the To parameter by appending them to the end of the SIP URI. For certain sdks, & will need encoding as %26. The total characters passed in a header must be under 1024. For example:

sip:michael@example.com?mycustomheader=foo&myotherheader=bar 

Transport

SIP URI の中に利用するプロトコルを transport パラメータとして渡すことができます。TCP または UDP が指定可能です。デフォルトでは、Twilioは SIP INVITE に UDP を使います。変更する場合には、このパラメータを使って下さい。

sip:jack@example.com;transport=tcp

NOTE: Twilio does not support SRTP on SIP Interface. SRTP is supported on Elastic SIP Trunking.

オプションパラメーター

下記のパラメーターをPOST可能です:

パラメーター 概要
From SIPエンドポイントへ受け渡すFromヘッダの中でユーザ名を指定する際に使われます。任意の半角文字列と、記号はプラス・マイナス・アンダースコア・ピリオド (+-_.) が使えます。スペースは使えません。
SipAuthUsername SIP認証が必要な際のユーザ名。
SipAuthPassword SIP認証が必要な際のパスワード。

SIP Dialを作成する

REST API を使った、基本的なSIP発信です。

        
        
        
        

        認証を使用する SIP 発信の作成

        認証用のユーザー名とパスワードをSIP通話に渡します。

              
              
              
              

              SIP URIにヘッダーを渡します。

              SIP URIの一部としてSIP Dialにヘッダーを渡します。

                    
                    
                    
                    
                    Rate this page:

                    ヘルプが必要ですか?

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