SuperAPI AI 工具集

telnyx-texml-ruby

通用与其它

查看项目

更新于 10-16 04:30

技能介绍

用途:该技能面向使用 Ruby 构建 Telnyx 语音应用的开发者,通过 TeXML(与 TwiML 兼容的标记语言)管理应用、呼叫、会议、录音、队列和媒体流。

主要能力:覆盖呼叫资源(获取多个呼叫、发起外呼、获取/更新单个呼叫)、呼叫录音(获取、请求、更新)、Siprec 会话(请求与更新)、媒体流(启动与更新)、会议资源(列表、获取、更新)、会议参与者(列表、拨入、获取、更新、删除)、会议录音(列表、获取)、队列资源(列表、创建、获取、更新、删除)以及账户级录音资源。

使用方式:安装 gem install telnyx;初始化 require "telnyx" 与 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。调用示例:client.texml.accounts.calls.retrieve_calls("account_sid")、client.texml.accounts.calls.calls("account_sid", params: {Url: "https://www.example.com/texml.xml"})。分页使用 page.auto_paging_each { |item| puts item.id }。

错误处理:需捕获 Telnyx::Errors::APIConnectionError、RateLimitError(429,建议指数退避并参考 Retry-After)、APIStatusError(如 422 校验错误)。常见状态码:401 无效密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流。

限制:部分端点最终一致性;更新呼叫时 payload 键必须使用 CamelCase;外呼需在 Mission Control Portal 为连接配置 XML Request URL。具体收费、价格与平台支持情况暂未提供。