用途:通过 Telnyx WhatsApp Business API 的 JavaScript SDK 发送消息并管理 WhatsApp 资源。安装:npm install telnyx;初始化:import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] });。
主要能力:发送模板消息(client.messages.sendWhatsapp(),POST /messages/whatsapp,模板可随时发送);发送自由文本(仅限客户最后来信后 24 小时窗口内);列出 WABA(client.whatsapp.businessAccounts.list());列出/创建模板(client.whatsapp.templates.list()/create());列出某 WABA 的电话号码(client.whatsapp.phoneNumbers.list())。
用法要点:号码须为 E.164 格式(含 + 与国家代码);模板可用 name+language 或 Telnyx UUID(template_id)引用;列表接口分页用 for await。常见错误码:401 无效密钥、403 权限不足、404 资源不存在、422 校验失败、429 限流(指数退避);WhatsApp 专用 131047(24 小时窗口外)、131026(非 WhatsApp 用户)、132000(模板参数数量不符)、132015(模板被暂停)。
限制:发送号码须注册 WABA 并关联消息档案;模板须 APPROVED 状态;模板名须小写加下划线;模板类别影响计费(AUTHENTICATION 须含 OTP、UTILITY 事务类、MARKETING 营销类),Meta 可能重分类。Webhook 使用 Ed25519 签名,生产环境应验证。