核心用法
Telnyx CLI 是 Telnyx 官方提供的命令行工具，用于直接调用 Telnyx 云通信 API。主要功能包括：
消息服务：发送 SMS/MMS/WhatsApp，查询消息状态和发送记录
号码管理：搜索、购买、释放电话号码，查询当前持有的号码列表
通话记录：查看通话详情和通话列表
Webhook 调试：查看 webhook 配置、监控失败事件、重试失败投递
账户管理：查询账户信息和余额
CLI 支持多种输出格式（table/json/csv），便于脚本集成和数据导出。
显著优点
- 官方维护：由 Telnyx 团队直接开发和维护，API 同步更新及时
- 功能完整：覆盖 Telnyx 核心 API 能力，无需额外 SDK
- 格式灵活：内置 table/json/csv 输出，适合自动化脚本
- Webhook 调试：专门的 debugger 命令，便于排查集成问题
- 配置持久化：API Key 保存至本地配置文件，避免重复输入
潜在缺点与局限性
- 速率限制：100 req/s，批量操作需手动添加延迟
- Node.js 依赖：需安装 Node.js 环境，对纯系统管理员不够友好
- 功能边界：仅支持 Telnyx 自有服务，无法管理其他运营商资源
- 无交互式引导：命令参数需查阅文档，新手学习成本较高
适合人群
- 需要批量管理 Telnyx 号码的运维工程师
- 集成 Telnyx 通信能力到 CI/CD 或自动化脚本的开发者
- 需要监控 webhook 健康状态的平台工程师
- 希望通过命令行快速测试 API 的技术人员
常规风险
- API Key 泄露：配置文件中明文存储 API Key，需确保
~/.config/telnyx/目录权限正确 - 误操作号码：
number release会立即释放号码，无二次确认机制 - 余额消耗：批量短信发送可能导致账户余额快速下降，建议操作前检查余额
- Webhook 重试风险：
debugger retry可能触发重复业务逻辑，需确保端点幂等性