用途:该技能面向使用 Go 语言调用 Telnyx 语音高级呼叫控制 API 的开发者,封装了 DTMF 发送、SIPREC 录音、噪声抑制、客户端状态更新、主管角色切换以及 AI 助手会话与 Conversation Relay 等操作。
主要能力:支持向通话腿发送 DTMF 音;启动/停止 SIPREC 会话(可配置连接器、传输方式、录音轨道、超时与安全选项);启动/停止噪声抑制(BETA,可选方向与抑制引擎);更新客户端状态;切换桥接通话的主管角色;将参与者加入 AI 助手会话;启动/停止 Conversation Relay,把通话音频接入自有 WebSocket,由 Telnyx 处理语音识别与文本转语音。
使用方式:安装命令为 go get github.com/team-telnyx/telnyx-go。初始化客户端时通过 option.WithAPIKey(os.Getenv("TELNYX_API_KEY")) 传入 API Key。各操作以 client.Calls.Actions 下的方法调用,需提供 call_control_id 及对应参数。Webhook 使用 Ed25519 签名,请求头包含 telnyx-signature-ed25519 与 telnyx-timestamp,可用 client.Webhooks.Unwrap(body, r.Header) 校验。
适用场景:需要在 Go 服务中实现高级语音控制、通话录音、降噪、AI 语音会话接入或主管监听/介入等功能的场景。
限制:噪声抑制标注为 BETA;同一通话同时只能有一个 AI Assistant 或 Conversation Relay 会话处于活动状态;API 调用可能返回 401、403、404、422、429 等错误,生产代码需处理网络错误与限流重试;部分参数与事件字段资料未完整提供。