用途:该技能面向 Ruby 开发者,基于 Telnyx API 实现通话音频的实时处理,包括将通话媒体流式传输到指定 WebSocket 或 Dialogflow 连接、把媒体分叉到外部目标,以及启动实时语音转写,可用于实时音频分析、欺诈检测或生成 AI 音频响应等场景。
主要能力:提供通话分叉(fork)与流式传输(streaming)的启动和停止命令,支持指定目标地址、编解码器、采样率、双向模式、轨道等参数;提供实时转写(transcription)的启动和停止,可选转写引擎(Google、Telnyx、Deepgram、Azure 等)。流式音频以 base64 编码的 RTP 载荷封装在 JSON 中传输。
使用方式:先安装 gem install telnyx,再用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端。调用 client.calls.actions.start_forking、stop_forking、start_streaming、stop_streaming、start_transcription、stop_transcription 等方法,传入 call_control_id。Webhook 使用 Ed25519 签名,请求头包含 telnyx-signature-ed25519 和 telnyx-timestamp,需用 client.webhooks.unwrap(payload, headers) 验签。
适用场景:实时通话分析、AI 语音交互、实时转写与合规审计等。
限制:所有 API 调用可能因网络、限流(429)、校验(422)或认证(401)失败,生产代码需处理错误并按 Retry-After 退避重试。分叉请求必须指定 target 或 rx/tx 属性。转写在通话挂断时自动停止。具体价格、平台支持范围等资料暂未提供。