用途：通过 curl 调用 Telnyx Messaging API，完成短信/彩信发送、接收、退订处理与投递状态 webhook 集成，可用于通知、2FA 验证码或消息类应用。
主要能力：发送 SMS（POST /messages）；使用字母数字发送方 ID 发送（POST /messages/alphanumeric_sender_id）；群发 MMS（POST /messages/group_mms）；长码、短码、号码池发送（/messages/long_code、/messages/short_code、/messages/number_pool）；定时发送（POST /messages/schedule）；发送 WhatsApp 消息（POST /messages/whatsapp）。还支持查询消息、取消定时消息、管理字母数字发送方 ID、托管号码、退订列表、消息配置指标与自动回复设置等操作。
使用方式：curl 已预装于 macOS、Linux 和 Windows 10+。先设置环境变量：export TELNYX_API_KEY="YOUR_API_KEY_HERE"。请求示例：curl -X POST -H "Authorization: Bearer $TELNYX_API_KEY" -H "Content-Type: application/json" -d '{"to":"+13125550001","from":"+18005550101","text":"Hello from Telnyx!"}' "https://api.telnyx.com/v2/messages"。号码须为 E.164 格式（含 + 与国家代码，无空格、连字符或括号）。列表接口分页，使用 page[number] 与 page[size]，并检查 meta.total_pages。
Webhook：Telnyx 使用 Ed25519 签名，请求头包含 telnyx-signature-ed25519 与 telnyx-timestamp，生产环境须验证签名，时间戳超过 5 分钟应拒绝以防重放；端点须在 2 秒内返回 2xx，否则最多重试 3 次，可在门户配置故障转移 URL。投递更新事件为 message.sent、message.finalized，入站消息事件为 message.received。
限制与注意：发送号码须已分配到正确的消息配置；美国 A2P 长码流量须先完成 10DLC 注册，否则可能被运营商拦截或严格过滤；投递 webhook 为异步，发送响应仅代表请求被接受，不代表运营商最终投递。常见错误码：401 密钥无效、403 权限不足、404 资源不存在、422 校验错误、429 限流（指数退避重试）。不要臆造参数、枚举、响应字段或 webhook 字段；未内联的字段需查阅 references/api-details.md 与 webhook 负载参考。具体收费与价格资料暂未提供。