Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

Recording configurations


Recording configurations let you define reusable recording settings for your voice calls. Instead of specifying recording parameters on every API call, you create a reusable configuration that controls how audio is composed, which callbacks fire, and which features apply.

(information)

Info


Create a recording configuration

create-a-recording-configuration page anchor

To create a recording configuration using Twilio Console, follow these steps:

  1. In the Console, go to Products & services > Voice > Recordings > Configurations(link takes you to an external page).
  2. Select Create configuration.
  3. On the Name configuration step, enter a name and description for the configuration.
  4. On the Composition policy step, choose how Twilio captures and composes audio. See Composition policy.
  5. On the Callback settings step, configure where Twilio sends recording events. See Callback settings.
  6. On the Features step, attach a batch transcription configuration. See Transcription configuration.
  7. On the Summary step, review your settings, and then select Create configuration.

The following sections describe each setting you configure in the wizard.

Composition policy

composition-policy page anchor

Composition policy defines how recording audio is captured, whether silence is trimmed, and which tracks are included.

To record each party on a separate channel, set Channel to Dual. To record all parties in one channel, choose Mono.

The Trim silence field controls whether Twilio keeps silence in the recording. Select Do not trim to keep the full audio, or Trim silence to remove silence from the beginning and end of the recording.

The Track field controls which side of the call Twilio captures. Select Both to capture audio that Twilio receives and generates, Inbound to capture only audio that Twilio receives, or Outbound to capture only audio that Twilio generates.

The default composition policy uses Dual channels, Do not trim, and Both tracks.

Configure callbacks separately for Call recording status callback and Conference recording status callback.

For each callback, provide the following:

  • Webhook URL: The endpoint that receives recording events (up to 2,048 characters).
  • HTTP method: POST or GET.
  • Events: Select which recording events trigger the callback — In-progress, Completed, Absent, or Failed.

Transcription configuration

transcription-configuration page anchor

You can attach up to three batch transcription configurations to a recording configuration. This automatically transcribes your recordings after the call completes.

(warning)

Warning

The Features step isn't available on PCI or HIPAA accounts, on accounts that use Conversation Intelligence (classic), or on accounts that have recording encryption or external storage enabled.

To attach a transcription configuration, follow these steps:

  1. On the Features step, select a batch transcription configuration from the list.
  2. Optional: Add a description for context.
  3. To attach another, select Add another transcription configuration. You can attach up to three.

You can attach transcription configurations at any time from the recording configuration details page.


Edit a recording configuration

edit-a-recording-configuration page anchor

To edit an existing recording configuration using Twilio Console, follow these steps:

  1. In the Console, go to Products & services > Voice > Recordings > Configurations(link takes you to an external page).
  2. Select a configuration from the list.
  3. Select Edit on the section you want to update.
  4. Make your changes, and then select Save.

Delete a recording configuration

delete-a-recording-configuration page anchor

To delete a recording configuration using Twilio Console, follow these steps:

  1. In the Console, go to Products & services > Voice > Recordings > Configurations(link takes you to an external page).
  2. Select a configuration from the list.
  3. Select Delete recording configuration.
(warning)

Warning

Deleting a recording configuration is permanent. New calls that reference the deleted configuration won't apply its settings.