订单、付款和账户通知

01简要说明

发送事务型通知时，请从后端针对每个事件调用一次 POST /v1/messages，使用 shipping 等 campaign 标签以及订单号等您自己的 reference 标记该事件，并将短信标记为事务型，使其不会因静默时段而暂缓发送。送达事件会通过 webhook 返回，并带有同一 reference，因此您的订单系统可以记录客户已收到通知。

流量类型: 事务型
API 调用: 每个事件调用一次 POST /v1/messages，夜间批处理则使用 /batch
追踪: reference 会在响应和 webhook 中原样返回
分组: 每种通知类型使用一个 campaign 标签
长度: 一到两个分段；如有链接，使用自有域名
历史记录: 每条短信的报告保留 90 天

02使用流程

从零开始，只需 4 步即可送达。

01接入事件

在您的系统将订单标记为已发货或将付款标记为已收款的位置添加 API 调用。将订单号用作 reference，并纳入幂等键。
02一次写好短信文本

品牌、事实、下一步。例如：“ACME：订单 4821 已发货。追踪：acme.com/t/8fK2”。这段中文使用 Unicode，应控制在一个分段内。
03记录结果

针对订单存储 delivered 或 failed 状态。如果通知因号码未知而失败，这就是一个应当显露出来的客户数据问题。
04按类型查看

群发任务标签会在报告中将配送、收据和警报分类汇总，因此某一类型的数据下降会清晰可见。

03关键事项

事务型短信应包含什么

如果客户因自己执行的某项操作而预期收到通知，该通知就是事务型通知。它陈述一个事实，最多再指出可到何处查看详情。一旦通知中包含优惠，就属于营销内容，需要获得同意并遵守静默时段；如果仍将其标记为事务型，还会危及线路。请将这两类流量分开：使用不同的模板和不同的群发任务标签。

请使用自有域名上的链接。公共短链接是短信中最容易被过滤的模式，还会隐藏客户正在寻找的品牌。

04实际操作

在您这一侧确保可靠性

发送时使用根据事件生成的 Idempotency-Key，例如 order-4821-shipped。如果您的任务崩溃后重新运行，API 会返回原始响应，客户只会收到一条短信，而不是两条。收到 429 和 5xx 响应时采用退避策略重试；其他 4xx 响应绝不要重试，而应修正问题。

对于付款提醒等夜间批处理，批量端点可接收每次 API 请求最多 1,000 条消息，并列出每个被拒绝行及其原因，因此一个错误号码不会导致整次处理失败。

05费用

5,000 条消息，按目的地计价。

每条消息一个分段，按今日公开费率计算。无论发送一条还是一百万条，单价相同；无套餐、无设置费、无月费。

费率表最后更新于 2026年9月22日

目的地	每条短信费率	5,000 条消息
美国	$0.0084	$42.00
英国	$0.0130	$65.00
德国	$0.0238	$119.00
法国	$0.0205	$102.50
巴西	$0.0042	$21.00
印度	$0.0256	$128.00

其他目的地：费用计算器

06有效的消息示例

查看它在手机上的显示效果，以及请求中的写法。

一个事实、一个日期和一个自有域名链接，全部放在一个分段内。

ACME事务型消息

ACME：订单 4821 已发货，将于周四送达。追踪：acme.com/t/8fK2

42 个字符1 个分段，Unicode（UCS-2）

cURLPOST /v1/messages

curl https://api.smsmeteor.com/v1/messages \
  -H "Authorization: Bearer $SMSMETEOR_KEY" \
  -H "Idempotency-Key: order-4821-shipped" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+447700900123",
    "from": "ACME",
    "text": "ACME：订单 4821 已发货，将于周四送达。追踪：acme.com/t/8fK2",
    "window": { "quiet_hours": "bypass" },
    "campaign": "shipping",
    "reference": "order-4821"
  }'

07常见问题

我们常见的三个错误，以及避免方法。

在收据中加入优惠
这会使短信变成营销内容。请将促销放在单独的群发任务中，并取得同意、遵守静默时段。
公共短链接
它比任何其他模式都更容易被过滤。自有域名上的短路径占用的字符数相同。
短信中没有 reference
缺少 reference，就无法将送达事件与触发该事件的订单对应起来。

08深入了解

指南、参考资料和相关使用场景。

所有使用场景

09常见问题解答