用途:Sinch Voice API 用于通过 REST 编程发起、接听与控制语音通话,适合构建 TTS 外呼、IVR 菜单、DTMF 输入、电话会议、通话录音等语音应用。呼叫流程由 SVAML(Sinch Voice Application Markup Language)通过回调事件定义。
主要能力:每个 SVAML 响应包含多个 instructions(如 playFiles、say、sendDtmf、setCookie、answer、startRecording、stopRecording)和恰好一个 action(如 hangup、continue、connectPstn、connectMxp、connectConf、connectSip、connectStream、runMenu、park)。回调事件包括 ICE、ACE、DiCE、PIE 与 Notify。呼叫类型有 ttsCallout、conferenceCallout、customCallout。REST 端点涵盖 callouts、call 信息更新、conference 管理、号码配置与回调 URL 配置。
使用方式:凭据需存入环境变量,例如 export SINCH_APPLICATION_KEY 与 SINCH_APPLICATION_SECRET,切勿硬编码。认证使用 Application Key + Application Secret,基本认证为 Authorization: Basic base64(APPLICATION_KEY:APPLICATION_SECRET),生产环境使用 HMAC-SHA256 签名请求。区域基础 URL 包括 https://calling.api.sinch.com 及北美、欧洲、东南亚、南美等区域;配置端点使用 https://callingapi.sinch.com。SDK 支持 Node.js、Python、Java、.NET,安装与初始化参见 sinch-sdks。TTS 外呼示例:curl -X POST "https://calling.api.sinch.com/calling/v1/callouts" -u "$SINCH_APPLICATION_KEY:$SINCH_APPLICATION_SECRET"。
限制与注意:回调 URL 必须可公开访问,本地开发可用 ngrok。每个 SVAML 响应只能有一个 action,instructions 可多个。应用内目的地不发送 ACE。DiCE 为 fire-and-forget 仅用于日志。区域端点影响延迟,会议室有区域范围。最大通话时长 14400 秒,可在 connectPstn/connectSip 设置 maxDuration。生产环境必须验证回调 HMAC-SHA256 签名。connectMxp 不支持录音。runMenu 默认 barge: true、timeoutMills: 5000。TTS 外呼必须提供 cli 号码。录音与转写属 PII,需做好保留与访问控制。具体价格、可用区域细节等暂未提供。