メニュー

Expand
ページを評価:

BulkExport API Overview

ベータ

This Twilio product is currently available as a beta release. Some features are not yet implemented and others may be changed before the product is declared as Generally Available. Beta products are not covered by a Twilio SLA. Learn more about beta product support.

The BulkExport API provides an efficient mechanism for retrieving all of your activity logs from the Twilio platform on an ongoing basis, or for one-off downloads. Using BulkExport, you can access daily dumps of the previous day’s Messages, Calls, Conferences, or conference Participants, eliminating the need to iterate through the list resource one page at a time to download your records. The BulkExport files are automatically removed after seven days. You can also use BulkExport to generate a set of historical daily dumps over a range of dates.

When a BulkExport completes, it can fire a webhook and/or send an email. This applies to the daily export, if configured, and to custom jobs. In both cases, successful exports will generate a Day resource for each day requested.

BulkExport is useful if you have:

  • A data warehouse where you want to store messaging traffic to perform analysis.
  • A compliance store where messaging should be retained so that you have a permanent record.
  • Requirements to produce data.

ベースURL

Control over BulkExports, and the data exported is available under the following URL:

https://bulkexports.twilio.com/v1/Exports/<resource_type>

How BulkExport works

There are four parts to BulkExport:

  • A configuration that allows customers of Twilio Edition products to set automatic exports for each day.
  • A way to export a specified day’s traffic.
  • A means to manage exports in progress.
  • A list of exported days with their output files.

ExportConfiguration

The ExportConfiguration resource lets you specify, if you have a Twilio Editions product, whether exports will take place automatically every day. This makes getting the data much more simple: you just configure the webhook. This will be called when the day’s file is available, and you can then download and process your data.

Custom Jobs

Jobs let you choose a range of dates to export. One data file will be generated for each day in the range. The days are visible in the list of exported days. You will receive a callback and/or email for each job that completes. When a custom job completes, it will generate one Day resource for each day in the requested time period.

採用情報

Get a list of jobs in progress or which have recently completed. Completed jobs will appear in the job list for seven days. You can delete jobs before they are complete.

Exported days

The Days resource lets you examine the list of exported days available, either because they have been already generated by an export job or an automatic daily export. Each day file is named with the ISO 8601 date, and days are listed in order of generation.

There is no way to delete completed Day files, but they will be deleted automatically seven days after their creation.

サブリソース

リソース 概要
ExportConfiguration Configure export webhooks. Twilio Enterprise Edition customers can also set daily exports.
ExportCustomJob Create new jobs to export data, and list current jobs and their status. Running a job will create the corresponding Days.
採用情報 View the status of current jobs, and delete incomplete custom jobs.
List and fetch the exported message data for given days.

Using BulkExport

There are two ways to use BulkExport:

  1. If you have the Twilio Enterprise Edition, you can enable the daily export using the ExportConfiguration resource. This will generate one file per day automatically in the 12 hours following the end of the UTC day.
  2. Create custom jobs using the ExportCustomJob resource.

You can then use the Day resource to list all completed exports by day and to download the message data for any of those days.

Messages BulkExport file format

Day files are stored and returned as compressed (gzip) JSON files with one record per line. Records are similar to the Message resource. The differences are:

  • Timestamps are in UTC in ISO 8601 format.
  • Price data may not be present on all messages in BulkExport.
  • The following fields are not present:
    • price_units
    • api_version
    • error_message (but error_code is)
    • uri
    • subresource_uris (containing the media URLs)

Calls BulkExport file format

Day files are stored and returned as compressed (gzip) JSON files with one record per line. Records are similar to the Calls resource. The differences are:

  • Timestamps are in UTC in ISO 8601 format.
  • Price data may not be present on all messages in BulkExport
  • The following fields are not present:
    • uri
    • subresource_uris

Conferences BulkExport file format

Day files are stored and returned as compressed (gzip) JSON files with one record per line. Records are similar to the Conferences resource. The differences are:

  • Timestamps are in UTC in ISO 8601 format.
  • The following fields are not present:
    • api_version
    • uri
    • subresource_uris

Participants BulkExport file format

Day files are stored and returned as compressed (gzip) JSON files with one record per line. Records are similar to the Participants resource. The differences are:

  • Timestamps are in UTC in ISO 8601 format.
  • The following fields are not present:
    • uri
    • label
ページを評価:

ヘルプが必要ですか?

誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、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