ClawHub

CMI CPaaS - SMS Sender

Data & APIs

Send batch SMS messages to up to 100 domestic or international numbers via CloudSMS API with optional custom signature and content.

Install

openclaw skills install sms-sender

CloudSMS 群发短信

发送批量短信到多个手机号码，支持国内外号码。

功能说明

通过 CloudSMS 平台 API 发送群发短信，支持：

  • 单个或多个手机号码（最多100个）
  • 自定义短信内容
  • 可选的短信签名

使用前提

需要 CloudSMS 平台的 Channel ID 和 Auth Key。如果没有，请联系平台管理员获取。

凭证信息

使用时需要提供以下凭证：

  • Channel ID: CloudSMS 平台分配的租户标识（Account ID）
  • Auth Key: 对应的认证密钥

参数说明

  • mobile: 手机号码，多个号码用英文逗号分隔，需要包含国家码

    • 格式示例：+8613800138000 或 +8613800138000,+8613900139000
    • 单次最多支持 100 个号码

  • content: 短信内容

    • 最多 500 字（包含签名）
    • 不能包含敏感词

  • signature: 短信签名（选填）

    • 格式：公司名或品牌名（不需要加【】符号）
    • 签名必须提前在平台报备，否则会发送失败
    • 签名会自动添加到短信内容开头

使用示例

示例 1：发送单条短信

给 +8613800138000 发送短信：您的验证码是 123456，5分钟内有效

示例 2：群发短信

群发短信给 +8613800138000,+8613900139000，内容：会议将于明天上午10点在3楼会议室召开

示例 3：带签名的短信

用签名"某某科技"给 +8615622201234 发送：您的订单已发货，请注意查收

返回结果

成功时返回：

  • 发送状态：OK
  • 短信 UID（用于追踪）
  • 每个号码的发送详情

失败时返回：

  • 错误描述
  • 操作建议（如需要报备签名、充值等）

常见问题

  1. 认证失败：如果提示认证错误，请联系平台管理员确认 Channel ID 和 Auth Key
  2. 签名未报备：如果提示签名问题，请联系平台管理员报备签名
  3. 余额不足：请联系平台管理员充值

技术信息

使用方式

当用户请求发送短信时：

  1. 询问并获取 CloudSMS 的 Channel ID 和 Auth Key
  2. 从用户的自然语言中提取：
    • 手机号码（支持多个，逗号分隔）
    • 短信内容
    • 签名（如果提到）
  3. 调用脚本： 
    python3 scripts/send_bulk_sms.py "<channel_id>" "<auth_key>" "<mobile>" "<content>" ["<signature>"]
  4. 解析返回结果并以友好的方式告知用户

注意事项

  • 手机号必须包含国家码（如 +86）
  • 单次最多发送 100 个号码
  • 短信内容不能超过 500 字
  • 签名需要提前报备
  • 签名会自动添加【】符号并拼接在内容开头
More in Data & APIs