メニュー

Expand
ページを評価:

SIPの宛先にFaxを送信する

We have made the difficult decision to disable Programmable Fax for all accounts on December 17, 2021. For new and inactive accounts, access to Programmable Fax is disabled effective immediately. We recognize the challenges this decision might cause and have provided detailed migration plans to prevent disruptions.

For Japan customers, please refer to this migration plan. For all other customers, please refer to this migration plan. Learn more.

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の一部として、ヘッダーおよびパラメーターを渡します。

                    
                    
                    
                    
                    ページを評価:

                    ヘルプが必要ですか?

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

                          
                          
                          

                          フィードバックくださりありがとうございます!

                          We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

                          Sending your feedback...
                          🎉 Thank you for your feedback!
                          Something went wrong. Please try again.

                          Thanks for your feedback!

                          Refer us and get $10 in 3 simple steps!

                          ステップ1

                          Get link

                          Get a free personal referral link here

                          ステップ2:

                          Give $10

                          Your user signs up and upgrade using link

                          ステップ3

                          Get $10

                          1,250 free SMSes
                          OR 1,000 free voice mins
                          OR 12,000 chats
                          OR more