用途:帮助开发者正确实现 Twilio 语音通话录音,避免最常见的错误——用 <Record> 代替 <Dial record>,导致只录到主叫(语音留言行为)而非双方通话。
主要能力:区分多种录音方式。<Record> 仅录主叫,适合留言;<Dial record> 录双方,适合双人通话;<Start><Recording> 可与其他动词并行启动录音,用于 ConversationRelay 与多动词流程;Conference record 录会议混音;Recordings REST API 支持通话中程序化控制。
使用方式:安装 SDK(pip install twilio / npm install twilio),配置 TWILIO_ACCOUNT_SID 与 TWILIO_AUTH_TOKEN,并准备录音状态回调的 webhook 端点。双人通话用 <Dial record="record-from-answer-dual"> 并设置 recording_status_callback;QA 与分析建议用双声道,便于区分坐席与客户。ConversationRelay 场景下 REST API 的 record:true 会被静默忽略,须在 <Connect> 前用 <Start><Recording>。PCI 合规可在通话中通过 REST API 将录音 status 设为 paused / in-progress 暂停与恢复。
适用场景:客服质检、语音分析、会议录音、合规留证。
限制:recordingTrack 在 TwiML 中无效,需用 REST API;会议录音始终为单声道且不含 coach/whisper 音频;PCI 模式不可逆且账号级生效,启用后录音无法转写;录音默认无限期保留,需手动或配置自动删除;双声道文件约为单声道两倍。录音同意要求因司法辖区而异,生产环境应校验 X-Twilio-Signature。