用途:面向美国 A2P 10DLC 合规场景,使用 Telnyx Java SDK(com.telnyx.sdk:telnyx:6.82.0)完成品牌注册、活动提交、号码/消息配置文件分配,并处理相关 Webhook。
主要能力:1) 创建品牌(client.messaging10dlc().brand().create(),POST /10dlc/brand),必填 country、displayName、email、entityType、vertical;2) 提交活动(campaignBuilder().submit(),POST /10dlc/campaignBuilder),必填 brandId、description、usecase;3) 将消息配置文件分配给活动(phoneNumberAssignmentByProfile().assign(),POST /10dlc/phoneNumberAssignmentByProfile);4) 创建电话号码与活动关联(phoneNumberCampaigns().create());5) 查询品牌、活动、按 usecase 资格、品牌反馈等;6) 使用 Ed25519 验签 Webhook。
使用方式:通过 Maven 或 Gradle 引入 SDK,用 TelnyxOkHttpClient.fromEnv() 初始化客户端。10DLC 流程是顺序的:先创建品牌,再提交活动,最后绑定消息配置文件。注册调用本身不足以发送消息,必须等分配步骤成功。请把返回的状态字段(如 identityStatus、campaignStatus、submissionStatus、assignmentStatus)纳入控制流,不要假定活动已可发送。生产代码应处理 401、403、404、422、429 等错误,429 建议指数退避重试。列表方法支持分页,可用 .autoPager() 自动迭代,或用 .hasNextPage()/.nextPage() 手动控制。Webhook 需用 telnyx-signature-ed25519 与 telnyx-timestamp 头验签,使用原始请求体。
限制与注意:资料未提供收费、价格与具体平台支持细节。不要臆造参数、枚举、响应字段或 Webhook 字段;本技能未内联的字段应先查阅 references/api-details.md 或 Webhook payload reference。附加操作(更新/删除品牌、外部审查、重发 2FA 邮件等)的完整可选参数与响应结构需另行查阅参考资料。