用途：基于 Telnyx JavaScript SDK 在 Node.js 中发送和接收短信/彩信、处理退订与投递回调，适合通知、双因素认证（2FA）或消息类应用集成。
安装与初始化：使用 npm install telnyx@6.74.2 安装；通过 import Telnyx from 'telnyx' 引入，并用 new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 初始化客户端。
主要能力：client.messages.send() 发送 SMS；sendWithAlphanumericSender() 使用字母数字发送方 ID；sendGroupMms() 群发 MMS；sendLongCode()、sendNumberPool()、sendShortCode() 分别走长码、号码池、短码发送路径；schedule() 定时发送；sendWhatsapp() 发送 WhatsApp。此外还提供消息查询与取消、字母数字发送方 ID 的增删查、托管号码、退订列表、消息配置文件指标等操作。列表方法返回自动分页迭代器，可用 for await 遍历。
Webhook：Telnyx 使用 Ed25519 签名，请求带 telnyx-signature-ed25519 和 telnyx-timestamp 头。生产中应验证签名，例如在 Express 中用 express.raw 保留原始 body，再调用 client.webhooks.unwrap(req.body.toString(), { headers: req.headers })。投递更新事件类型为 message.sent、message.finalized，入站消息为 message.received。
错误处理：调用可能因网络、限流（429）、校验（422）、鉴权（401）失败。示例中对 APIConnectionError、RateLimitError（可读取 retry-after 退避重试）、APIError 分类处理；常见码还包括 403 权限不足、404 资源不存在。
限制与注意：电话号码须为 E.164 格式（含 + 和国家代码，无空格、破折号、括号）。发送前号码须已绑定正确的消息配置文件；美国 A2P 长码发送在生产前需完成 10DLC 注册，否则可能被运营商拦截或过滤。Webhook 是异步的，发送响应的成功仅代表请求被接受，并非最终投递成功。参考说明要求不要臆造参数、枚举、响应或 webhook 字段；未内联的字段需先查阅相关参考文档。部分操作的可选参数与响应结构、低频 webhook 字段在新资料中未完整给出，需参见其参考文件。