故障排除与常见问题

消息已接受但未送达

出站消息端点返回 200 表示 ElevenLabs 已接受并转发请求，是否送达仍由 Meta 决定。若消息始终未送达，请依次检查：

1. 模板审批：模板必须在 WhatsApp Manager 中处于“已批准”状态。待审核或被拒绝的模板不会送达。
2. 付款：WhatsApp 商业账户未设置付款方式或存在未结款项，会阻止模板送达（Meta 错误 131042）。请在 WhatsApp Manager 中添加或更新付款方式。
3. 参数格式：template_params 条目必须是组件对象（{"type": "body", "parameters": [...]}），必须填充模板中的每个占位符，命名模板中的每个值还需包含 parameter_name。请参阅模板参数。
4. 收件人格式：whatsapp_user_id 只能包含国家代码和数字，不含 +。请参阅收件人号码格式。
5. 营销限制：Meta 限制单个用户在一段时间内可接收的营销模板数量（错误 131049）。实用型模板不受此限制。

导入问题

• 无法导入号码：该号码已注册到其他 WhatsApp 服务提供商，或正在 WhatsApp Business app 中使用。一个号码只能注册到一个服务提供商；请参阅限制。
• 导入流程中未显示 WABA：确认你登录的 Facebook 账户对拥有该 WABA 的业务资产组合具有管理员权限，然后重试导入。
• 在 Meta 开发者 app 下创建的 WABA 无法通过标准流程导入。

检查是否由其他合作伙伴管理号码

显示不符合条件、未出现在导入流程中或导入时报错的号码，通常 仍注册在之前的服务提供商处。某个合作伙伴控制该号码，既可能导致 导入失败，也可能导致 WABA 缺失。

1. 前往 business.facebook.com，然后选择业务资产组合。
2. 打开 业务设置 > WhatsApp 账户。
3. 查看每个 WhatsApp 账户中的 电话号码，直到找到包含该号码的账户。
4. 打开 合作伙伴。
5. 断开该号码与此合作伙伴的关联（或移除整个业务资产组合），几分钟后重试导入。

智能体未回复入站消息

已读回执和正在输入指示器可帮助缩小问题范围：消息一被接受处理，就会发送这些状态，此时智能体尚未生成回复。启用 启用正在输入指示器（默认设置）后，发送一条测试消息，查看消息是否被标记为已读，以及是否出现正在输入指示器。

出现正在输入指示器，但未收到回复。 消息已到达 ElevenLabs，智能体也已开始处理；故障发生在生成或发送回复时：

• 智能体需要一个没有值的动态变量。入站 WhatsApp 对话开始时不含用户提供的动态变量，只有系统变量会被填充。解决方法是使用返回智能体所需全部变量的对话初始化 webhook；请参阅初始化上下文。智能体编辑器中 动态变量 下输入的值仅为测试占位符，不会在生产环境中使用。
• Meta 拒绝了智能体的回复，例如此业务—用户组合触发速率限制，或存在账户级付款问题。请参阅下方错误参考。

如果缺少这些必需的动态变量，对话将失败。

未出现正在输入指示器。 消息在到达智能体前被丢弃：

• 没有智能体分配给该号码，或 启用消息 开关已关闭：请在 WhatsApp 页面检查账户设置。
• 账户授权不再有效：访问令牌已过期，或已在 Meta 端被撤销。请在 WhatsApp 页面重新导入账户。
• 智能体工作区处于 Zero-Retention Mode，会完全忽略入站 WhatsApp 消息。
• 入站消息属于不支持的类型，例如视频或 WhatsApp Flow 回复：请参阅限制。

模板后的首条回复异常

如果智能体的 Security 标签页启用了 First message 覆盖设置，可能会与出站模板对话冲突，因为模板已作为首条消息发送。若对模板的回复行为异常，请为使用 WhatsApp 出站消息的智能体移除首条消息覆盖设置。

Meta 错误参考

对于 Meta 在送达期间返回的错误，我们会尽可能提供修复建议。最常见的错误如下：

完整列表请参阅 Meta 错误代码参考。

常见问题