用途:该技能面向 Java 开发者,提供 Telnyx 消息托管相关 API 的 Java SDK 调用方式,覆盖托管号码开通、RCS 富消息与免付费号码验证三大块,适合号码迁移或启用富媒体消息的场景。
安装:Maven 使用 <dependency><groupId>com.telnyx.sdk</groupId><artifactId>telnyx</artifactId><version>6.89.0</version></dependency>;Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.89.0")。
初始化:TelnyxClient client = TelnyxOkHttpClient.fromEnv(); 后续示例均假设已初始化。所有号码须为 E.164 格式(如 +13125550001),含 + 与国家码,不含空格、短横线或括号。
主要能力:发送 RCS 消息(POST /messages/rcs,必填 agent_id、to、messaging_profile_id、agent_message,可选 mms_fallback、sms_fallback、type、webhook_url);生成 RCS 深链(GET /messages/rcs/deeplinks/{agent_id});RCS 代理的列出、获取、修改(GET/PATCH /messaging/rcs/agents);批量与单个 RCS 能力查询;添加 RCS 测试号码。托管号码侧支持订单的列出、创建、获取、删除,资格检查,文件上传,验证码创建与校验,以及删除托管号码。免付费侧支持列出与提交验证请求(POST /messaging_tollfree/verification/requests,含 businessName、useCase、optInWorkflow 等必填字段)。列表接口返回分页,可用 .autoPager() 自动遍历,或用 hasNextPage()/nextPage() 手动控制。
限制:资料未提供价格、配额、区域可用性与具体业务效果。生产代码须处理错误:401、403、404、422、429,遇 429 建议指数退避重试。部分接口返回字段与状态枚举以资料所列为准。