SuperAPI AI 工具集

twilio-call-recordings

办公与效率

查看项目

更新于 10-16 08:02

技能介绍

用途:帮助开发者正确为 Twilio 语音通话录音,避免最常见错误——用 <Record> 实现通话录音,结果只录到主叫(语音留言式行为)。

主要录音方式:<Record> 仅录主叫,适合留言或采集输入;<Dial record> 录双方,用于双方通话录音;<Start><Recording> 可与其他动词并行启动录音。Conference record 录制会议混音;Recordings REST API 可在通话中程序化控制(如支付时暂停)。

常用模式:<Dial record> 支持 record-from-answer、record-from-answer-dual(左声道主叫/右声道坐席,适合质检)、record-from-ringing、record-from-ringing-dual。做质检与分析建议用双声道。

前提:具备语音能力的 Twilio 号码、TWILIO_ACCOUNT_SID 与 TWILIO_AUTH_TOKEN,SDK 安装 pip install twilio 或 npm install twilio,并准备录音状态回调的 webhook 端点;录音同意要求因地区而异,需合规检查。

要点:生产环境应校验 X-Twilio-Signature,防止伪造录音 URL。ConversationRelay 场景下 REST API 的 record:true 会被静默忽略,须在 <Connect> 前用 <Start><Recording>。暂停/恢复录音只能通过 REST API(status="paused" 或 "in-progress")。PCI 合规下切勿录卡号,优先用 <Pay>;PCI Mode 不可逆且账户级生效。

限制:会议录音始终为单声道,且不含教练/耳语音频;录音轨道隔离不能靠 TwiML 的 recordingTrack;PCI 模式期间的录音无法转写。录音默认存于 Twilio 云、WAV(可加 .mp3 取 MP3)、无限期保留,需自行删除或配置自动删除;双声道文件约为单声道两倍。

资料未提供官方 URL 与具体命令之外的安装信息。