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の宛先にFaxを送信する

TwilioのREST APIを使用して、SIPが有効になったエンドポイントにFaxを送信します。 SIPにあまり詳しくない方、あるいはTwilioがどのようにあなたのSIPエンドポイントに働きかけるかの詳細について情報が必要な方は、SIP概要を参照してください。

Faxに対してHTTP POSTを発行する

Faxセッションの初期化に使用するのと同じFaxリソースに対してPOSTリクエストを送信し、REST API経由でSIPセッションを開始します(詳細については、Faxの送信を参照してください)。 たとえば、お使いのアカウントのFax一覧リソースのURIに対してPOSTリクエストを発行し、SIP経由でFaxを送信します:

https://fax.twilio.com/v1/Faxes

POSTパラメーター

Faxの送信機能およびパラメーターはすべてサポートされます。 相違点はToおよびFromパラメーターに異なる値を渡すことだけです。 Toパラメーターには、接続しようとしているSIP URIを指定します。 Fromパラメーターには、SIPリクエストのFromヘッダー内へ、表示させたいユーザーを指定します。

必須パラメーター

パラメーター 概要
To The SIP URI to which you want to send the fax (📇 PII MTL: 120 days)

Toパラメーターには、Twilioに接続先のSIPアドレスを指定します。 URI要素の本文は、256文字未満の有効なSIP URIでなければなりません。 たとえば、次のようになります。

sip:michael@example.com
ヘッダー

SIP URIの末尾にヘッダーを追加して、Toパラメーターに渡します。 ヘルパーライブラリーの一部では、「&」は%26とエンコードすることが必要です(ご使用のライブラリーのドキュメントを参照してください)。 ヘッダーに渡される最大文字数は1024未満にしてください。 たとえば、次のようになります。

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

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

sip:jack@example.com;transport=tcp

オプションパラメーター

パラメーター 概要
From This value is used to populate the username portion of the From header that is passed to the SIP endpoint. This may be any alphanumeric character, as well as the plus, minus, underscore, and period characters (+-_.). No spaces or other characters are allowed. (📇 PII MTL: 120 days)
SipAuthUsername Your authentication username (max 256 characters). (🏢 not PII)
SipAuthPassword The password for the user (max 256 characters). (🏢 not PII)

サンプル

例 1

SIPを使用してFaxを送信します。

        
        
        
        
        例 2

        SIP認証が必要な場合の、ユーザ名・パスワードを指定する方法です。

              
              
              
              
              例 3

              SIP URIの一部として、ヘッダーおよびパラメーターを渡します。

                    
                    
                    
                    
                    Rate this page:

                    ヘルプが必要ですか?

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