Faxの送信

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.

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.