批量与定时消息

批量接口

POST /api/v1/messages/batch

{
  "channel_id": 1,
  "receivers": [
    "+8613800000001",
    "+8613800000002"
  ],
  "template_params": {
    "code": "123456",
    "minutes": "5"
  },
  "signature_name": "木雷演示"
}

同一批次的接收者共享通道、模板参数、签名别名和定时时间。响应返回 batch_id、总数以及落库成功/失败计数。

定时发送

单条和批量请求都可增加 RFC 3339 字段：

{
  "scheduled_at": "2026-07-24T09:30:00+08:00"
}

未来任务会写入调度集合，调度器到期后推入 Redis Stream。服务器时间、应用时区和调用方展示时区应一致。

使用建议

• 批量前去重并限制单批规模，避免占满队列。
• 对响应中的落库失败数单独处理，不要盲目重放整批。
• 定时任务取消接口目前未开放；业务侧提交前应确认时间。
• 用批量任务和发送记录追踪结果。