メニュー

通話録音

Studio uses Widgets to represent various parts of Twilio's API 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 Call Recording Widget allows you to switch Voice Call Recording ON or OFF at any point during a call flow.

通話録音

Notice
The Call Recording widget can only be used for Incoming Calls and must be placed after an initial Say/Play or Gather widget. Be sure to announce to the caller that the call is being recorded, if your local laws require it.

Required Configuration for Call Recording

The Call Recording Widget requires specification on whether the Recording should be switched on or off.

名前 概要 初期値
Record Call A toggle button (boolean) to allow users to Toggle Call Recording to On or Off within a Call Flow. false

These options are not for pausing and resuming a Video Recording — they are specifically meant for Start and Stop actions. Please read Legal Considerations with Recording Voice and Video Communications.

Optional Configuration for Call Recording

The Call Recording Widget also accepts a number of configuration options that you can use to declare recording Status Call back Url, Recording Channels, and trim behaviour for the request initiated by this Widget.

名前 概要 初期値
Recording Status Callback URL The URL we should call using the recording_status_callback_method on each recording event specified in recording_status_callback_event. empty
RecordingStatusCallbackMethod The HTTP method we should use to call recording_status_callback. Can be GET or POST POST
Recording Status Event The recording status events on which we should call the recording_status_callback URL. Can be: in-progress, completed and absent. Separate multiple event values with space. completed
RecordingChannels The number of channels used in the recording. Can be: mono or dual. mono records all parties of the call into one channel. dual records each party of a 2-party call into separate channels. dual
Trim Whether to trim any leading and trailing silence in the recording. Can be: trim-silence or do-not-trim. trim-silence trims the silence from the beginning and end of the recording and do-not-trim does not. do-not-trim

Call Recording Transitions

These events trigger transitions from this Widget to another Widget in your Flow. For more information on working with Studio transitions, see this guide.

名前 概要
success The call recording was successfully toggled.
失敗 Could not toggle call recording.

Call Recording Variables

When the Call Recording Widget executes, it will have stored the following variables for use throughout your Studio Flow (where MY_WIDGET_NAME is the name of your actual widget). For more information on working with variables in Studio, see this guide.

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

名前 Liquid Template Lanugage
Account SID {{widgets.MY_WIDGET_NAME.AccountSid}}
ApiVersion {{widgets.MY_WIDGET_NAME.ApiVersion}}
Call SID {{widgets.MY_WIDGET_NAME.CallSid}}
Channels {{widgets.MY_WIDGET_NAME.Channels}}
Conference SID {{widgets.MY_WIDGET_NAME.ConferenceSid}}
作成日 {{widgets.MY_WIDGET_NAME.DateCreated}}
更新日 {{widgets.MY_WIDGET_NAME.DateUpdated}}
Duration {{widgets.MY_WIDGET_NAME.Duration}}
Encryption Details {{widgets.MY_WIDGET_NAME.EncryptionDetails}}
エラー コード {{widgets.MY_WIDGET_NAME.ErrorCode}}
Price {{widgets.MY_WIDGET_NAME.Price}}
PriceUnit {{widgets.MY_WIDGET_NAME.PriceUnit}}
レコーディングSID {{widgets.MY_WIDGET_NAME.Sid}}
Recording Uri {{widgets.MY_WIDGET_NAME.Uri}}
Source of Recording Start {{widgets.MY_WIDGET_NAME.Source}}
開始時刻 {{widgets.MY_WIDGET_NAME.StartTime}}
Status {{widgets.MY_WIDGET_NAME.Status}}

Example: Client Feedback

In this Flow, a client will be notified that their call will be recorded. The call recording will then proceed and, if successful, will ask the client what their experience was like. After the client stops talking, the recording will be stopped. The specified Recording Status Callback URL for the Widget will handle all events of the recording.

Twilio Studio Call Recording Widget Example

さらに詳しく

Now that you know the basics of the Call Recording Widget, you may want to learn more about Recordings:

皆さまが何を開発されるのか、目にするのが待ちきれません!

ページを評価:

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

フィードバックくださりありがとうございます!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

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