用途：通过 Telnyx Java SDK（com.telnyx.sdk）在 Java 应用中发送和接收 SMS/MMS，处理投递状态 webhook，适合通知、双因素认证（2FA）及消息类应用。
安装与初始化：Maven 依赖为 groupId com.telnyx.sdk、artifactId telnyx、version 6.89.0；Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.89.0")。通过 TelnyxClient client = TelnyxOkHttpClient.fromEnv(); 初始化客户端，后续示例均假设已初始化。
主要能力：核心发送方法 client.messages().send() 支持 to、from、text 必填参数及 messagingProfileId、mediaUrls、webhookUrl 等可选参数；另提供 sendWithAlphanumericSender（字母数字发送方 ID）、sendGroupMms（群发 MMS）、sendLongCode、sendNumberPool、sendShortCode、schedule（定时发送）和 sendWhatsapp。辅助操作包括 retrieve（获取消息状态）、cancelScheduled（取消定时消息）及 alphanumericSenderIds 的 list/create/retrieve。列表方法支持 .autoPager() 自动翻页，也可用 .hasNextPage() 与 .nextPage() 手动控制。
Webhook：Telnyx 使用 Ed25519 签名，请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头，需在生产中通过 client.webhooks().unwrap() 校验签名。事件包括 message.sent、message.finalized、message.received 等。
限制与注意事项：电话号码须为 E.164 格式（如 +13125550001），含 + 与国家代码，不含空格、横线或括号。发送号码须已分配到正确的消息配置文件；美国 A2P 长码流量在生产发送前须完成 10DLC 注册，否则可能被运营商拦截或过滤。投递 webhook 是异步的，发送响应仅表示请求被接受，不代表最终投递。代码中不要臆造参数、枚举、响应字段或 webhook 字段；未列出的字段应先查阅参考资料。常见错误码有 401、403、404、422、429。更多可选参数、响应结构与低频 webhook 字段暂未在资料中完整提供。