查看发送记录与状态
查询邮件和群发活动的处理结果，理解受理、通道提交、送达、退信、拒绝和失败状态。
发送记录展示邮件从请求受理到最终投递的处理过程。你可以按 Message ID、收件人、主题、状态和时间查询邮件，并在详情中查看关键事件、内容快照和安全化的失败原因。
受理、提交和送达是不同阶段
API 返回成功只表示请求已受理。邮件随后还需要完成内容处理、通道提交和收件方服务器投递，最终可能送达、退信、被拒绝或发送失败。
查询发送记录
在邮件控制台打开发送记录。默认查询近 7 天，每次查询的时间范围最多 7 天。
支持以下筛选条件：
| 条件 | 使用方式 |
|---|---|
| 收件人 | 输入完整邮箱地址进行精确查询。 |
| Message ID | 输入 API 或 SMTP 返回的完整消息标识。 |
| 主题 | 按邮件主题搜索。 |
| 状态 | 筛选等待、已提交、已送达、已退信、已拒绝或发送失败等状态。 |
| 邮件用途 | 筛选事务邮件或营销邮件。 |
| 时间范围 | 选择不超过 7 天的起止时间。 |
排查问题时，优先使用完整 Message ID。它是关联 API 响应、发送流水、通道结果和 Webhook 事件的主要标识。
查看邮件详情
详情页包含：
- Message ID；
- Request ID；
- 批次号；
- 模板 ID；
- 重试次数；
- 发件人和收件人；
- 邮件主题与用途；
- 关键事件时间线；
- 可用的纯文本和 HTML 内容快照；
- 客户可安全查看的失败原因。
内容预览会禁用外部图片和链接，因此不会产生新的打开或点击事件。附件区域仅显示已有流水中的元数据；当前发送 API 不提供附件内容上传和投递能力。
邮件状态
| 状态 | 含义 | 是否为最终结果 |
|---|---|---|
| 等待下发 | 邮件已进入发送队列，等待后续处理 | 否 |
| 处理中 | 邮件正在处理，或平台正在确认通道结果 | 否 |
| 已提交 / 已受理 | 发送通道已经接受邮件 | 否；不代表收件方已收到 |
| 已送达 | 收件方邮件服务器已接受邮件 | 是；不保证进入收件箱或已读 |
| 已退信 | 收到退信回执 | 是 |
| 已投诉 | 收件人将邮件标记为垃圾邮件 | 是 |
| 已拒绝 | 平台策略或发送通道明确拒绝邮件 | 是 |
| 发送失败 | 内容处理、配置或通道操作发生确定失败 | 是 |
| 未知 | 当前信息不足以形成明确结果 | 否；需要继续核对 |
Delivered 不等于进入收件箱
已送达表示收件方服务器接受了邮件。邮件仍可能进入垃圾邮件、促销分类或被收件方规则隐藏，也不表示收件人已经阅读。
事件时间线
时间线按照发生顺序展示已记录的关键节点，例如：
- 请求进入发送队列；
- 平台开始处理；
- 邮件提交发送通道；
- 通道接受邮件；
- 收到送达、退信、投诉、打开或点击事件；
- 邮件被拒绝或处理失败。
打开和点击只显示首次记录，不包含每一次操作。相关事件还依赖发送通道和追踪设置。
打开率不是精确阅读人数：Apple Mail 隐私保护可能预加载跟踪像素并抬高数据，而禁止远程图片的客户端可能漏记真实打开。
失败原因
客户详情使用固定的安全原因词表，不直接展示供应商原始响应、凭据或内部诊断。
| 原因 | 含义 | 建议处理 |
|---|---|---|
invalid_recipient | 收件地址格式无效 | 核对地址并停止重试无效地址。 |
suppressed | 收件人命中退订或抑制记录 | 检查抑制原因，不要绕过收件人意愿。 |
template_error | 模板状态、内容或变量不符合要求 | 检查审核版本、启用状态和必需变量。 |
rate_limited | 发送频率超过限制 | 降低并发或批量大小，稍后重试。 |
rejected | 平台规则或通道明确拒绝 | 检查发件身份、邮件用途、模板和抑制名单。 |
send_failed | 邮件未完成发送 | 保留 Message ID，联系平台排查配置或通道问题。 |
delivery_failed | 邮件未能送达收件方 | 检查地址、内容、域名信誉和收件方策略。 |
complained | 收件人投诉邮件 | 停止营销发送并检查订阅来源与退订机制。 |
marketing_wait_expired | 营销邮件等待条件已失效 | 联系平台核对活动与发送策略。 |
unknown | 暂无可公开的具体原因 | 提供 Message ID 和时间联系平台。 |
群发活动状态
群发活动状态描述活动调度流程，不等同于每封邮件的投递状态。
| 活动状态 | 含义 |
|---|---|
| 草稿 | 活动尚未提交审核。 |
| 待审核 | 活动等待平台审核。 |
| 已定时 | 活动已有发送计划，等待审核或计划时间。 |
| 发送中 | 活动正在派发，不能撤回。 |
| 派发完成 | 活动派发流程结束，不代表所有邮件已送达。 |
| 已取消 | 尚未执行的计划已经停止。 |
| 失败 | 活动处理失败，需要查看详情。 |
活动统计中的已派发数表示进入发送流程的邮件数量。已送达、打开、点击和退信来自后续逐封结果。
活动详情支持刷新统计、筛选收件人，并仅补发当前发送失败的收件人。补发受理后仍需查看新的邮件流水。
排查问题
联系平台支持时，请提供：
- Message ID；
- Request ID 或 Trace ID；
- 批次号；
- 发生时间和时区；
- 发件地址；
- 当前状态和失败原因；
- 批量任务使用的幂等键。
不要提供 API Secret、完整 CheckSum 材料、Webhook 签名密钥或其他真实凭据。
常见问题
API 返回成功，为什么发送记录显示失败？
API 成功只表示请求受理。模板、发件身份、抑制名单或发送通道仍可能在后续阶段拒绝邮件。
已送达但收件人没有看到邮件怎么办？
请检查垃圾邮件、促销分类、企业邮件网关和收件人规则。已送达不保证收件箱位置。
为什么没有打开或点击事件？
确认发送通道已启用相关追踪，并考虑收件客户端可能阻止远程图片或链接改写。
相关资源
最后更新于