用途:该技能面向使用 Telnyx 平台管理电话号码配置的 Ruby 开发者,提供通过官方 Ruby SDK 调用号码相关 API 的示例,用于配置来电显示、呼叫转移、消息启用、连接分配等设置。
主要能力:列出与检索电话号码(含精简列表 /phone_numbers/slim、语音设置 /phone_numbers/voice、消息设置 /phone_numbers/messaging 等视图);更新单个号码(PATCH /phone_numbers/{id},可设置 connection_id、billing_group_id、tags、hd_voice_enabled 等);删除号码;验证号码归属(POST /phone_numbers/actions/verify_ownership);批量更新消息配置(POST /messaging_numbers_bulk_updates)并查询状态;批量作业包括删除号码、更新紧急设置、更新号码(每次最多一千个号码);变更号码的 bundle 状态。
使用方式:安装 gem install telnyx,使用 require "telnyx" 并以 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端。号码须为 E.164 格式(如 +13125550001),含 + 与国家代码,不含空格、连字符或括号。分页可用 .auto_paging_each 自动迭代。
限制与错误处理:API 调用可能因网络、限流(429)、校验(422)或认证(401)失败,生产代码应捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError 等异常;429 建议按 Retry-After 退避重试。批量作业每次最多一千个号码,更新作业至少需提交一个可更新字段。具体收费、价格与平台支持范围资料未提供。