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.
This guide details how to send a fax in common web languages and cURL. To send a fax with Twilio Programmable Fax, you will use the Twilio Fax REST API.
Each fax you send will require:
- Either a destination phone number or SIP URI
- A From number. Either:
- An Incoming Phone Number (or)
- An Outgoing Caller ID (Optional for SIP destinations.)
- A URL which points to the media that will be sent via fax
- Currently, this must be a PDF file (see below)
You should not expose your PDF globally beyond any testing. To verify a request comes from Twilio, see our Security page.
Prefer a step-by-step guide to sending (and receiving) your first fax? Check out our Programmable Fax quickstart!
To see more properties and options, also see our API documentation on the Fax Resource.
Fax Quality and Resolution
When sending a fax, a quality value can also be provided: if not, quality defaults to fine
. Note some destination fax hardware may not support higher quality levels and you may need to specify a lower quality to ensure delivery. Lower quality faxes also generally take less time to send.
Fax Status Callbacks
Faxを送信するとき、ステータス情報を callback URL宛に送ることが出来ます。
Fax Storage, Management, and Deletion
Twilioは、Faxで送信したPDFのコピーを保存します。PDFは、Faxインスタンスリソースで指定されているURLから取得することができます。
Log data for each fax will be available via the REST API for 180 days after creation. When old fax records are pruned, Twilio also deletes the media associated with the pruned records. If you wish to delete data before that, you can delete just the media, or the entire resource, including the media.
メディアストレージを避ける
You can use the StoreMedia=false
parameter on the API which directs Twilio to delete the fax media once the transmission is complete. This parameter defaults to true if unspecified. If StoreMedia=false
is specified, media stored temporarily during the transmission process is purged immediately after the fax has been completed, both when the fax succeeded or failed. However, Twilio still stores a metadata record of the sent fax. If you wish to delete this record, you can do so using the REST API.
Sending Faxes with Twilio
Now you've seen how to send faxes with common web languages and cURL and learned about a few properties you'll probably need to use.
Want to see more? Next, see the Fax REST API documentation.
ヘルプが必要ですか?
誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。