> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # 故障排除与常见问题 ## 消息已接受但未送达 出站消息端点返回 `200` 表示 ElevenLabs 已接受并转发请求，是否送达仍由 Meta 决定。若消息始终未送达，请依次检查： 1. **模板审批**：模板必须在 [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates) 中处于“已批准”状态。待审核或被拒绝的模板不会送达。 2. **付款**：WhatsApp 商业账户未设置付款方式或存在未结款项，会阻止模板送达（Meta 错误 131042）。请在 WhatsApp Manager 中添加或更新付款方式。 3. **参数格式**：`template_params` 条目必须是组件对象（`{"type": "body", "parameters": [...]}`），必须填充模板中的每个占位符，命名模板中的每个值还需包含 `parameter_name`。请参阅[模板参数](/docs/zh/eleven-agents/whatsapp/outbound#template-parameters)。 4. **收件人格式**：`whatsapp_user_id` 只能包含国家代码和数字，不含 `+`。请参阅[收件人号码格式](/docs/zh/eleven-agents/whatsapp/outbound#recipient-number-format)。 5. **营销限制**：Meta 限制单个用户在一段时间内可接收的[营销模板](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits)数量（错误 131049）。实用型模板不受此限制。 ## 导入问题 * **无法导入号码**：该号码已注册到其他 WhatsApp 服务提供商，或正在 WhatsApp Business app 中使用。一个号码只能注册到一个服务提供商；请参阅[限制](/docs/zh/eleven-agents/whatsapp#limitations)。 * **导入流程中未显示 WABA**：确认你登录的 Facebook 账户对拥有该 WABA 的业务资产组合具有管理员权限，然后重试导入。 * **在 Meta 开发者 app 下创建的 WABA** 无法通过标准流程导入。 ### 检查是否由其他合作伙伴管理号码 显示不符合条件、未出现在导入流程中或导入时报错的号码，通常 仍注册在之前的服务提供商处。某个合作伙伴控制该号码，既可能导致 导入失败，也可能导致 WABA 缺失。 1. 前往 [business.facebook.com](https://business.facebook.com)，然后选择业务资产组合。 2. 打开 **业务设置** > **WhatsApp 账户**。 3. 查看每个 WhatsApp 账户中的 **电话号码**，直到找到包含该号码的账户。 4. 打开 **合作伙伴**。 5. 断开该号码与此合作伙伴的关联（或移除整个业务资产组合），几分钟后重试导入。 ## 智能体未回复入站消息 已读回执和正在输入指示器可帮助缩小问题范围：消息一被接受处理，就会发送这些状态，此时智能体尚未生成回复。启用 **启用正在输入指示器**（默认设置）后，发送一条测试消息，查看消息是否被标记为已读，以及是否出现正在输入指示器。 **出现正在输入指示器，但未收到回复。** 消息已到达 ElevenLabs，智能体也已开始处理；故障发生在生成或发送回复时： * 智能体需要一个没有值的[动态变量](/docs/zh/eleven-agents/customization/personalization/dynamic-variables)。入站 WhatsApp 对话开始时不含用户提供的动态变量，只有系统变量会被填充。解决方法是使用返回智能体所需全部变量的[对话初始化 webhook](/docs/zh/eleven-agents/customization/personalization#conversation-initiation-webhooks)；请参阅[初始化上下文](/docs/zh/eleven-agents/whatsapp#initialization-context)。智能体编辑器中 **动态变量** 下输入的值仅为测试占位符，不会在生产环境中使用。 * Meta 拒绝了智能体的回复，例如此业务—用户组合触发速率限制，或存在账户级付款问题。请参阅下方[错误参考](#meta-error-reference)。 如果缺少这些必需的动态变量，对话将失败。 **未出现正在输入指示器。** 消息在到达智能体前被丢弃： * 没有智能体分配给该号码，或 **启用消息** 开关已关闭：请在 [WhatsApp 页面](https://elevenlabs.io/app/agents/whatsapp)检查账户设置。 * 账户授权不再有效：访问令牌已过期，或已在 Meta 端被撤销。请在 [WhatsApp 页面](https://elevenlabs.io/app/agents/whatsapp)重新导入账户。 * 智能体工作区处于 [Zero-Retention Mode](/docs/zh/eleven-api/resources/zero-retention-mode)，会完全忽略入站 WhatsApp 消息。 * 入站消息属于不支持的类型，例如视频或 WhatsApp Flow 回复：请参阅[限制](/docs/zh/eleven-agents/whatsapp#limitations)。 > **Note** > > 如果账户已关闭 **启用正在输入指示器**，则此检查不适用——请 > 检查两份列表。 ## 模板后的首条回复异常 如果智能体的 **Security** 标签页启用了 **First message** 覆盖设置，可能会与出站模板对话冲突，因为模板已作为首条消息发送。若对模板的回复行为异常，请为使用 WhatsApp 出站消息的智能体移除首条消息覆盖设置。 ## Meta 错误参考 对于 Meta 在送达期间返回的错误，我们会尽可能提供修复建议。最常见的错误如下： | 代码 | 含义 | 处理方法 | | ------ | ----------------- | ------------------------------------------------------------------------------------ | | 131042 | WhatsApp 商业账户付款问题 | 在 WhatsApp Manager 中添加或修复付款方式 | | 131056 | 此业务—用户组合的速率限制 | 降低向该用户发送消息的频率 | | 131047 | 需要重新互动 | 客户服务窗口已关闭——使用模板重新互动 | | 130497 | 业务被限制向某个国家的用户发送消息 | Meta 限制了账户的跨国消息发送——请联系 Meta 支持解决 | | 132000 | 参数数量与模板不匹配 | 严格发送模板定义的参数——请参阅[模板参数](/docs/zh/eleven-agents/whatsapp/outbound#template-parameters) | | 132001 | 模板不存在 | 检查模板名称、语言代码以及模板是否已获批准 | | 131037 | 电话号码显示名称问题 | 在 WhatsApp Manager 中完成显示名称审批 | | 190 | 访问令牌已过期 | 在 [WhatsApp 页面](https://elevenlabs.io/app/agents/whatsapp)重新导入账户 | 完整列表请参阅 [Meta 错误代码参考](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)。 ## 常见问题 #### WhatsApp 使用如何计费？ 两方会分别向你收费。 **ElevenLabs** 会通过套餐积分，按标准 [ElevenLabs 计费](/docs/zh/overview/administration/billing)对智能体使用量收费，包括对话时长、消息、语音留言的语音转文字和 文本转语音，以及 LLM 使用量。 **Meta** 会单独收取 WhatsApp 费用，例如模板消息、出站呼叫和 呼叫权限请求，通过 WhatsApp Manager 中的付款方式计费。费率因 消息类别和国家而异，Meta 已宣布价格更新将于 2026 年 10 月 1 日生效。请参阅 [Meta 的 WhatsApp 定价](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing)，了解适用于 所在市场的费率。 #### 我可以同时使用 ElevenLabs 和其他 WhatsApp 服务提供商吗？ 目前，一个号码只能注册到一个消息服务提供商。如果第三方 服务提供商（例如 Gupshup）管理你的账户，该账户也无法导入 ElevenLabs。我们正与 Meta 合作启用[多解决方案 对话](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations)， 让一个号码可使用多个服务提供商。 **通过 SIP 使用语音。** 如果你希望继续使用当前服务提供商处理消息，并使用 ElevenLabs 智能体处理语音，目前已有可行方案：WhatsApp Business Calling 支持 SIP，因此如果服务提供商提供 SIP 配置，就能将该号码的 WhatsApp 呼叫路由到 ElevenLabs [SIP trunk](/docs/zh/eleven-agents/phone-numbers/sip-trunking)。服务提供商将继续 处理该号码的消息；智能体则会通过 SIP 接听来电。这是否可行 取决于服务提供商是否支持 SIP 呼叫路由——[联系我们](https://elevenlabs.io/contact-sales)， 我们可以评估你的设置。 如果你在同一账户上运行自己的 WhatsApp app（而非使用第三方服务提供商）， 已可将 ElevenLabs 配置为仅处理呼叫：在账户设置中关闭 ***Enable messaging*** 开关。 #### 如何将对话转接给人工客服？ 即将推出。我们正与 Meta 合作实现与 WhatsApp Business 的共存，这将让 团队能够在智能体使用的同一号码上参与对话。 #### Zero-Retention Mode 能与 WhatsApp 配合使用吗？ [Zero-Retention Mode](/docs/zh/eleven-api/resources/zero-retention-mode)会限制我们提供 WhatsApp 功能的能力：入站消息会被忽略，且不允许出站呼叫。 #### 能否根据用户点击的 WhatsApp 广告进行个性化？ 暂时不能。智能体可以接收并回复通过点击跳转 WhatsApp 广告发起的对话， 但 Meta 的广告引荐元数据（如 `ctwa_clid` 以及广告系列或创意标识符） 目前不会提供给智能体、动态变量或 webhook，因此暂不原生支持基于广告的个性化 和归因。这已作为功能请求跟踪；如果广告归因对你的使用场景很重要， 请[联系我们](https://elevenlabs.io/contact-sales)。 #### 如何发送验证码（OTP）？ 使用实用型模板，将验证码作为正文参数，并通过[出站消息 端点](/docs/zh/eleven-agents/whatsapp/outbound)发送。Meta 的身份验证模板类别 （带复制验证码按钮）尚未获得专门支持。 #### 谁是 WhatsApp 账户的技术提供商？ 导入 WhatsApp 商业账户后，根据 Meta 的合作伙伴模式，ElevenLabs 会作为该 账户的 **技术提供商**。ElevenLabs 是 Meta 技术合作伙伴，而非经销商：Meta 会通过 WhatsApp Manager 中的付款方式直接向你收取 WhatsApp 费用。 #### 支持欧盟数据驻留吗？ 企业版套餐可通过隔离的欧盟环境使用 ElevenAgents 的欧盟数据驻留功能， 其中包括 WhatsApp 对话数据。这涵盖由 ElevenLabs 基础设施处理的数据； WhatsApp 本身的消息传输则受你与 Meta 的协议约束。