用途:该技能面向 Java 开发者,通过 Telnyx 官方 SDK 集成短信与多媒体消息能力,覆盖发送、接收、退订处理及投递状态 webhook,可用于通知、双因素认证(2FA)或消息类应用。
主要能力:支持发送 SMS、带字母数字发送方 ID 的短信、群发 MMS、长码/短码消息、号码池发送、定时消息以及 WhatsApp 消息;提供消息检索、取消定时消息、字母数字发送方 ID 的增查等操作;支持 Ed25519 签名的 webhook 校验,以及投递更新(message.sent、message.finalized)和入站消息(message.received)事件处理。
使用方式:通过 Maven 引入 com.telnyx.sdk:telnyx:6.82.0,或 Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.82.0")。初始化客户端:TelnyxClient client = TelnyxOkHttpClient.fromEnv();。发送示例:client.messages().send(params),参数包含 to、from、text 等。webhook 处理时使用 client.webhooks().unwrap(...) 校验签名。
限制与注意:电话号码须为 E.164 格式(含 + 和国家代码,无空格、短横线或括号);发送号码须已绑定正确的消息配置文件;美国 A2P 长码流量需完成 10DLC 注册,否则可能被运营商拦截或过滤;投递 webhook 为异步,发送响应仅代表请求被接受,不代表最终送达;需处理 401、403、404、422、429 等错误,429 建议指数退避重试。分页可用 .autoPager() 或 .hasNextPage()/.nextPage()。未在技能内联展示的参数、枚举、响应字段或 webhook 字段,应先查阅 references/api-details.md 或 webhook 负载参考,不得自行编造。具体收费、价格与平台支持范围暂未提供。