用途:通过 Telnyx 官方 Ruby SDK 管理托管短信号码(hosted number orders)、提交免费电话号码验证请求,并接入 RCS 富消息能力,适用于号码迁移和启用富媒体消息的场景。
主要能力:RCS 消息发送(POST /messages/rcs)、生成 RCS deeplink、列出/查询/修改 RCS 代理、单条与批量检查 RCS 能力、添加 RCS 测试号码;托管号码订单的创建、查询、删除、上传文档、创建与校验验证码;免费电话验证请求的列出、提交、查询与更新。
使用方式:安装 gem install telnyx,初始化 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]),调用对应方法(如 client.messages.rcs.send_、client.messaging_hosted_number_orders.create、client.messaging_tollfree.verification.requests.create)。号码须使用 E.164 格式(如 +13125550001,无空格、横线、括号)。分页可用 page.auto_paging_each 迭代。
错误处理:常见代码 401 无效密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流(使用指数退避重试,参考 Retry-After)。生产代码建议捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError。
限制:资料未提供定价、配额、区域可用性或速率上限细节;验证请求与订单状态需按接口返回的状态枚举处理。