跳转到主要内容

如何排查常见的 Broadcast 错误

本周更新

摘要

本文档提供了关于在 WATI 中发送广播或模板消息时遇到的常见错误消息的全面故障排除指南。它涵盖了各种错误场景、可能的原因以及解决这些问题的可操作方案。该指南还包括有关 Meta 限制、模板消息要求、消息传递限制和付款相关问题的详细信息。如果您无法找到特定错误的解决方案,本文档提供了有关如何联系 WATI 支持以获取进一步帮助的详细信息。

说明

您在 WATI 中发送消息时可能会遇到错误。以下是常见错误消息、其含义和故障排除步骤。

1. 消息未送达,并且您看到以下错误:

“消息无法送达”

这意味着 WhatsApp 无法由于收件人的电话号码问题而送达您的消息。

  • 该号码可能未与有效的 WhatsApp 帐户关联。

  • 国家代码可能缺失。

  • 收件人可能正在使用过时的 WhatsApp 版本。

  • 收件人尚未接受 WhatsApp 的最新服务条款和隐私政策。

  • 请访问 此链接 以接受最新的服务条款。

2. 消息未送达,并且您看到以下错误:

“消息无法送达,因为 Meta 为了提供更高质量的消息而限制了该消息 - 几天后重试。”

如果您正在发送营销模板,请注意 Meta 对此类消息施加了限制。请参阅 此指南 以了解有关这些限制的更多信息。

3. 用户的号码无法触达,并且您看到以下错误:

“用户的号码参与了实验”

自 2023 年 6 月 14 日起,Meta 正在运行实验,大约 1% 的 WhatsApp 用户除非他们首先发起对话,否则不会收到来自企业的营销模板消息。如果发生这种情况,您需要通过其他渠道联系客户,并要求他们给您发送消息,从而允许您在 24 小时内发送营销模板。

4. 您无法发送消息,并且看到以下错误之一:

“垃圾信息速率限制已达到”

“消息发送失败,因为此电话号码发送消息受到限制。这可能是因为之前发送了太多被阻止或标记为垃圾信息的消息。”

此错误表明从您的帐户发送的消息数量已超过 WhatsApp 设置的 消息传递限制(例如,每天 2k/10k/100k 个联系人)。一旦 24 小时窗口重置,您可以继续发送消息。您的消息传递层级将根据您的消息量和质量评级自动提高。在 广播分析渠道状态页面 中查看您的消息传递限制。消息传递限制是 WhatsApp 基于您的消息传递历史记录和质量评级自动执行的过程。

5. 您无法发送消息,并且看到以下错误:

“帐户已被锁定。”

  • 检查您的帐户是否当前被 Meta 限制或禁用。

  • 如果受到限制,您可以向 Meta 提出申诉。

  • 审核通常需要 24-48 小时

  • 如果限制已解除但错误仍然存在,请联系我们以获取进一步的帮助。

6. 您无法使用模板,并且看到以下错误之一:

“检查您的模板,它不能有错别字或空白文本”

  • 确保模板格式正确且不包含空白字段。

“缺少客户属性 - 检查联系信息”

  • 验证您的消息中是否包含所有必要的客户信息。

“缺少信息 - 请检查模板媒体或联系信息”

  • 确保在发送模板消息时正确填写所有必需的参数/变量。

  • 如果使用 动态标题,请始终为标题定义一个值。

  • 避免在模板参数和轮播内容中使用 换行符、制表符或四个或更多连续空格

  • 某些变量是针对 ShopifyWooCommerce 集成而言的,某些变量只能用于特定的自动化消息。

7. 消息发送失败,并且您看到以下错误:

“消息发送失败,因为与您的付款方式相关的有一个或多个错误”

  • 如果您最近创建了帐户或从另一个 BSP 迁移到 WATI,请确保您遵循了正确的入职步骤。

  • 您可能需要创建一个新的 WhatsApp Business 帐户 并重新完成入职流程。

8. 您无法使用模板,并且看到以下错误之一:

“模板名称不存在”

或者

“模板状态已暂停或禁用,无法发送。”

  • 新批准的模板可能需要 15-30 分钟 才能出现在 Facebook 的记录中。

  • WhatsApp 可能由于低质量评级而禁用了该模板。

  • 在您的 Facebook Business 帐户 中的 WhatsApp Manager 中检查此状态。

  • 您可以将内容作为新模板重新提交,看看 WhatsApp 是否批准它。一旦获得批准,您就可以再次使用它。

  • 如果模板已被删除,您可能需要将其重新提交为新模板。

  • 如果通过 API 发送,请检查模板名称是否有错别字。

9. 您正在查看有关消息的以下错误:

“翻译后的文本太长。”

  • 您的消息超过了 WhatsApp 的字符限制。请确保您的文本符合以下限制:

  • 确保您的消息符合以下字符限制:

    • 标题和页脚: 60 个字符

    • 正文: 1024 个字符

    • 访问网站 动态按钮:2000 个字符

  • 格式符号也计入字符限制。

10. 您正在尝试通过 API 发送消息,并且看到以下错误:

“发送模板 XYZ 所需的请求参数不足”

  • 如果通过 API 发送模板消息,请确保设置了所有参数和值。

  • 检查参数名称是否有错别字。

我们整理了一个 API 配方库,以帮助您充分利用 WATI。您可以在 此处 找到它们。

11. 您正在尝试通过 API 发送消息,并且看到以下错误:

“参数数量与预期的参数数量不匹配!”

  • 如果您更新了 WhatsApp Manager 中的参数数量,则必须提交新模板,而不是修改现有模板。

12. 您正在尝试发送媒体,并且看到以下错误:

“媒体上传错误”

  • 您上传的文件可能不符合 WhatsApp 支持的媒体指南:

    • 图像: 必须是 8 位RGBRGBA

    • 视频: 必须使用 H.264 视频编解码器AAC 音频编解码器。仅允许 一个音频流

    • 文档: 如果用作模板标题,则仅支持 PDF 格式。

如果视频符合大小限制但仍然失败,请尝试使用 在线转换器 以解决编解码器问题。

13. 您无法联系用户,并且看到以下错误:

“通用用户错误”

  • 这是 Meta 对新批准的模板的未知错误。

  • 尝试重新提交模板,看看问题是否已解决。

14. 您无法使用模板,并且看到以下错误:

“此语言中的内容已存在”

  • 检查是否有另一个已批准的模板具有相同的名称。

  • 已删除的模板在 30 天 内仍处于 待删除 状态,从而阻止在同一时间内重复使用相同的名称。

您无法发送广播消息,并且看到以下错误:

“信用额度不足”

  • 确保您有足够的广播额度。

  • 验证所有联系人是否添加了正确的国家/地区代码。

常见问题 (FAQ)

消息传递和帐户问题

1. 为什么我看到“消息无法送达”?

WhatsApp 无法由于收件人号码存在问题而送达您的消息,例如无效的号码、缺失的国家/地区代码、过时的 WhatsApp 版本或未接受的服务条款。

2. 为什么我看到“消息无法送达,因为 Meta 限制了该消息”?

Meta 有时会限制营销模板,以保持消息质量。几天后重试或查看 Meta 的消息传递限制。

3. “垃圾信息速率限制已达到”是什么意思?

您的帐户已达到 WhatsApp 的消息传递限制(例如,每天 2k/10k/100k 条消息)。一旦 24 小时窗口重置,您可以继续发送。

4. 如果我的帐户被锁定,我应该怎么办?

如果 Meta 限制或禁用了您的帐户,您可以提出申诉。审核通常需要 24-48 小时。如果问题仍然存在,请联系 WATI 支持。

模板和媒体问题

5. 为什么我无法发送模板消息?

这可能是因为模板存在错别字、空白字段、缺少参数或状态已暂停/禁用。检查模板格式,填写所有变量,并确保它在 WhatsApp Manager 中已获得批准。

6. “翻译后的文本太长”是什么意思?

您的消息超过了 WhatsApp 的字符限制。确保您的文本符合以下限制:

  • 标题/页脚:60 个字符

  • 正文:1024 个字符

  • “访问网站”按钮:2000 个字符

7. 为什么我收到“媒体上传错误”?

您的文件可能不符合 WhatsApp 的格式规则。确保:

  • 图像为 8 位 RGB 或 RGBA

  • 视频使用 H.264 和 AAC 编解码器

  • 文档(用作标题)为 PDF

付款与额度

8. “额度不足”或“支付方式错误”是什么意思?

这可能表示你的额度不足,或者在迁移账户后未完成正确的开户步骤。请检查你的额度,并确认已正确完成 WhatsApp Business 的开户流程。

这是否解答了您的问题?