Telnyx Numbers - Go 是 Telnyx 提供的 Go 语言客户端库，用于以编程方式搜索、订购和管理电话号码。安装命令为 go get github.com/team-telnyx/telnyx-go，使用时通过 option.WithAPIKey 传入 TELNYX_API_KEY 初始化客户端。
用途与主要能力：搜索可用电话号码（client.AvailablePhoneNumbers.List，支持 Filter 过滤器）；创建号码订单（client.NumberOrders.New，需 PhoneNumbers，可选 ConnectionId、MessagingProfileId、BillingGroupId）；查询订单状态（client.NumberOrders.Get）；创建与查询号码预约（NumberReservations.New/Get，可 Extend 延长）；高级订单的列表、创建、更新需求组与查询（AdvancedOrders）；可用号码块查询（AvailablePhoneNumberBlocks.List）；评论管理（Comments）；国家覆盖范围、客户服务记录、号码块订单、号码订单号码等操作。
使用要点：号码须为 E.164 格式（如 +13125550001），含加号与国家代码，不能有空格、横线或括号。分页可使用 ListAutoPaging() 自动迭代。所有 API 调用都可能失败，需处理网络错误及 401、403、404、422、429 等状态码，429 建议指数退避重试。
限制：不要自行编造 Telnyx 参数、枚举、响应字段或 webhook 字段；若所需参数或字段未在文档中列出，应先查阅 references/api-details.md，在使用 Additional Operations 前阅读可选参数与响应 schema 章节。官方资料未提供收费、价格与具体适用场景等信息。