Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Record Voicemail Widget

Studio uses Widgets to represent various parts of Twilio's functionality that can then be stitched together in your Studio Flow to build out robust applications that require no coding on your part.



New to Twilio Studio? Check out our Getting Started guide!

The Record Voicemail Widget allows you to record voicemail audio from a caller and, optionally, transcribe it.

A rectangular widget titled 'record_voicemail'. Attached transition anchors read 'recording complete,' 'no audio,' and 'hangup.'.

Optional configuration for Record Voicemail

optional-configuration-for-record-voicemail page anchor

While the Record Voicemail Widget doesn't require any configuration to work other than an entry transition, several optional configuration settings can help you customize the experience in your Studio Flow.

NameDescriptionSupported ValuesDefault
Stop recording after __ seconds of silenceThe number of seconds this Widget will wait when it detects silence from your caller before terminating the voicemail recordingAny integer, representing seconds5
Stop recording on keypressThe phone key a user should press to stop recording their voicemail0-9, #, *None
Max recording lengthMaximum length of a recording (in seconds)Any integer between 1 and 14,400, representing seconds3600
Transcribe audio to textTurn this on to transcribe the caller's recordingOn / OffOff
Transcription callback URLOnly available if transcription is enabled. The URL where Twilio should send the callback with transcription resultsAny accessible URLNone
TrimTrim silence from the end of a recordingTrim silence / Do not trimTrim silence
Play beepPlay a beep to the caller before recordingTrue / FalseTrue
Recording status callbackThe URL that should receive a callback with the recording, once completeAny valid URL or liquid template variableNone


Studio does not automatically handle transcription processing, but you can specify the transcription callback URL and handle it yourself when the transcription is available. You may wish to use a Function to customize what happens once after a voicemail has been recorded(link takes you to an external page).

Record Voicemail Transitions

record-voicemail-transitions page anchor

These events trigger transitions from this Widget to another Widget in your Flow. For more information on working with Studio Transitions, see the Getting Started Guide.

Recording completeThe caller has finished recording their voicemail
No audio (applies only to legacy Twilio accounts)No voicemail is recorded due to silence from the caller
HangupThe caller terminated the call by hanging up

Record Voicemail Variables

record-voicemail-variables page anchor

If you wish to play back a voicemail later in the Studio Flow where you recorded the voicemail, you can access the audio file from a Say/Play Widget using the variable widgets.MY_WIDGET_NAME.RecordingUrl.

When the Record Voicemail Widget executes, it will have stored the following variables for use throughout your Studio Flow. When accessing these variables, make sure you replace MY_WIDGET_NAME with the name of your Widget. For more information on working with variables in Studio, see the Getting Started Guide.

Find definitions and examples for these variables at the Call Recording page.

NameLiquid Template Language
Account SID{{widgets.MY_WIDGET_NAME.AccountSid}}
API Version{{widgets.MY_WIDGET_NAME.ApiVersion}}
Call SID{{widgets.MY_WIDGET_NAME.CallSid}}
Call Status{{widgets.MY_WIDGET_NAME.CallStatus}}
Date Created{{widgets.MY_WIDGET_NAME.DateCreated}}
Date Updated{{widgets.MY_WIDGET_NAME.DateUpdated}}
Price Unit{{widgets.MY_WIDGET_NAME.PriceUnit}}
Recording URL{{widgets.MY_WIDGET_NAME.RecordingUrl}}
Recording Duration{{widgets.MY_WIDGET_NAME.RecordingDuration}}

Example: forward voicemail recordings

example-forward-voicemail-recordings page anchor

This Studio Flow takes an incoming phone call, prompts the caller to leave a voicemail, and then forwards the voicemail to a Twilio Function.

A Studio Flow that takes an incoming call, reads a greeting, records a voicemail, and sends the recording to a Function.

Looking to learn how to record voicemails in Studio in a real-world example?

We can't wait to see what you build!

Rate this page: