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：发送单条短信#

text

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

示例 2：群发短信#

text

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

示例 3：带签名的短信#

text

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

返回结果#

成功时返回：

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

失败时返回：

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

常见问题#

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

技术信息#

• API 地址： https://cpaas-sms.cmidict.com:1820/uips
• 实现语言：Python 3
• 依赖：requests

---

使用方式#

当用户请求发送短信时：

1. 询问并获取 CloudSMS 的 Channel ID 和 Auth Key

2. 从用户的自然语言中提取：

   • 手机号码（支持多个，逗号分隔）
   • 短信内容
   • 签名（如果提到）

3. 调用脚本： bash

   python3 scripts/send_bulk_sms.py "<channel_id>" "<auth_key>" "<mobile>" "<content>" ["<signature>"]
   
   

4. 解析返回结果并以友好的方式告知用户

注意事项#

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