排查常见的 WhatsApp 营销活动错误

通过 SparkTG 发送 WhatsApp 营销活动时，你偶尔会遇到导致消息无法送达的错误。大多数错误源于 Meta (WhatsApp) 的政策、模板配置问题或账户级别的限制。本指南将逐一说明每种错误类型、其含义以及具体的解决方法。

1. 消息未送达：号码无法投递

如果某条营销活动消息失败，且日志显示特定联系人投递失败，则很可能是收件人号码存在以下问题之一：

• 该号码未在 WhatsApp 注册，或关联的 WhatsApp 账户已被停用。
• 联系人列表中的国家代码（印度为 +91 等）缺失或有误。
• 收件人使用的 WhatsApp 版本过旧，无法接收来自 Business API 的消息。
• 收件人尚未接受 WhatsApp 最新的服务条款：他们必须打开 WhatsApp 并接受更新后的条款，消息才能送达。

1. 1

   检查联系人格式

   在 SparkTG → Contacts 中，打开受影响的联系人，确认号码包含完整的国家代码，且不含空格或特殊字符。示例：919876543210（而不是 09876543210）。

2. 2

   从营销活动中移除无效号码

   发送营销活动之前，请使用 Validate Numbers 选项。SparkTG 会标记未在 WhatsApp 注册的号码，以便你在发送前将其排除。

3. 3

   请收件人更新 WhatsApp

   如果可以通过其他渠道联系到该联系人，请让对方更新 WhatsApp 应用并接受最新的服务条款，然后重试发送消息。

2. 营销消息因 Meta 质量限制被拦截

Meta 会主动监控通过 Business API 发送的营销消息的质量。如果你的模板质量评级较低（通常是因为收件人屏蔽或举报了你的消息），Meta 会暂时限制投递，并要求你在冷却期后重试。

• 检查模板内容：确保其相关、个性化，并且是收件人期望收到的。
• 审核联系人列表：移除没有明确 opt-in 接收你企业 WhatsApp 消息的人员。
• 等待冷却期结束（通常为 24–48 小时）后再重试营销活动。
• 在 Meta Business Manager → WhatsApp Manager → Message Templates 中检查模板的质量评级。

3. 联系人无法触达：Meta 实验限制

自 2023 年年中以来，Meta 一直在进行一项持续的实验：除非用户先发起过对话，否则一小部分 WhatsApp 用户不会收到企业发送的营销类模板消息。在 SparkTG 的营销活动日志中，这会表现为特定联系人的投递失败。

• 仅营销类别的模板受影响。实用类（utility）和验证类（authentication）模板不受影响。
• 如果某个联系人属于该实验，向其发送营销消息的唯一办法是先收到对方发来的消息。
• 对方给你发送消息后，你有 24 小时的窗口期可以发送任何模板消息，包括营销消息。
• 通过其他渠道（邮件、短信、电话）联系受影响的联系人，请他们给你发一条 WhatsApp 消息以开启会话。

4. 营销活动暂停：已达到消息发送上限

WhatsApp 对所有 Business API 账户实行分层的每日消息发送上限：每 24 小时 1,000 → 10,000 → 100,000 个唯一联系人。如果你的营销活动超过当前层级的上限，消息会停止发送，直至 24 小时窗口重置。

1. 1

   查看你当前的消息发送层级

   SparkTG Dashboard → WhatsApp → Channel Status。这里会显示你当前的上限以及 24 小时滚动窗口内的使用情况。

2. 2

   等待窗口重置

   24 小时窗口是滚动的，不会在固定的午夜重置。窗口释放后，如果启用了自动重试，暂停的营销活动将自动恢复。

3. 3

   随着时间推移提升消息发送层级

   Meta 会根据持续的高发送量和良好的质量评级自动提升你的层级。没有手动升级申请：保持高送达率和低屏蔽率，可以更快升级。

5. 账户被 Meta 封锁或限制

如果你的 WhatsApp Business Account (WABA) 因违反政策而被标记，Meta 可能会限制或完全禁用该账户。发生这种情况时，SparkTG 会在所有营销活动中显示账户级错误。

1. 1

   在 Meta Business Manager 中检查账户状态

   登录 business.facebook.com → Settings → WhatsApp Accounts。如果账户受限，你会看到一个横幅，说明原因并提供申诉选项。

2. 2

   向 Meta 提交申诉

   在 Meta Business Manager 中点击 Request Review。审核通常需要 24–48 小时。作出决定后你会收到邮件通知。

3. 3

   如果限制已解除但错误仍然存在，请联系 SparkTG 支持

   Meta 解除限制后，变更可能需要最多 2 小时才能同步到 SparkTG 平台。如果超过该时间错误仍然持续，请携带你的 WABA ID 提交支持工单。

6. 模板错误：格式、变量和审批问题

模板错误是 WhatsApp 营销活动失败中最常见的类别。通常由变量缺失、格式不正确，或模板被 Meta 暂停或拒绝导致。

• 变量为空或缺失：模板中的每个 {{variable}} 占位符在发送时都必须有值。只要有任何变量为空，消息就会失败。请检查你的联系人数据，确保所有必填字段均已填写。
• 媒体缺失或无效：如果模板带有图片、视频或文档头部，则每次发送都必须提供有效的媒体文件。文档头部仅支持 PDF 格式。
• 变量中含有换行或制表符：不要在任何模板变量的值中包含换行、制表符或连续超过四个空格；Meta 会拒绝该消息。
• 模板被 Meta 暂停：Meta 会自动暂停质量评级较低的模板。请前往 WhatsApp Manager → Message Templates 检查状态。如果原模板被永久停用，你可以将内容作为新模板重新提交。
• 找不到模板名称：如果你通过 SparkTG API 发送，请确认模板名称完全一致；区分大小写。新批准的模板可能需要最多 30 分钟才能通过 API 使用。

7. 因支付或账单问题导致消息失败

WhatsApp 按对话计费（而不是按消息）。如果 Meta 无法从你的支付方式扣款，外发消息将在 API 层面失败，并返回与支付相关的错误码。

1. 1

   在 Meta Business Manager 中检查支付方式

   前往 business.facebook.com → Settings → Payments。确认已登记有效的支付方式，且没有逾期账单。

2. 2

   核对你的 SparkTG 账户余额

   SparkTG Dashboard → Billing。确保你的 SparkTG 账户余额足以支付该营销活动的发送量。如果账户额度低于最低阈值，营销活动将不会发送。

3. 3

   如果最近进行过迁移，请重新核对入驻流程

   如果你最近将 WhatsApp 号码从其他服务商迁移到 SparkTG，请确保 Meta Business Manager 中的 Business Verification 和支付设置步骤已全部完成。未完成的迁移可能导致持续的支付错误。

8. 媒体文件上传错误

如果你的模板包含媒体头部而上传失败，整个营销活动的发送都会被阻止。WhatsApp 对媒体文件的格式和编解码器有严格要求。

• 图片：必须为 JPEG 或 PNG，8 位色深，RGB 或 RGBA 模式。文件大小上限：5 MB。
• 视频：必须使用 H.264 视频编解码器和 AAC 音频编解码器。只允许一条音轨。文件大小上限：16 MB。
• 文档：模板消息头部仅支持 PDF 格式。文件大小上限：100 MB。
• 如果视频符合大小限制但仍然失败，问题很可能出在编解码器上。请使用 HandBrake (H.264 + AAC) 等工具重新编码视频，然后再次上传。

9. 消息文本过长

WhatsApp 对模板的每个部分都有严格的字符限制。只要任何一个部分超出限制，消息就不会发送。

• 头部文本：最多 60 个字符。
• 正文文本：最多 1,024 个字符。
• 页脚文本：最多 60 个字符。
• 行动号召按钮 URL：最多 2,000 个字符。
• 格式符号（*、_、~）也计入字符限制。

10. 营销活动被阻止：额度不足

• 前往 SparkTG Dashboard → Billing，查看你的可用额度余额。
• 在重新发起营销活动之前，先为账户充值。
• 确认营销活动列表中的所有联系人都具有有效的国家代码：无效号码在投递失败的尝试中也会消耗额度。