SuperAPI AI 工具集

telnyx-voice-media-javascript

通用与其它

查看项目

更新于 10-16 04:31

技能介绍

用途:该技能用于在 Telnyx 通话控制流程中操作语音媒体,包括播放音频文件、文字转语音(TTS)播报、通话录音(开始/停止/暂停/恢复)以及录音转写。适用于构建 IVR 系统、播放公告、录制通话等场景。

安装与初始化:npm install telnyx@6.74.2;通过 import Telnyx from 'telnyx' 引入,new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 初始化客户端。

主要能力:

  • 播放音频:POST /calls/{call_control_id}/actions/playback_start,可指定 audio_type、audio_url、cache_audio、loop、overlay 等;overlay 开启时 target_legs 仅限 self。连续下发会排队播放。停止用 playback_stop。
  • 语音播报:POST /calls/{call_control_id}/actions/speak,必填 payload 与 voice,可选 language、payload_type(text/ssml)、service_level、target_legs 等;连续下发同样排队。
  • 录音:record_start(必填 format、channels,可选 max_length、play_beep、recording_track、transcription 及相关转写参数)、record_stop、record_pause、record_resume。

Webhook:事件包括 call.playback.started/ended、call.speak.started/ended、call.recording.saved/error、call.recording.transcription.saved。请求头含 telnyx-signature-ed25519 与 telnyx-timestamp,Telnyx 使用 Ed25519 签名,建议用 client.webhooks.unwrap() 校验;需使用原始请求体(raw body)而非已解析 JSON。

错误处理:调用可能返回 401(无效 API Key)、403(权限不足)、404、422(校验错误)、429(限流,按指数退避重试)。生产代码应捕获 APIConnectionError、RateLimitError、APIError。

限制:具体计费、价格与配额资料暂未提供。