teltel-send-sms-text-message

该 Skill 是基于 TelTel 云通信平台开发的 Node.js 短信发送工具，旨在为开发者和企业提供稳定可靠的 SMS 发送能力。通过调用 api.teltel.io 的 REST 接口，支持单条短信精准投递和批量短信高效群发，并可选配置回调地址接收投递状态报告。

核心用法简洁明了：用户需先在 TelTel 官网注册账户、充值并验证发送者身份，随后配置 TELTEL_API_KEY 环境变量即可使用。脚本支持通过命令行参数指定接收号码（国际格式）、消息内容和发送者标识，同时提供 --dry-run 模式用于测试，可在不产生实际费用的情况下预览请求内容。批量发送功能支持逗号、换行或分号分隔的号码列表，便于大规模通知场景。

显著优点体现在多个维度：代码层面极致轻量，零外部 npm 依赖，仅使用 Node.js 内置 fetch API，杜绝了供应链攻击风险；安全设计规范，无 eval、exec 等危险函数，API Key 通过环境变量传递，通信全程 HTTPS 加密；功能设计完善，具备必填参数校验、HTTP 状态码检查和异常捕获机制，配合 dry-run 功能有效避免误操作。

然而，该 Skill 也存在一定局限性：首先，它深度绑定 TelTel 平台，存在供应商锁定风险；其次，作为 T3 级社区来源项目，虽代码安全但缺乏大型企业背书；此外，脚本未内置手机号格式验证，依赖用户确保国际格式正确；最重要的是，短信服务为付费业务，需预先充值且发送即扣费。

该技能特别适合以下群体：需要将短信通知集成到 CI/CD 流程的 DevOps 工程师、构建自动化营销或告警系统的后端开发者、以及寻求批量通知解决方案的中小企业运营人员。对于追求代码安全性和依赖简洁性的技术团队尤为合适。

使用风险主要集中在财务和配置方面：短信发送将产生实际费用，若 API Key 泄露可能被恶意滥用导致资金损失；依赖外部网络连通性，若 TelTel 服务不可用则无法发送；号码格式错误可能导致发送失败或费用损失；建议在生产环境使用前充分测试，并妥善保管 API Key。

核心用法

该 Skill 提供 Node.js 脚本封装，通过调用 TelTel REST API (api.teltel.io/v2) 实现短信发送。包含两个入口脚本：

• send_sms.js：单条短信，支持 --to、--message、--from 参数及 --dry-run 预演模式
• send_sms_bulk.js：批量发送，接收逗号/分号/换行分隔的多号码列表

配置通过环境变量完成，必需项为 TELTEL_API_KEY，可选配置包括默认发件人 TELTEL_SMS_FROM 及自定义 API 地址 TELTEL_BASE_URL。

显著优点

1. 零依赖设计：仅使用 Node.js 内置 fetch API，无第三方包引入，依赖攻击面极小
2. dry-run 安全机制：可在不实际发送的情况下验证请求参数与 API 连通性
3. 批量发送支持：单次调用可处理多号码，适合营销通知、验证码批量下发等场景
4. HTTPS 全链路加密：API 通信强制 TLS 1.2+，符合金融级传输安全要求
5. 凭证管理规范：API Key 通过环境变量注入，无硬编码风险

潜在缺点与局限性

1. 前置成本门槛：需注册 TelTel 账户并预充值，测试发件人需人工审核验证
2. 地域覆盖依赖：实际可达号码范围受 TelTel 运营商合作网络限制，国际短信需确认支持
3. Node 版本要求：内置 fetch 需 Node.js ≥18，低版本环境需 polyfill
4. 无重试与退队机制：脚本层未实现指数退避或失败重试，网络波动时需手动处理
5. 回调依赖外部配置：如需接收送达报告，需自行部署 HTTPS 回调服务

适合人群

• 需集成短信能力的 SaaS 开发者、DevOps 工程师
• 已有 TelTel 账户或计划采用其计费体系的团队
• 偏好无依赖、可审计代码的安全敏感型用户

常规风险

1. API Key 泄露风险：环境变量若配置于共享 CI/CD 日志或 shell 历史，可能导致密钥外泄；建议配合密钥管理服务（如 AWS Secrets Manager、Vault）使用
2. 费用失控风险：批量发送无内置速率限制，误操作或脚本循环可能导致账户余额快速耗尽；建议启用 TelTel 控制台的消费告警
3. 发件人冒用风险：若默认 TELTEL_SMS_FROM 被篡改，可能导致短信来源标识异常；建议通过代码审查固化发件人白名单
4. 合规风险：群发营销短信需遵守目标国法规（如中国工信部模板报备、美国 TCPA opt-in 要求），Skill 本身不提供合规校验层