核心用法
ClickSend skill 是 Maton 平台提供的托管式通信网关，通过单一 Maton API Key 即可代理访问 ClickSend 原生 REST API v3。用户无需直接处理 ClickSend 凭证，由 Maton 自动注入认证信息，大幅降低集成复杂度。
主要功能矩阵：
- 消息发送：SMS（单条/批量/定时）、MMS（富媒体）、TTS 语音电话（多语言、男女声、按键交互）
- 模板管理：创建变量模板（如
{name}），支持动态填充发送 - 联系人运营：列表创建、联系人 CRUD、跨列表复制/转移、自动去重
- 投递追踪：历史记录查询、入站消息监听、送达回执（receipts）、实时余额查询
典型工作流：
1. 在 ctrl.maton.ai 创建 ClickSend 连接并完成 OAuth 授权
2. 调用 gateway.maton.ai/clicksend/v3/sms/send 发送消息
3. 通过 /sms/receipts 轮询或 webhook 获取送达状态
4. 利用 /lists/{id}/contacts 管理订阅用户，结合模板实现个性化营销
显著优点
| 维度 | 优势描述 |
|------|----------|
| **认证托管** | Maton 集中保管 ClickSend 凭证，避免客户端密钥泄露，支持多连接切换（`Maton-Connection` 头） |
| **协议兼容** | 原生透传 ClickSend API，保留完整功能（如语音的机器检测 `machine_detection`、按键输入 `require_input`） |
| **批量能力** | 单请求支持多消息批量提交，内置分页（`page`/`limit`）处理大规模联系人 |
| **成本透明** | 提供 `/price` 端点预计算费用，余额实时查询，避免超支 |
| **定时与撤销** | 支持 Unix 时间戳定时发送，且可取消未发送的预定消息 |
潜在缺点与局限性
- 网络依赖：所有调用必须经由 Maton 网关，若 Maton 服务中断则完全不可用；无法直连 ClickSend 作为 fallback
- 功能延迟：ClickSend 原生 API 更新（如新 endpoint）需等待 Maton 网关同步，可能存在功能滞后
- 地理合规：用户需自行确保发送内容符合目标国电信法规（如美国 TCPA、欧盟 GDPR），Maton 仅提供管道
- 语音权限：TTS 语音功能需 ClickSend 账户额外开通，非默认启用
- 模板变量限制：模板系统仅支持简单字符串替换，无逻辑控制（if/else）或循环
适合人群
- SaaS 开发者：需快速集成短信通知、双因素认证（2FA）的用户验证流程
- 营销运营团队：通过列表管理进行批量活动推送，依赖送达报告优化打开率
- 客服系统：结合入站 SMS 与语音电话构建双向通信能力
- 无 ClickSend 账户管理者：已通过 Maton 平台统一管理多服务凭证的团队
常规风险
| 风险类别 | 具体说明 | 缓释建议 |
|----------|----------|----------|
| **密钥泄露** | `MATON_API_KEY` 若暴露在日志或前端代码中，攻击者可滥用整个 Maton 账户 | 严格限制环境变量作用域，禁止前端直调 |
| **号码误发** | E.164 格式错误可能导致消息路由至错误国家或失败 | 集成前用正则校验 `^\+\d{10,15}$`，并调用 `/price` 预检 || **频率限制** | 触达 ClickSend 或 Maton 的 rate limit（429）会导致发送中断 | 实现指数退避重试，监控 `response_code` |
| **合规罚款** | 未经同意的商业短信（SPAM）可能面临运营商罚款或账户封禁 | 维护 opt-out 列表，遵守当地通信法 |
| **成本失控** | MMS 与跨国语音费用显著高于 SMS，批量发送前未预估费用 | 发送前调用价格接口，设置账户余额告警 |