用途:TwiML 是 Twilio 在通话期间执行的 XML。服务器响应 Twilio 的 webhook POST 返回 TwiML 文档,Twilio 据此执行通话逻辑。流程为:主叫 → Twilio → POST 到你的 webhook → 服务器返回 TwiML → Twilio 执行。
前提:具备支持语音的 Twilio 号码与账号;webhook 端点返回 TwiML 且 Content-Type 为 text/xml;如需编程生成 SDK,可执行 pip install twilio 或 npm install twilio。
主要能力:Say 文本转语音(voice 可选 alice、man、woman 或 Polly/Google TTS);Gather 收集按键或语音,Digits 参数 POST 到 action;Play 播放公开可访问的 MP3/WAV;Dial 连接其他号码;Record 录制主叫语音,支持 max_length、transcribe 与 transcribe_callback;Conference 多方通话;Pay 用于 PCI 合规收款。
使用方式:用 Python(Flask)或 Node.js(Express)构造 VoiceResponse,添加动词后以 text/xml 返回。示例:response.gather(num_digits=1, action="/menu-choice") 与 gather.say(...);Node 中 response.gather({ numDigits: 1, action: "/menu-choice" })。语音留言可用 Dial 的 action URL 配合 Record 实现。
限制:webhook 必须返回正确 Content-Type,响应不得超过 15 秒;Say 单条不超过 4096 字符;Pay Connectors 仅能在 Console 配置,无 REST API;PCI Mode 启用后不可逆,建议用独立子账号;Record 只录主叫,不用于双方通话录音。生产环境不要用 ngrok,需 HTTPS 公网地址并配置 fallback URL;webhook 无状态,状态需通过 URL 参数或 Redis/数据库按 CallSid 保存,勿用内存状态。
适用场景:IVR 菜单、语音留言、呼叫转接、会议与合规收款等语音通话逻辑。其他细节暂未提供。