用途：通过官方 Ruby SDK 调用 Telnyx Messaging API，发送与接收 SMS/MMS，并处理投递状态与退订等 webhook，适用于通知、2FA、消息类应用。
安装与初始化：执行 gem install telnyx，然后 require "telnyx" 并通过 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 创建客户端。
主要能力：client.messages.send_ 发送 SMS；send_with_alphanumeric_sender 用字母数字发送方 ID；send_group_mms 群发 MMS；send_long_code、send_short_code、send_number_pool 分别走长码、短码和号码池路径；schedule 定时发送；send_whatsapp 发送 WhatsApp 消息。另有消息检索与取消、字母数字发送方 ID 增删查、托管号码管理、退订列表、消息配置指标与自动回复配置等操作。
用法要点：手机号必须为 E.164 格式（如 +13125550001），含 + 和国家码，不能有空格、短横线或括号。分页可用 page.auto_paging_each { |item| puts item.id }。webhook 使用 Ed25519 签名，请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头，需用 client.webhooks.unwrap(payload, headers) 校验。
限制与注意：发送方号码须先绑定到正确的消息配置；美国 A2P 长码流量在生产发送前须完成 10DLC 注册，否则会被运营商拦截或大量过滤。投递 webhook 为异步，发送响应只代表请求被接受，不代表运营商最终投递。需处理网络错误及 401/403/404/422/429 等错误码，429 建议指数退避重试。不要臆造参数、枚举、响应字段或 webhook 字段；未内联说明的字段需查阅参考资料。具体收费与价格资料暂未提供。