SuperAPI AI 工具集

telnyx-voice-ruby

通用与其它

查看项目

更新于 10-16 08:41

技能介绍

用途:Telnyx Voice 的 Ruby SDK 技能,用于以编程方式控制电话通话,包括拨打与接听、转接、桥接、DTMF 采集和音频流,并通过 webhook 接收实时通话事件。

主要能力:client.calls.dial() 发起外呼;client.calls.actions.answer() 接听呼入;transfer() 转接、bridge() 桥接、hangup() 挂断、reject() 拒接、refer() 与 send_sip_info();retrieve_status() 查询通话状态;connections.list_active_calls() 列出连接下的活跃通话;call_control_applications 的增删改查。

使用方式:安装 gem install telnyx,初始化 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。号码须为 E.164 格式(如 +13125550001)。分页可用 page.auto_paging_each。webhook 使用 Ed25519 签名,请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境应通过 client.webhooks.unwrap(payload, headers) 校验。

适用场景:需要事件驱动的实时通话控制,例如外呼、呼入应答、转接与桥接、DTMF 采集、音频流及通话状态跟踪。

限制:Call Control 为事件驱动,dial() 或收到呼入 webhook 后需在 webhook 处理器中用 call_control_id 下发后续命令;外呼与呼入流程不同,呼入须先从 webhook 应答;真实通话控制需要公网可达的 webhook 端点。常见错误码包括 401、403、404、422、429。不要臆造参数、枚举、响应字段或 webhook 字段,未内联的字段需查阅 references/api-details.md。部分可选参数与完整响应结构暂未提供。