SuperAPI AI 工具集

telnyx-messaging-profiles-java

编程与开发

查看项目

更新于 10-16 08:41

技能介绍

用途:通过 Telnyx Java SDK 管理消息配置文件(Messaging Profiles),配置号码池、粘性发送(sticky sender)、地理匹配(geomatch)等能力,并可为高并发消息配置短码(short codes)。

主要能力:列出、创建、检索、更新、删除消息配置文件;列出配置文件关联的电话号码与短码;列出、检索、更新短码(可将短码绑定或解绑到配置文件,设置标签)。创建配置文件时必填 name 与 whitelisted_destinations,可选字段包括 alpha_sender、daily_spend_limit、enabled、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 等。

使用方式:通过 Maven 依赖 com.telnyx.sdk:telnyx:6.36.0 或 Gradle implementation("com.telnyx.sdk:telnyx:6.36.0") 引入。初始化:TelnyxClient client = TelnyxOkHttpClient.fromEnv();。调用 client.messagingProfiles() 与 client.shortCodes() 下的 list、create、retrieve、update、delete 等方法。列表方法返回分页对象,可用 .autoPager() 自动迭代,或用 .hasNextPage() 与 .nextPage() 手动控制。

错误处理:API 调用可能返回网络错误、限流(429)、校验错误(422)或认证错误(401)。生产代码应捕获 TelnyxServiceException,读取 statusCode() 与 getMessage();422 检查必填字段与格式,429 采用指数退避重试。常见错误码:401 无效 API 密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流。

适用场景:需要以编程方式管理短信发送配置、号码池、短码绑定及 webhook 设置的 Java 应用。

限制:资料未提供具体收费、价格、配额或平台支持范围等信息;短码更新时 messaging_profile_id 为必填,解绑需设为 null 或空字符串。