sinomsgsinomsgMessage Delivery
免费开始

开发者文档

几分钟即可发出第一条消息。先在沙箱里零成本体验完整流程，确认无误再上生产。

快速开始

  1. 1

    第 1 步 · 获取凭证

    注册账号后，在控制台创建接入凭证。建议先用沙箱测试凭证进行联调。

  2. 2

    第 2 步 · 准备模板

    选用开箱即用的系统模板，或创建自定义模板（自定义模板经审核后即可使用）。

  3. 3

    第 3 步 · 发送第一条消息

    调用统一发送接口，传入消息类型、模板与收件人。接口采用列表形式，单条即长度为 1 的列表。

  4. 4

    第 4 步 · 获取结果

    通过结果回调实时获知送达状态，或用消息标识主动查询。

  5. 5

    第 5 步 · 先在沙箱验证

    用沙箱凭证配合“魔法号码”模拟送达、失败、超时等场景，全程零费用。

curl -X POST https://<api-endpoint>/v1/messages \
  -H "Authorization: <signature>" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "bizId": "your-unique-id-001",
      "channel_type": "sms",
      "message_type": "verification",
      "template_code": "TMPL_XXX",
      "signature_code": "SIG_XXX",
      "recipient": "+8613800138000",
      "variables": { "code": "123456" }
    }]
  }'

面向 AI Agent 的接入

如果你在构建 AI 应用，可以让 Agent 直接以工具形式调用平台能力，无需自行封装接口。会话初始化时通过请求头完成身份绑定。

  • send_message：发送消息（支持单条与批量）
  • query_message_status：查询消息状态
  • list_templates：查询可用模板
  • get_balance：查询余额与用量

关于 send_message 的 wait_for_final 参数：它是“尽力而为的短轮询便利”，超时返回“已受理”属于正常结果，不构成同步送达保证。