托管式通信 API，一键触达全球

基于 Maton 代理网关的 ClickSend 通信 API 封装，支持 SMS/MMS/语音消息发送、联系人管理和消息追踪，需 MATON_API_KEY 认证

基本信息

• 技能名称?ClickSend
• 中文名称?托管式通信 API，一键触达全球
• 作者?byungkyu
• 分类?专业技能
• 版本?1.0.3
• 标签?sms, mms, voice, messaging, telecom, api-gateway, notification, otp, marketing-automation

使用方法

使用说明
核心功能概述
该 Skill 为 ClickSend 通信平台提供托管式 API 代理服务，通过 Maton 网关统一封装身份认证，开发者无需直接处理 ClickSend 的原始凭证。核心能力覆盖三大通信场景：
消息通信 ：支持 SMS（文本短信）、MMS（多媒体消息）和 Voice（语音通话）的发送、价格查询、历史记录追踪及送达回执获取。支持定时发送、模板变量替换（如 {name} ）以及批量消息管理。
联系人管理 ：提供完整的 CRUD 操作，包括联系人列表的创建/更新/删除、联系人信息的维护，以及跨列表的复制/转移功能。支持自定义字段（custom_1 至 custom_4）和完整的地址信息存储。
账户运营 ：涵盖账户余额查询、已验证发件邮箱管理、国家代码列表等辅助功能。
显著优势

1. 凭证托管安全 ：通过 Maton 集中管理 ClickSend 连接，避免在代码中硬编码第三方 API 密钥，降低泄露风险
2. 统一认证层 ：仅需 MATON_API_KEY 即可访问所有 ClickSend 功能，简化多环境配置
3. 完整功能映射 ：覆盖 ClickSend REST API v3 的绝大部分端点，包括高级功能如语音合成语言选择、答录机检测
4. 多连接支持 ：通过 Maton-Connection 头可切换多个 ClickSend 账户，适合代运营或隔离场景
5. 开发体验 ：提供 Python/JavaScript 代码示例，响应格式统一（http_code/response_code/response_msg/data）
   局限性及风险
   平台依赖性 ：
   核心功能完全依赖 Maton 代理服务的可用性，若 api.maton.ai 出现故障则服务中断
   需要额外的网络跳转到 Maton 网关，可能增加延迟（文档未披露 SLA）
   认证风险 ：
   MATON_API_KEY 成为单一故障点，泄露将暴露该 Key 关联的所有 ClickSend 连接
   文档未说明 Key 的权限粒度（如只读/读写分离）或轮换机制
   业务限制 ：
   语音功能需账户级权限开通，非默认可用
   短信超 160 字符自动分割可能产生额外费用，但文档未明确计费细节
   国际短信价格因目的地差异较大，需实时查询价格接口
   合规考量 ：
   涉及电信业务，需遵守目标国家的反垃圾短信法规（如美国 TCPA、欧盟 GDPR）
   联系人数据跨境传输至 Maton/ClickSend，需评估数据 residency 要求
   适用人群
   需集成短信/语音通知的 SaaS 应用开发者（验证码、订单提醒、营销推送）
   拥有多品牌/多租户架构，需隔离不同 ClickSend 账户的技术团队
   偏好托管凭证管理而非自建 ClickSend 集成的中小型企业
   安全建议
6. 将 MATON_API_KEY 配置为环境变量或密钥管理服务（如 AWS Secrets Manager），禁止硬编码
7. 为生产环境申请独立的 Maton 账户，避免与开发/测试环境混用
8. 启用 ClickSend 账户的双因素认证，并定期审查连接活动日志
9. 实施发送频率限制和异常监控，防范密钥泄露后的恶意滥用
10. 敏感行业（金融、医疗）需确认 Maton 和 ClickSend 的 SOC 2/ISO 27001 合规状态