SuperAPI AI 工具集

telnyx-voice-go

通用与其它

查看项目

更新于 10-16 03:37

技能介绍

用途:Telnyx Voice 的 Go 客户端库,用于以编程方式控制电话通话,并接收实时通话事件。

主要能力:拨打外呼(client.Calls.Dial,POST /calls)、接听来电后执行后续指令(client.Calls.Actions.Answer)、转接在线通话(Transfer)、挂断(Hangup)、桥接(Bridge)、拒接(Reject,Cause 支持 CALL_REJECTED、USER_BUSY)、查询通话状态(GetStatus)、列出某连接下的活动通话(Connections.ListActiveCalls),以及管理 Call Control Application(List/New/Get/Update/Delete)。资料还提到 SIP Refer、Send SIP Info 等操作,完整参数见 references/api-details.md。

使用方式:go get github.com/team-telnyx/telnyx-go 安装;创建客户端 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY")));电话号码须为 E.164 格式(带 + 和国家代码,不含空格、横线、括号);分页用 ListAutoPaging()。webhook 使用 Ed25519 签名,包含 telnyx-signature-ed25519 与 telnyx-timestamp 头,需在处理器中用 client.Webhooks.Unwrap(body, r.Header) 校验。

适用场景:需要程序化语音控制、呼入呼出流程自动化、通话转接与桥接、DTMF 收集、音频流,以及用 webhook 驱动实时通话状态的应用。

限制:通话控制是事件驱动的,外呼以 dial() 开始,呼入必须在收到 incoming webhook 后先接听再执行其他命令;需要公网可访问的 webhook 端点,否则通话虽可接通但应用无法驱动实时通话状态。API 调用可能因网络、限流(429)、校验(422)、认证(401)等失败,生产代码需捕获错误并处理。资料未提供定价、收费或具体平台兼容性说明。