用途:该技能面向使用 Telnyx Ruby SDK 的开发者,提供高级呼叫控制功能,包括 DTMF 发送、SIPREC 录音、噪声抑制、客户端状态管理、AI 助手会话加入和主管控制等。
主要能力:可向通话发送 DTMF 音;启动和停止 SIPREC 会话以对接 SIPREC 连接器 SRS,并接收 siprec.started/stopped/failed 事件;启动/停止噪声抑制(BETA),支持 direction 与 noise_suppression_engine 等参数;更新 client_state;把额外通话腿加入正在进行的 AI 助手会话;切换桥接通话的 supervisor 角色(如 barge)。
使用方式:先安装 gem install telnyx,再用 require "telnyx" 初始化 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]),然后通过 client.calls.actions.* 调用对应端点,例如 send_dtmf、start_siprec、stop_siprec、start_noise_suppression、stop_noise_suppression、update_client_state、join_ai_assistant、switch_supervisor_role。Webhook 使用 Ed25519 签名,请求头含 telnyx-signature-ed25519 与 telnyx-timestamp,可用 client.webhooks.unwrap(payload, headers) 校验。
适用场景:需要高级语音控制的 Ruby 应用,如自动拨号、通话录音、降噪、AI 语音会话和客服主管监听。限制:部分功能标注为 BETA;API 调用可能返回 401/403/404/422/429 等错误,生产代码需处理网络错误、限流与校验错误;资料未提供定价、配额或完整字段说明。