短信和即时通讯错误
本页列出了短信或即时通讯发送可能在 消息统计 的 错误 选项卡中显示的错误，以及每种错误的处理方法。所有平台都可能显示的错误（例如 Phone Number Not Found 或 Skip Push）请参阅 如何查看“错误”选项卡。
短信和即时通讯错误在“错误”选项卡中的显示方式
Anchor link to错误 选项卡按平台对发送失败的情况进行分组。每一行显示错误名称，并在括号中注明其代码，例如 Invalid To Phone Number (1001)。
查找错误
Anchor link to请同时根据名称和代码查找错误。同一个数字可能对应不同的错误，因为 Pushwoosh 会在多个环节检查消息。例如，Skip Push (1011) 和 Send Quota Exceeded (1011) 是不同的错误。
大多数错误来自您的短信提供商或即时通讯平台。无论原因如何，Pushwoosh 都会将其计入 服务商错误 类别。各类别的含义请参阅 错误类别。
“错误”选项卡不显示的内容
Anchor link to该选项卡只列出 Pushwoosh 发送消息时返回的错误。以下情况不会列出：
- 提供商或即时通讯平台接受消息后发生的失败。 例如在移动运营商处发生的失败。该发送计为已接受。
- 部分临时故障。 包括大多数网络错误。Pushwoosh 会重试这些故障。在 WhatsApp 上，网络错误不会重试，并显示为 Internal Service Error (10006)。
- 因未提供 营销同意 而被跳过的订阅者。 Pushwoosh 会在发送前将他们排除在受众之外，因此他们不属于错误。
短信错误
Anchor link to这些错误来自您的短信提供商或项目的短信设置。您看到的错误取决于提供商。例如，Twilio 会将用户退订、无效号码以及不允许向该国家/地区发送的发件人统一报告为 Bad Request (1006)，而不是下方更具体的错误。
电话号码问题
Anchor link to这些错误由收件人的电话号码引起，而不是由提供商设置引起。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Invalid To Phone Number (1001) | 电话号码无法读取或缺少国家代码。Pushwoosh 会将该号码从短信中退订。 | 以包含国家代码的国际格式存储电话号码，例如 +14155550100，然后重新注册该号码。 |
| Unsubscribed Recipient (1002) | 该用户已通过其移动运营商退订您的消息，或该号码在您提供商的屏蔽列表中。通过运营商退订后，Pushwoosh 会将该号码从短信中退订并记录此次退订。 | 不要向此号码发送营销消息。请参阅 Pushwoosh 自动记录的退订。如果该用户并未退订，请在提供商的控制台中检查屏蔽列表。 |
提供商账户和设置
Anchor link to这些错误表示您的短信提供商因账户、凭据、发件人或消息本身而拒绝了请求。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Bad Request (1006) | 提供商拒绝了请求。在 Twilio 上，这还包括用户通过移动运营商退订、号码无效或不是手机号码，以及发件人不允许向收件人所在国家/地区发送的情况。 | 在提供商的控制台中检查收件人号码以及该国家/地区对应的发件人。如果该用户已退订，请停止向其发送消息。 |
| No Permission For Region (1003) | 此项目或提供商不允许向收件人所在国家/地区发送，或者短信配置中未设置提供商凭据或发件人。 | 在 短信配置 中检查提供商凭据和发件人号码。如果设置正确，请联系 Pushwoosh 客服，确认该项目可以向哪些国家/地区发送短信。 |
| Invalid To From Combination (1012) | 您的发件人 ID 不允许向收件人所在国家/地区发送，或者短信配置中未设置发件人 ID。 | 在提供商的控制台中确认该国家/地区应使用哪个发件人。 |
| Permission Denied (1015) | 提供商不接受您的凭据。 | 将 短信配置 中的凭据与提供商控制台中的凭据进行核对。 |
| Forbidden (1007) | 提供商拒绝了请求或连接（例如由于凭据错误），或者尚未设置短信连接。 | 将 短信配置 中的凭据与提供商控制台中的凭据进行核对。 |
| Account Is Inactive (1014) | 您在短信提供商处的账户已被暂停。 | 联系提供商恢复账户。 |
| Not Found (1008) | 提供商找不到请求中的账户或发件人。 | 在提供商的控制台中检查账户和发件人设置。 |
| Invalid MMS Attachment (1016) | 提供商因格式或大小问题拒绝了附件。 | 附加一个更小且格式受提供商支持的文件。 |
| Internal Service Error (10006) | 对于短信，这也可能表示您的账户未启用短信发送。 | 联系 Pushwoosh 客服。 |
发送限制
Anchor link to此错误表示发送达到了短信数量上限，而不是消息本身有问题。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Send Quota Exceeded (1011) | 项目已达到每日短信上限，或提供商限制了发送。Pushwoosh 会在您为项目配置短信时设置每日短信上限。 | 就每日短信上限联系 Pushwoosh 客服。将大批量发送分散到几天内进行。 |
提供商故障
Anchor link to这些错误表示提供商未能处理消息，或返回了 Pushwoosh 无法读取的响应。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Unknown Error (1000), Converting Error (1004), Provider Unknown Error (1009), Provider Internal Error (1010) | 提供商返回了 Pushwoosh 无法识别的错误，或提供商一侧发生了故障。Converting Error 也可能表示短信配置中的提供商设置不完整。 | 将这些错误的数量与之前规模相近的发送进行比较。如果数量增加或每次发送都重复出现，请联系 Pushwoosh 客服。 |
Viber 错误
Anchor link to除了 所有平台都可能显示的错误 之外，Viber 发送还可能显示以下两种错误。Pushwoosh 通过 MStat 发送 Viber 消息，使用的是您短信配置中的 MStat 凭据。
如果订阅者在项目中根本没有 Viber 联系人，发送会失败并显示 Push Token Not Found (1007)，这是 所有平台都可能显示的错误 之一。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| No Device For Push Token (10002) | 订阅者的 Viber 联系人保存时没有电话号码。 | 为 Viber 重新注册该订阅者的号码。请参阅 注册 Viber 联系人。 |
| Internal Service Error (10006) | 缺少 MStat 凭据或账户 ID、消息内容无效，或 MStat 拒绝了消息。错误 选项卡不会显示具体是哪种情况。 | 检查 短信配置 中的 MStat 是否已设置有效凭据，并检查消息内容。如果两者都正确，请联系 Pushwoosh 客服。 |
WhatsApp 错误
Anchor link to大多数 WhatsApp 错误来自 Meta。Meta 经常先接受消息，之后再拒绝，例如当该号码未使用 WhatsApp，或 Meta 限制向该用户发送营销消息时。此类发送在漏斗中计为 网关已接收，不会收到送达确认，也不会列在 错误 选项卡中。
24 小时窗口之外的消息
Anchor link to自由格式消息（即未使用已批准模板发送的消息）只有在用户最后一次向您的企业号码发送消息后的 24 小时内才能送达。超出该窗口后，发送会失败并显示以下错误之一。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Re Engagement Message (1030) | 该用户在过去 24 小时内没有向您的企业号码发送过消息。 | 改为发送已批准的模板，而不是自由格式文本。 |
| Processing Error (1035) | 由于 24 小时窗口已关闭，Pushwoosh 跳过了一条自由格式消息。 | 改为发送已批准的模板，而不是自由格式文本。 |
收件人错误
Anchor link to这些错误由收件人或您向其发送消息的频率引起。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Recipient Invalid Phone Number (1011) | 收件人的号码与您的企业号码相同。 | 将您自己的企业号码从受众中移除。 |
| Accounts Pair Rate Limit Hit (1059) | 您在短时间内向同一用户发送了过多消息。 | 拉开向同一用户发送消息的间隔。 |
模板和内容错误
Anchor link to这些错误表示 Meta 拒绝了模板或消息内容。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Template Does Not Exist (1037) | 该模板在所选语言中不存在，或尚未获得批准。 | 在 WhatsApp Manager 中检查该模板及其语言，然后在预设中选择一个已批准的模板。 |
| Template Param Count Mismatch (1036) | 变量值的数量与模板中变量的数量不一致。 | 在预设中填写模板的所有变量。 |
| Template Parameter Format Mismatch (1040) | 某个变量值的格式不正确。 | 在 WhatsApp Manager 中对照模板检查变量值。 |
| Template Hydrated Text Too Long (1038) | 填入变量后文本过长。 | 缩短变量值或模板文本。 |
| Template Format Character Policy Violated (1039) | 模板内容违反了 WhatsApp 政策。 | 在 WhatsApp Manager 中编辑模板，然后重新提交审批。 |
| Template Is Paused (1041) | 由于质量较低，Meta 暂停了该模板。此错误与 Silent Hours (1041) 不同，请参阅如何查看 Errors 选项卡。 | 使用另一个已批准的模板，或在 WhatsApp Manager 中改进此模板。 |
| Template Is Disabled (1042) | Meta 暂停该模板的次数过多，已将其永久停用。 | 创建一个新模板，并在预设中使用它。 |
| Request Invalid Parameter (1010), Request Missing Required Parameter (1009), Parameter Value Is Not Valid (1020), Generic User Error (1053) | 消息中的某个值缺失或无效。 | 检查预设：模板、变量、按钮和附件。 |
| Unsupported Message Type (1032) | WhatsApp 不支持此类消息。 | 在预设中更改内容类型。 |
| Media Upload Error (1034) | Meta 无法加载附加的媒体文件。 | 使用位于公开 https URL 上且格式受 WhatsApp 支持的文件。 |
账户和质量错误
Anchor link to这些错误表示 Meta 限制了您的 WhatsApp Business Account 或企业号码。请按照 如何修复被屏蔽或受限的发件人 中的说明，在 WhatsApp Manager 中解决这些问题。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Temporarily Blocked For Policies Violations (1005) | Meta 因违反其政策而屏蔽了该账户。 | 在 WhatsApp Manager 中检查账户状态。 |
| Account Has Been Locked (1017) | Meta 因违反政策而锁定了该账户，或无法验证请求中的数据。 | 在 WhatsApp Manager 中检查账户状态。 |
| Account Is Restricted From Messaging In This Country (1016) | 该账户无法向此国家/地区的用户发送消息。 | 在 WhatsApp Manager 中检查账户限制。 |
| Spam Rate Limit Hit (1008) | 由于之前的许多消息被屏蔽或被举报为垃圾消息，Meta 限制了此号码可发送的消息数量。 | 检查近期消息的内容和受众，然后降低发送量。 |
| Business Eligibility Payment Issue (1028) | 账户的付款方式有问题。 | 在 WhatsApp Manager 中检查付款方式。 |
| Provided Number Needs Display Name Approval (1027) | 您企业号码的显示名称尚未获得批准。 | 等待批准，或在 WhatsApp Manager 中更新显示名称。 |
| Business Phone Number Is Deleted (1024) | 您的企业号码已被删除。 | 在 WhatsApp 配置 中连接一个有效的号码。 |
| Account In Maintenance Mode (1035) | 该账户处于维护模式。此错误与 24 小时窗口之外的消息 中的 Processing Error (1035) 不同。 | 稍后重试。 |
设置和权限错误
Anchor link to这些错误表示 Pushwoosh 与您的 WhatsApp Business Account 之间的连接无法正常工作。请按照 WhatsApp 配置 中的说明，在 Settings > Configure Platforms > WhatsApp 中重新连接您的 WhatsApp Business Account。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Access Token Expired (1003) | 连接的访问令牌已过期。 | 重新连接账户。 |
| Authentication Failed (1002), Permission Denied (1013), API Permission (1014), API Method (1015), Access Denied (1023) | Meta 不接受该连接，或缺少某项权限。 | 重新连接账户并授予所有请求的权限。 |
| Incorrect Certificate (1029) | 企业号码未正确注册。 | 在 WhatsApp Manager 中检查企业号码，然后重新连接账户。 |
| Internal Service Error (10006) | WhatsApp 设置中缺少企业号码或访问令牌，或者 Pushwoosh 无法连接 Meta 或读取其响应。 | 检查 WhatsApp 设置，必要时重新连接账户。如果错误重复出现，请联系 Pushwoosh 客服。 |
速率限制
Anchor link to这些错误表示您的发送速度超过了 Meta 对您的应用或账户允许的速度。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Rate Limit Hit (1058) | 已达到您号码的消息吞吐量上限。 | 降低发送速率，或将发送拆分为更小的批次。 |
| API Too Many Calls (1056), Rate Limit Issues (1057) | 应用或账户已达到其请求上限。 | 降低发送速率，或将发送拆分为更小的批次。 |
Meta 临时错误
Anchor link to这些错误表示 Meta 一侧发生了故障，或返回了 Pushwoosh 无法识别的响应。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| API Unknown (1018), API Service (1019), Something Went Wrong (1022), Service Unavailable (1025), Server Temporary Unavailable (1046) | Meta 一侧的临时错误。 | 稍后重新发送消息。如果错误重复出现，请联系 Pushwoosh 客服，并提供消息日期和 消息代码。 |
| Unknown Error (1000), Cannot Process Sending (1012) | Meta 返回了 Pushwoosh 无法识别的错误，或无法读取的响应。 | 如果错误重复出现，请联系 Pushwoosh 客服，并提供消息日期和 消息代码。 |
Telegram 错误
Anchor link toTelegram 发送有两种特有的错误。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Chat Unavailable (410007) | 该用户屏蔽或删除了机器人、找不到聊天，或 Telegram 账户已被停用。Pushwoosh 会将该用户从 Telegram 中退订。 | 无需修复。该用户无法接收来自机器人的消息。 |
| Invalid Authentication Info (401002) | 机器人令牌缺失或无效。当订阅者的 Telegram 聊天 ID 无效时（此时 Pushwoosh 会将该订阅者退订），或 Pushwoosh 无法连接 Telegram 来检查令牌时，也会出现此错误。 | 在 Telegram 配置 中检查机器人令牌。 |
Facebook Messenger 错误
Anchor link to这些错误来自 Meta，在 Pushwoosh 从您的 Facebook 主页发送消息时出现。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Outside Allowed Window (403004) | 该用户在过去 24 小时内没有给您的主页发送过消息，且该消息没有消息标签。Pushwoosh 不会将这些用户从受众中过滤掉，因此每次此类发送都会因该错误而失败。 | 在 24 小时窗口之外，请使用消息标签发送。请参阅 在 24 小时窗口之外使用消息标签。 |
| Recipient Unavailable (410005) | 该用户无法接收来自您主页的消息。Pushwoosh 会将该用户从 Facebook Messenger 中退订。 | 无需修复。 |
| Invalid Authentication Info (401002) | Page ID 或 Page Access Token 缺失，或 Meta 不接受该令牌。 | 在 Facebook Messenger 配置 中输入有效的 Page ID 和 Page Access Token。 |
| No Permission (403003) | 您的 Meta App 没有此次发送所需的权限。 | 在 Meta App 控制台中检查 Meta App 的 Messenger 权限。 |
| Invalid Request Parameter (400001) | 消息为空或包含无效值。 | 检查消息内容。 |
| Internal Server Error (5009999) | Meta 返回了 Pushwoosh 无法识别的错误。 | 如果错误重复出现，请联系 Pushwoosh 客服，并提供消息日期和 消息代码。 |
Kakao 错误
Anchor link to大多数 Kakao 错误来自 KakaoTalk 消息服务。Pushwoosh 会以各自的名称显示每个错误，下方按需要检查的内容进行了分组。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Missing User Code (4001200), Missing Secret Key (4001201) | 未填写 KakaoTalk 凭据。 | 在 Kakao 配置 中输入 USER CODE 和 SECRET KEY。 |
| Invalid Authentication Info (401002), Invalid Token (401005), Token Expired (401006), Missing Authorization Header (401004), No Permission (403003), Unregistered Account (4001100) | 该服务不接受访问令牌或您的账户。 | 在 Kakao 配置 中检查 USER CODE 和 SECRET KEY。如果设置正确，请联系 Pushwoosh 客服。 |
| Unauthorized IP Address (4031101) | 该服务不接受来自 Pushwoosh 发送地址的请求。 | 联系 Pushwoosh 客服。 |
| Insufficient Balance (4001102) | 您的 KakaoTalk 消息账户余额不足。 | 为您的 KakaoTalk 消息账户充值。 |
| Unit Price Not Found (5001103) | 该服务在您的账户中没有此消息的单价。 | 联系 Pushwoosh 客服。 |
| Unauthorized Sender Key (4001104), Missing Sender Key (4001301), Missing Sender Number (4001208), Invalid Sender Number Not Registered (400667), Invalid Sender Number Policy Violation (400668) | 发件人资料或发件人号码未注册或不被允许。 | 在您的 KakaoTalk 消息账户中检查发件人资料和发件人号码。 |
| Template Code Not Found (4001105), Missing Template Code (4001303) | 消息中的模板代码缺失，或与已注册的模板不匹配。 | 检查消息是否使用了已批准的 Kakao 模板。 |
| Recipient Opted Out (400090) | 该用户已退订您的 KakaoTalk 消息。 | 不要向此用户发送营销消息。 |
| Missing Recipient Number (4001202), Invalid Recipient Number Format (4001204), Recipient Number Too Long (4001203), Missing Country Code (4001210), Invalid Country Code Format (4001212) | 收件人的电话号码缺失或格式错误。 | 以包含国家代码的国际格式存储电话号码，然后重新注册该号码。 |
| Missing Message Body (4001206), Message Body Too Long (4001207), Title Too Long (4001205), Header Too Long (4001306), Invalid Request Parameter (400001)，以及其他名为 … Too Long 或 Invalid … 的错误 | 消息的某部分缺失、过长或包含无效值。 | 在 KakaoTalk 预设或消息中修复错误所指出的字段。 |
| Internal Server Error (5009999) | 该服务一侧发生了故障，或返回了 Pushwoosh 无法识别的错误。 | 如果错误重复出现，请联系 Pushwoosh 客服，并提供消息日期和 消息代码。 |
LINE 错误
Anchor link to大多数 LINE 错误与 LINE Messaging API 返回的 HTTP 状态相对应。
| 错误 | 描述 | 怎么办 |
|---|---|---|
| Unable To Get Channel ID (1011), Unable To Get Channel Secret (1012) | 未填写 Channel ID 或 Channel secret。 | 在 LINE 配置 中填写这两项。 |
| Authentication Failed (1003) | LINE 不接受该渠道的访问令牌，例如因为 channel secret 已被更改。 | 对照 LINE Developers Console 检查 Channel ID 和 Channel secret。 |
| Duplicate Post (1006) | LINE 拒绝了请求，原因可能是请求重复，或该渠道无权使用 Messaging API 的这部分功能。 | 检查您的 LINE Official Account 的套餐和权限。如果设置正确，请联系 Pushwoosh 客服。 |
| Profile Not Found (1005), Access Not Available (1007) | 收件人或所请求的资源在 LINE 上已不可用。 | 对于该收件人无需修复。 |
| Bad Request (1002) | LINE 拒绝了请求。 | 检查消息内容和 LINE 预设。 |
| Payload Too Large (1008) | 消息大小超出了 LINE 允许的范围。 | 缩小消息或其媒体文件的大小。 |
| Unsupported Media Type (1009) | LINE 不支持该附件的文件类型。 | 以 LINE 支持的格式附加文件。 |
| Too Many Requests (1010) | 该渠道已达到 LINE 的请求速率限制或其每月消息上限。 | 降低发送速率，或检查您 LINE Official Account 套餐的消息上限。 |
| Internal Server Error (1001), Unknown Error (1000) | LINE 一侧发生了故障，或返回了 Pushwoosh 无法识别的错误。 | 稍后重新发送消息。如果错误重复出现，请联系 Pushwoosh 客服。 |