该技能用于通过 Telnyx Ruby SDK 生成和查询账户用量报表,适用账单核对、用量分析与对账场景。
安装:gem install telnyx。初始化时可省略 api_key,默认读取 TELNYX_API_KEY 环境变量。
主要能力:获取通话事件(GET /call_events,未指定 leg_id 或 application_session_id 时仅返回最近 24 小时事件);创建与查询账本账单组报表;管理 MDR 消息明细报表、CDR 语音明细报表的请求、查询与删除,并可获取 CDR 可用字段;管理 MDR 与 CDR 用量报表及号码查询用量报表;管理号码 CSV 下载;同步生成并获取 CDR 用量报表(无需轮询,但响应可能需数分钟)。
用法要点:列表接口支持 .auto_paging_each 分页迭代;创建明细报表通常需 start_time、end_time 等必填参数,并按需传入 filters、connections、profiles、report_name、timezone 等可选字段;删除接口按 id 操作。
错误处理:所有调用可能返回网络错误、429 限流、422 校验错误或 401 认证错误。示例建议捕获 Telnyx::Errors::APIConnectionError、RateLimitError 与 APIStatusError;429 可参考 Retry-After 响应头做指数退避重试。常见状态码含义:401 无效密钥、403 权限不足、404 资源不存在、422 校验失败、429 限流。
限制:技能仅给出 SDK 示例与接口说明,未提供具体价格、配额或完整业务规则;同步报表响应可能需要等待数分钟。部分接口为 legacy 路径,其具体可用性与弃用时间暂未提供。