如何查看 Errors 选项卡
当部分收件人没有收到您的消息时,Errors 选项卡会显示原因。它列出该消息发送失败的记录,您可以 查找每个错误的含义 并加以修复,或 导出发送失败的记录。
要打开该选项卡,请进入该消息的消息统计页面,然后点击 Overview 和 Timeline 旁边的 Errors。
Errors 选项卡显示的内容
Anchor link to该选项卡显示一个渠道的发送失败记录。如果消息通过多个渠道发出,该选项卡会显示您在其上方选择的渠道。
发送失败的记录按平台分组,例如 iOS、Android 或 Email。点击平台即可折叠或展开其错误。每个分组包含以下部分:
- 平台行: 在此平台上发送了多少条消息、失败了多少条,以及它们占该渠道符合条件受众的比例。
- 错误行: 每个错误一行,显示其名称和代码,例如 Invalid To Phone Number (1001),下方附有简短说明。每一行都有自己的数量及其占同一受众的比例。

Errors 选项卡上的红色徽标表示所选渠道中发送失败的数量,包括 处理错误。没有发送失败时不显示徽标。
选项卡为空的情况
Anchor link to在以下两种情况下,该选项卡会显示 此消息没有送达错误:
- 没有任何发送失败。 没有可列出的错误。
- 消息在发送前就已失败(状态为 Failed)。没有任何内容被发送,因此没有可列出的内容。这并不意味着消息已送达。失败原因会显示在 Overview 选项卡上。请参阅 消息发送失败的原因。
选项卡不显示的内容
Anchor link to该选项卡只列出在 Pushwoosh 将消息交给投递平台之前或交接过程中失败的发送。它不会列出:
- 受众排除。 被有意排除的订阅者,例如因频率上限 (frequency capping)、全局对照组或之前的退订而被排除。Overview 选项卡会在 已排除 行中显示他们。
- 投递平台接收消息后的拒绝。 例如,运营商稍后未能投递的短信。此类发送在 Overview 选项卡上计为 网关已接收,在投递得到确认之前,还计为 送达未确认。
- Pushwoosh 会重试的临时故障。 它们不会被记录为错误。
查找错误
Anchor link to要了解某个错误的含义以及如何修复:
- 读取错误行中的名称和代码。不同的错误可能使用相同的代码,例如 Silent Hours (1041) 和 WhatsApp 错误 Template Is Paused (1041),因此也要查找名称。
- 在 所有平台上的错误 中查找它们。
- 如果那里没有,请打开 发送错误 下该行所属平台的页面。
- 如果该行显示的是类别名称而不是代码,例如 未分类错误,请在 错误类别 中查找。
Pushwoosh 会将每个错误归入以下类别之一。只有没有代码的错误,选项卡才会显示类别名称。
所有平台上的错误
Anchor link to这些错误可能出现在任何平台上,从推送到短信和即时通讯应用。Pushwoosh 会在将消息交给投递平台之前或交接过程中报告它们。
| 错误 | 含义 | 怎么办 |
|---|---|---|
| Push Token Not Found (1007),短信上为 Phone Number Not Found (1007) | 该订阅者在项目中没有此平台的推送令牌、电话号码或聊天 ID,因此 Pushwoosh 没有发送该消息。 | 收集联系方式并在项目中 注册。 |
| Platform Is Disabled (10005) | 该平台在项目中已关闭。 | 在 Settings > Configure Platforms 中打开该平台。如果您不想在此平台上发送,请将其从消息中移除。 |
| Skip Push (1011) | 某个占位符对该订阅者没有值,也没有默认值。在短信上,以及对于根据商品 feed 生成的文本,当填入占位符后文本为空时也会出现此错误。 | 检查消息或预设中的占位符及其默认值。 |
| Unable To Compile Liquid Template (1014) | 消息包含 Liquid 语法错误。 | 修复消息或预设中的 Liquid 模板。 |
| Silent Hours (1041) | 收件人处于渠道的静默时段内,且该渠道的 Message behavior 为 Do not send。这不属于送达失败。 | 无需修复。要触达这些收件人,请在不设静默时段的情况下发送消息,或为该渠道选择 Send after the silence period ends。 |
| Internal Service Error (10006) | 发送在 Pushwoosh 将其交给投递平台之前或交接过程中失败。在某些平台上,它也涵盖设置错误,请参阅 发送错误 下该平台的页面。 | 如果反复出现,请联系 Pushwoosh 支持。 |
错误类别
Anchor link to下面每个类别都说明了出了什么问题以及应如何处理。
| 类别 | 含义 | 怎么办 |
|---|---|---|
| 令牌无效或已过期 | 该令牌或电子邮件地址已无法再接收消息,例如应用已被删除或地址无效。 | 在大型受众中很常见。与之前类似规模的发送进行比较。仅在份额大幅跃升时才深入研究。 |
| 没有推送令牌 | 该订阅者在此平台上没有推送令牌、电子邮件地址、电话号码或聊天 ID。 | 对于推送,请您的开发团队检查应用是否注册了设备。对于其他渠道,请收集并注册联系方式。 |
| 未找到设备 | 该设备不在您的 Pushwoosh 受众中。 | 通常在分段筛选或受众清理后出现。检查目标受众是谁。 |
| 平台已禁用 | 此平台在项目中已关闭,或投递平台的 API 已禁用,例如 Firebase Cloud Messaging。 | 在应用配置中打开该平台,或将其从发送中移除。 |
| 超出服务商配额 | Apple、Google 或其他投递平台限制了发送,或您的电子邮件发送配额已用完。 | 减慢或拆分发送。如果问题持续发生,请咨询支持团队。 |
| 消息内容无效 | 消息内容被拒绝(为空或无效)。 | 打开预设或消息文本,修复空内容或损坏的内容。 |
| 平台配置无效 | 此平台的应用凭据错误或已过时(证书、密钥等)。 | 在 Control Panel 中检查平台设置,或请支持团队/您的开发人员更新凭据。 |
| 服务商错误 | 投递平台报告了问题,或代码无法识别。 | 少数情况通常没问题。如果出现大量情况:请联系 Pushwoosh 支持 并提供消息日期和 消息代码。 |
| 处理错误 | 在发送过程中,Pushwoosh 自身的处理出现故障。 | 联系 Pushwoosh 支持。 |
| 未分类错误 | 该错误不属于任何已知组。 | 应该很少见。如果您看到很多,请联系支持团队并提供消息日期和 消息代码。 |
对于 SMS、Viber、WhatsApp、Telegram、Facebook Messenger、Kakao 和 LINE,服务商返回的每个错误都归入 服务商错误,无论其原因为何,包括发送限制、无效凭据和模板问题。超出服务商配额 和 平台配置无效 仅适用于推送和电子邮件。要了解此类错误的含义,请在 短信和即时通讯错误 中查找其名称和代码。
处理错误
Anchor link to处理错误 是 Pushwoosh 自身处理过程中的故障:构建消息、交接消息或读取投递平台的回复。您会在两个地方看到它们:
- Errors 选项卡将它们与其他错误一起列出。
- 在 Overview 选项卡上,漏斗将它们显示为单独的一行,而不是在被拒发送下。
导出错误
Anchor link to您可以导出选项卡上的单个错误或全部错误:
- 要导出某个错误的收件人,请点击该错误旁边的 下载图标。
- 要将所有错误导出到一个文件中,请点击 导出错误。
导出错误需要同时满足以下两项:
- 您的角色拥有 Personal data 权限。
- 您的账户可以访问消息日志。
如果下载图标和 导出错误 都没有显示,请让您的账户管理员或支持团队检查这两项。没有代码的行没有下载图标。请使用 导出错误 将它们包含在内。