SuperAPI AI 工具集

telnyx-messaging-profiles-java

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:通过 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 细节暂未提供。