用途:通过 Telnyx Java SDK 管理消息配置文件(messaging profiles),支持号码池、粘性发送(sticky sender)与 geomatch 等能力,并可配置短码(short codes)用于高流量短信发送。
主要能力:
- 消息配置文件:列出、创建、检索、更新、删除(GET/POST /messaging_profiles,GET/PATCH/DELETE /messaging_profiles/{id})。创建时必填 name 与 whitelisted_destinations,可选字段包括 alpha_sender、daily_spend_limit、enabled、health_webhook_url、mms_fall_back_to_sms、mms_transcoding、mobile_only、number_pool_settings、smart_encoding、url_shortener_settings、webhook_api_version、webhook_url、webhook_failover_url 等。
- 关联资源:列出配置文件名下号码(GET /messaging_profiles/{id}/phone_numbers)与短码(GET /messaging_profiles/{id}/short_codes)。
- 短码:列出、检索、更新(GET /short_codes、GET /short_codes/{id}、PATCH /short_codes/{id})。更新时 messaging_profile_id 为必填;将其设为 null 或空字符串可解绑,tags 为字符串数组。
使用方式:依赖为 com.telnyx.sdk:telnyx:6.89.0(Maven/Gradle)。初始化:TelnyxClient client = TelnyxOkHttpClient.fromEnv();。列表方法返回分页对象,可用 .autoPager() 自动迭代,或用 .hasNextPage()/.nextPage() 手动控制。
限制与注意:API 调用可能失败,需处理 401(无效 API 密钥)、403(权限不足)、404(资源不存在)、422(校验错误)、429(限流,建议指数退避重试);生产代码应捕获 TelnyxServiceException。以上字段与行为均来自所给资料;价格、配额、具体 region 支持的 geomatch 细节暂未提供。