01状态
六个状态，毫无歧义。
消息状态只会向前推进，因此报告不会在之后自相矛盾。最终状态不会再改变。
- 排队中已接受并计价，正在等待线路名额。
- 已发送已交给运营商，并在此时计费。
- 已送达手机已确认接收。
- 失败运营商无法送达，并附运营商代码。
- 已过期未能在 48 小时 内送达。
- 已拒绝发送前被拒绝，绝不计费。
02失败原因
运营商代码，以及对应的处理方法。
各运营商的原始代码不同；我们将其映射为一组简短原因，让报告直接告诉您该清理列表、更换发件人，还是等待。
| 原因 | 发生了什么 | 常见占比 | 处理方法 |
|---|---|---|---|
| 号码不存在 | 该号码未分配给任何用户。 | 1% 至 3% | 移除该号码，它永远无法送达。 |
| 用户不在服务区 | 有效期内手机关机或不在网络覆盖范围。 | 1% 至 2% | 在后续群发任务中重试，下一次通常可以送达。 |
| 手机或存储空间已满 | 手机拒绝接收消息。 | < 0.5% | 稍后重试。 |
| 被运营商过滤器拦截 | 内容或发件人被运营商标记。 | 不固定 | 检查该国家/地区的发件人规则；在严格线路上避免使用短链接。 |
| 不允许该发件人 | 需要数字发件人或注册的线路收到了字母数字发件人。 | 0% | 发送前即会拦截：平台会自动替换发件人。 |
| 不支持的目的地 | 没有前往该号段的线路。 | 0% | 导入时拒绝，不计费。 |
03报告可以为您做什么
筛选、导出、推送。
-
筛选任意条件
状态、目的地、发件人、群发任务、日期范围和运营商原因。可保存每天查看的筛选视图。
-
一键导出
按群发任务或跨筛选结果导出 CSV 或 JSON，包含消息 id、号码、状态、原因、时间戳和价格。
-
改用推送
每次状态变化都能在发生时推送到您的端点。数据相同，无需轮询。
-
群发任务漏斗
以数量和占比显示已发送、已送达、失败和待处理，下面附失败原因明细。
-
列表清理
一键从源列表中移除不存在的号码，让下一次群发任务使用更干净的列表。
-
90 天 的历史记录
逐条消息记录可在 90 天 内搜索；群发任务摘要永久保留。
04常见问题解答
送达报告常见问题。
各状态分别表示什么？
Queued：已接受并计价。Sent：已交给运营商并计费。Delivered：手机已确认接收。Failed：运营商无法送达，并附运营商代码。Expired：未能在 48 小时 内送达。Rejected：发送前被拒绝，不计费。
状态多久更新一次？
Sent 会立即更新。Delivered 通常在数秒内到达；有些运营商会批量上报，可能需要几分钟。收到运营商代码后，Failed 会立即附上该代码。每次状态变化发生时，Webhook 都会立即推送。
什么是运营商代码？
这是运营商给出的失败原因，例如用户不在服务区、号码不存在、手机存储空间已满或被过滤器拦截。我们保留原始代码并添加简明中文标签，方便您采取措施，例如从列表中移除不存在的号码。
历史记录会保留多久？
逐条消息记录保留 90 天，可搜索和导出。群发任务摘要永久保留。如需保存更久，请导出所需数据。
可以导出报告吗？
可以。可按群发任务导出 CSV 或 JSON，也可按状态、目的地、发件人和日期范围筛选全部数据后导出。导出内容包含消息 id、号码、状态、运营商代码、时间戳和价格。
报告需要付费吗？
不需要。所有账户都包含报告、导出和 Webhook。您只需为消息付费。
可以一起查看 API 流量和控制面板群发任务的报告吗？
可以。一个账户对应一套报告。API 消息可以携带 campaign 标签，从而像控制面板中的群发任务一样分组。
为什么 delivered 数量低于 sent？
因为有些手机关机、有些号码已失效，还有些消息会被运营商过滤。失败原因明细会显示主要原因。不存在号码的比例上升，通常意味着列表需要清理，而不是线路有问题。