用途:该技能基于 Telnyx WhatsApp Business API 的 Java SDK,帮助开发者在 Java 项目中发送 WhatsApp 消息,并管理 WhatsApp Business Account(WABA)、消息模板和电话号码。
安装:Maven 添加依赖 com.telnyx.sdk:telnyx:6.36.0;Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.36.0")。初始化客户端:TelnyxClient client = TelnyxOkHttpClient.fromEnv();
主要能力:发送模板消息(可随时发送)与 24 小时窗口内的自由文本消息;列出 WABA、模板和电话号码;创建消息模板;通过 Ed25519 验证 Webhook 并处理投递状态与模板状态变更事件。发送接口为 client.messages().sendWhatsapp(),对应 POST /messages/whatsapp,参数含 from、to、type=WHATSAPP、whatsappMessage。模板可用 name+language 或 Telnyx template_id 引用。
使用方式:电话号码须为 E.164 格式(含 + 与国家代码)。模板需 APPROVED 状态,名称仅小写加下划线。发送时参数数量须与模板定义一致。模板分 AUTHENTICATION、UTILITY、MARKETING,计费与用途不同,Meta 可能重新分类。列表接口分页可用 response.autoPager()。
限制:发送号码须注册在 WABA 并关联消息配置文件;非模板消息受 24 小时窗口限制。常见错误码如 401、403、404、422、429 及 WhatsApp 专用错误 40008、131047、131026、132000、132015 需处理。未提供的参数、枚举、响应或 Webhook 字段不得自行编造,应查阅参考文档。
适用场景:订单通知、验证码、客服会话等 WhatsApp 消息集成。其他细节暂未提供。