Voice Recording settings
Twilio can record calls and Conferences that you create with Programmable Voice. You start a recording with the <Record> or <Dial record> TwiML verbs, the Record parameter on the Calls resource or Conferences resource, or by creating a Recording resource directly. By default, Twilio stores the resulting Recording in encrypted cloud storage and you retrieve it through the Recording resource.
On the Voice Recording settings page, you can configure the following account-wide settings for Voice Recordings:
- Voice Recording external storage sends new Voice Recordings to an external AWS S3 bucket instead of Twilio's cloud storage.
- Voice Recording encryption encrypts new Voice Recordings with a public key that you provide.
- Dual-channel Recording for Conference records Conferences in dual-channel format by default.
Changes affect all new Recordings created after you save your settings. Existing Recordings don't change.
With Voice Recording external storage, Twilio uploads new Voice Recordings to an AWS S3 bucket that you own instead of storing them in Twilio's cloud. Turning on this setting activates external storage for all regions, but you configure the bucket and AWS credentials for each region separately.
Before you begin, make sure you have:
- An AWS S3 bucket that Twilio can write to.
- An AWS IAM user with permission to write objects to that bucket. You'll need the IAM user's access key ID and secret access key.
After you configure external storage and save your settings, Twilio uploads all new Voice Recordings to your S3 bucket and doesn't retain a copy in Twilio's cloud storage.
- In Twilio Console, go to Voice > Recordings > Settings.
- In the Voice Recording external storage section, select Enable.
- For Select AWS credentials, choose an existing AWS credential, or select Create a new AWS credential and provide a friendly name, the IAM user's access key ID, and the IAM user's secret access key.
- For External S3 Bucket URL, enter the URL of your S3 bucket.
- Select Save.
Twilio Editions feature
Voice Recording Encryption is available to Twilio Enterprise Edition and Twilio Security Edition customers. Learn more about Editions.
Voice Recording Encryption encrypts new Voice Recordings with a public key that you provide. Only you, the holder of the corresponding private key, can decrypt the Recordings.
For details on how encryption works, how to generate a key pair, and how to decrypt your Recordings, see the Voice Recording Encryption tutorial.
Warning
After you activate Voice Recording Encryption, only you can decrypt the Recordings. No one at Twilio, including Twilio support, can decrypt your Recordings. Only test this feature on test accounts with non-production Recordings.
After encryption is on, Twilio encrypts new Voice Recordings with the public key that you select. Before you begin, generate an RSA key pair and create a Twilio Public Key resource that contains your public key.
- In Twilio Console, go to Voice > Recordings > Settings.
- In the Voice Recording encryption section, select Enable.
- For Select a public key, choose the public key to use for encryption, or select Create new public key and provide a friendly name and the contents of your public key in PEM format.
- Select Save.
Dual-channel Recording for Conference records new Conference Recordings in dual-channel format by default. The first channel contains the audio of the first Participant that joined the Conference. The second channel contains all other audio from the call. Read the Dual-channel Conference Recordings Changelog entry to understand the implications of turning on this setting.
After you turn on this setting, new Conference Recordings are saved in dual-channel format by default. Existing Recordings and non-Conference Recordings aren't affected.
- In Twilio Console, go to Voice > Recordings > Settings.
- In the Dual-channel Recording for Conference section, select Enable.
- Select Save.
To retrieve a dual-channel Recording, include the RequestedChannels=2 query parameter on your request to the Recording resource.