SuperAPI AI 工具集

telnyx-voice-gather-ruby

通用与其它

查看项目

更新于 10-16 04:57

技能介绍

用途:在 Ruby 项目中调用 Telnyx Call Control API,从通话中采集 DTMF 按键或语音信息,用于构建交互式语音菜单(IVR)和 AI 语音助手。

安装与初始化:gem install telnyx;require "telnyx" 后用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 创建客户端。

主要能力:标准 gather 采集 DTMF,可设置 valid_digits、最小/最大位数、终止符与超时;gather_using_audio 在播放音频期间采集;gather_using_speak 先做 TTS 再采集,需提供 voice 与 payload,支持 SSML 与多语言;gather_using_ai 通过 JSON Schema parameters 让语音助手采集信息并返回 conversation_id;另有 AI 助手启动、停止、追加消息接口。

用法:gather 前必须先执行 Answer 命令;调用如 client.calls.actions.gather(call_control_id)、client.calls.actions.gather_using_ai("call_control_id", parameters: {...})。Webhook 使用 Ed25519 签名,请求头含 telnyx-signature-ed25519 与 telnyx-timestamp,需用 client.webhooks.unwrap(payload, headers) 校验后再处理。

事件:callGatherEnded、CallAIGatherEnded、CallAIGatherMessageHistoryUpdated、CallAIGatherPartialResults,负载包含 call_control_id、digits、result、status 等字段。

限制:需先获取 API Key 并开启 Call Control;语音识别与 AI 采集依赖网络,生产代码应处理 401、403、404、422、429 等错误并对 429 做退避重试;具体计费、平台与配额信息暂未提供。