故障排除与常见问题
使用本页面可以快速诊断并解决 WhatsApp、Instagram 和 Facebook 消息渠道上的问题。您可以在这里找到完整的错误代码列表、其含义和建议的处理方式，以及常见问题解答部分，帮助您应对常见问题并优化您的消息设置。
常见问题
我可以将哪些沟通渠道连接到 MonoChat？
MonoChat 支持多种沟通渠道，包括 WhatsApp、Instagram、Facebook Messenger、Telegram、在线聊天和 SIP 渠道。这样您就可以在一个统一的收件箱中管理所有对话。
我多快可以开始使用？
您几分钟内即可开始使用。只需注册、连接您偏好的渠道、邀请您的团队，并通过 MonoChat 直观的设置流程创建您的工作流程即可。无需冗长的入门引导。
创建 AI 助手需要技术知识吗？
不需要，您不需要任何技术知识。MonoChat 提供简单、友好的界面，让您只需几分钟即可创建和自定义您的 AI 助手，无需编写代码。您可以通过直观的设置轻松调整助手的个性、语气和任务。一切都经过精心设计，让您专注于助手应该做什么，而技术层面的工作由 MonoChat 为您处理。
我在 MonoChat 上的数据安全吗？
是的，MonoChat 高度重视数据安全。所有数据在传输和存储时均经过加密。我们遵循行业标准的安全实践，确保您的信息受到保护。
账单是如何运作的？
账单简单而灵活。您可以在月度或年度订阅方案之间选择，并可根据需要添加附加包。我们将根据您选择的方案和用量向您开具发票。
你们接受哪些付款方式？
您可以使用信用卡或借记卡，直接在 MonoChat 平台上轻松付款。所有付款选项都可以在您账户的账单部分找到，方便您管理和更新付款方式。
我可以更改或取消订阅吗？
可以，您可以随时直接在您的账户中升级、降级或取消订阅。变更会立即生效，或在下一个计费周期生效，具体取决于您的方案。
有免费试用吗？
有，MonoChat 提供免费试用，让您在购买付费方案之前先体验平台。试用包含 1 个渠道、1 位用户，以及最多 1,000 条消息。
如果遇到问题，或在设置或集成方面需要帮助，我可以在哪里获得帮助？
MonoChat 提供根据您的需求量身定制的各种支持套餐，并且所有用户都可以使用我们的 WhatsApp 支持渠道。无论您在设置时需要指导、在集成方面需要帮助，还是需要排查故障，我们的团队都随时准备为您提供协助。
安装应用后，我的助手不回复。这是为什么？
会回复客户的应用在安装时，其机器人流程处于 关闭 状态，因此尚未设置好的助手绝不会与您的客户对话。请完成应用的设置步骤（在 开始使用 面板或应用自己的页面中），然后在应用页面中开启助手，或在 设置 › 自动化 › 流程 中启用其流程。之后更新应用时，会保留您选择的开启/关闭状态。请参阅 MonoStore。
我无法兑换优惠券。
错误信息会告诉您原因。优惠券只能使用一次，可能会过期，并且可能仅限特定的工作区：例如仅限最近几天内创建的工作区、仅限最近几个月内充值达到最低金额的工作区，或仅限近期未使用其他优惠券的工作区。当某项条件未满足时，优惠券不会被用掉，因此在您符合条件后可以再次尝试。您还需要在工作区中拥有账单权限。请参阅优惠券。
我以前的 WhatsApp 对话在哪里？
连接渠道时，其过往消息会以 历史 会话的形式到达。它们不会显示在对话列表中，以免大量旧消息淹没新消息。如果有历史会话，列表顶部会出现一条灰色提示栏，显示 您有历史会话。点击 显示 并确认，即可将列表筛选为这些会话；点击叉号会将提示栏隐藏，直到您重新加载页面。
界面语言不对。
MonoChat 默认使用您浏览器的语言。要更改语言，请打开导航栏底部的 账号 按钮，在 默认语言 下选择一种语言并保存；在登录页面，请使用页面底部的语言选择器。该选择会按浏览器记住。有关工作区的邮件（账单、每周摘要）使用工作区的默认语言，可在 设置 › CRM › 语言 中设置。请参阅界面语言。
为什么结账时要求我支付的金额低于方案价格？
当您更改方案或购买套餐而余额不足以支付时，MonoChat 只会收取价格与您余额之间的差额。如果余额为负，则会加上您所欠的金额。如果您的余额足以支付价格，则根本不会打开结账页面。请参阅直接为方案或套餐付款。
“开始使用”面板去哪了？
开始使用 标签页会一直保留在导航栏中，并显示未完成的步骤数，直到所有步骤都完成，之后它会自行消失。隐藏此项 只会阻止它自动打开。要再次查看导航栏导览，请打开 开始使用 并点击 带我看看。请参阅“开始使用”面板。
错误代码：WhatsApp、Instagram、Facebook
下面列出了每个消息渠道最常见的错误代码，以及相应的说明和建议的处理方式。
WhatsApp (Cloud API) 错误代码
这些错误代码由 WhatsApp Business API 返回。您可以通过此列表识别影响 WhatsApp 消息的送达问题、配置问题、速率限制或与权限相关的错误。
| 错误代码 | 详情 | 可能的原因和解决方案 |
|---|---|---|
| 368 - 因违反政策被暂时封禁 | 请参阅《政策执行》文档，了解政策违规及其解决方法。因违反平台政策而被限制或停用。 | 检查负载格式和必填字段。 |
| 130497 - 企业账户被限制向该国家/地区的用户发送消息。 | WhatsApp 企业账户被限制向某些国家/地区的用户发送消息。 | 请参阅《WhatsApp Business 消息政策》，了解您的企业类别允许发送消息的国家/地区。 |
| 2388019 - 超出消息模板数量上限 | 您已超出此 WhatsApp 企业账户可拥有的消息模板数量上限。 | 一个 WhatsApp 企业账户最多可拥有 250 个消息模板。请参阅“模板限制”。 |
| 1 - API 未知错误 | 请求无效或可能是服务器错误。 | 查看 WhatsApp Business Platform 状态页面，了解 API 状态信息。如果没有服务器故障，请检查接口参考文档，确认您的请求格式正确并满足接口的所有要求。 |
| 2 - API 服务错误 | 由于停机或过载造成的临时问题。 | 重试之前，请先查看 WhatsApp Business Platform 状态页面，了解 API 状态信息。 |
| 33 - 参数值无效 | 该企业电话号码已被删除。 | 请确认企业电话号码正确无误。 |
| 100 - 参数无效 | 请求中包含一个或多个不受支持或拼写错误的参数。 | 请查看接口参考文档，确定支持哪些参数及其拼写方式。 |
| 130472 - 用户号码属于某项实验 | 因参与实验，消息未发送。 | 请参阅“营销消息实验”。 |
| 131000 - 出现问题 | 因未知错误，消息发送失败。 | 请重试。如果错误仍然存在，请提交直接支持工单。 |
| 131005 - 访问被拒绝 | 权限未被授予或已被撤销。 | 使用访问令牌调试器，确认您的应用已获得该接口所需的权限。请参阅“身份验证和授权错误”。 |
| 131008 - 缺少必填参数 | 请求缺少必填参数。 | 请查看接口参考文档，确定哪些参数是必填的。 |
| 131009 - 参数值无效 | 一个或多个参数值无效。 | 请查看接口参考文档，确定每个参数支持哪些值；并请参阅“电话号码”，了解如何将电话号码添加到 WhatsApp 企业账户。 |
| 131016 - 服务不可用 | 某项服务暂时不可用。 | 重试之前，请先查看 WhatsApp Business Platform 状态页面，了解 API 状态信息。 |
| 131021 - 收件人不能是发送者 | 发送者和收件人的电话号码相同。 | 请向与发送者不同的电话号码发送消息。 |
| 131026 - 消息无法送达 | 无法送达消息。原因可能包括：收件人的电话号码不是 WhatsApp 电话号码。收件人尚未接受我们新的服务条款和隐私政策。收件人使用的 WhatsApp 版本过旧；必须使用以下或更高的 WhatsApp 版本：Android: 2.21.15.15 SMBA: 2.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6 | 请通过非 WhatsApp 的沟通方式，请 WhatsApp 用户：确认他们确实可以向您的 WhatsApp 企业电话号码发送消息。确认他们已接受我们最新的服务条款（如果尚未接受，“设置 > 帮助”或“设置 > 应用信息”会提示他们接受最新的条款/政策）。更新到最新版本的 WhatsApp 客户端。 |
| 131037 - WhatsApp 提供的号码需要先通过显示名称审核，才能发送消息。 | 用于发送该请求的 555 企业电话号码没有已获批准的显示名称。 | 更改该 555 企业电话号码的显示名称。另请参阅我们的帮助中心文章《如何更改您的 WhatsApp Business 显示名称》。 |
| 131042 - 企业资格付款问题 | 您的付款方式出现错误。 | 请参阅“关于 WhatsApp 企业账户的账单”，确认您已正确设置账单。常见问题：付款账户未关联到 WhatsApp 企业账户 / 信用额度超出上限 / 信用额度（付款账户）未设置或未生效 / WhatsApp 企业账户已被删除 / WhatsApp 企业账户已被暂停 / 未设置时区 / 未设置货币 / MessagingFor 请求（代表他人）待处理或已被拒绝 |
| 131045 - 证书不正确 | 因电话号码注册错误，消息发送失败。 | 重试之前，请先注册该电话号码。 |
| 131047 - 重新互动消息 | 自收件人上次回复发送者号码以来，已超过 24 小时。 | 请改为向收件人发送模板消息。 |
| 131049 - Meta 选择不予送达。 | 为维持健康的生态系统互动，此消息未被送达。 | 如果您收到此错误代码，并怀疑是由于该限制所致，请至少等待 24 小时再重新发送模板消息。否则只会再次收到错误响应，因为该限制可能在不同的时间段内持续生效。 |
| 131050 - 用户已停止接收营销消息。 | 无法送达消息。该收件人已选择不再接收您的企业通过 WhatsApp 发送的营销消息。 | 请勿再向该用户重试发送消息，因为对方不会收到。如需在 WhatsApp 用户停止或恢复接收您企业的营销模板消息时收到通知，请订阅 user_preferences webhook。 |
| 131051 - 不支持的消息类型 | 不支持的消息类型。 | 请参阅“消息”了解支持的消息类型，然后使用受支持的消息类型重试。 |
| 131052 - 媒体下载错误 | 无法下载用户发送的媒体。 | 我们无法下载 WhatsApp 用户消息中包含的媒体。有关更多信息，请参阅收到此消息时触发的任何 messages webhook 中的 error.error_data.details 值。请通过非 WhatsApp 的方式，请 WhatsApp 用户将媒体文件发送给您。 |
| 131057 - 账户处于维护模式 | 企业账户处于维护模式 | WhatsApp 企业账户处于维护模式。原因之一可能是该账户正在进行吞吐量升级。 |
| 132000 - 模板参数数量不匹配 | 请求中包含的变量参数值数量与模板中定义的变量参数数量不一致。 | 请参阅我们的“模板”文档，了解参数，并确保请求中包含模板所需的所有参数的值。 |
| 132001 - 模板不存在 | 指定语言下不存在该模板，或该模板尚未获批。 | 请确保您的模板已获批，并且模板名称和语言区域设置正确。请参阅我们的“模板”文档，了解有关模板的更多信息。 |
| 132005 - 模板填充后的文本过长 | 翻译后的文本过长。 | 请在 WhatsApp Manager 中检查您的模板是否已完成翻译。请参阅我们的“模板质量”文档，了解如何查看模板的状态。 |
| 132007 - 违反模板格式字符政策 | 模板内容违反了 WhatsApp 的政策。 | 请参阅我们的“模板审核”文档，了解可能的违规原因。 |
| 132012 - 模板参数格式不匹配 | 变量参数值的格式不正确。 | 请求中包含的变量参数值没有使用模板中指定的格式。请参阅我们的“模板”文档，了解有关模板参数和格式的更多信息。 |
| 132015 - 模板已暂停 | 模板因质量较低而被暂停，因此无法在模板消息中发送。 | 编辑模板以提高其质量，待其获批后再重试。 |
| 132016 - 模板已停用 | 模板因质量较低已被暂停过多次，现已被永久停用。 | 请使用不同的内容创建新的模板。 |
| 132068 - Flow 已被阻止 | Flow 处于被阻止状态。 | 请修正该 Flow |
| 132069 - Flow 已被限流 | Flow 处于限流状态，且过去一小时内已使用此 Flow 发送了 10 条消息。 | 请修正该 Flow |
| 133000 - 注销未完成 | 之前的注销尝试失败。 | 注册之前，请先再次注销该号码。 |
| 133004 - 服务器暂时不可用 | 服务器暂时不可用。 | 重试之前，请先查看 WhatsApp Business Platform 状态页面了解 API 状态信息，并检查响应详情值。 |
| 133005 - 两步验证 PIN 不匹配 | 两步验证 PIN 不正确。 | 请确认请求中包含的两步验证 PIN 正确无误。要重置 PIN，请先停用两步验证，然后设置新的 PIN。请参阅“两步验证”。 |
| 133006 - 需要重新验证电话号码 | 注册之前，需要先验证该电话号码。 | 请验证并注册该电话号码。 |
| 133010 - 电话号码未注册 | 电话号码未在 WhatsApp Business Platform 上注册。 | 重试之前，请先注册该电话号码。 |
| 135000 - 一般用户错误 | 因请求参数存在未知错误，消息发送失败。 | 请查看接口参考文档，确认您调用该接口时使用的语法是否正确。如果仍持续收到此错误代码，请联系客户支持。 |
Instagram Messaging API 错误代码
这些错误源自 Messenger Platform。它们有助于诊断与用户权限、主页设置、API 限制、速率限制和消息送达限制相关的问题。
| 错误代码 | 用户消息 | 建议的解决方案 |
|---|---|---|
| 2207003 | 下载媒体耗时过长。 | 下载媒体时发生超时。请重试。 |
| 2207020 | 您尝试访问的媒体已过期。请尝试重新上传。 | 生成新的容器 ID 并使用它重试。 |
| 2207001 | Instagram 服务器错误。请重试。 | Instagram 服务器错误。请重试。 |
| 2207032 | 创建媒体失败，请尝试重新创建媒体 | 创建媒体容器失败。请重试。 |
| 2207053 | 未知上传错误 | 上传过程中发生未知错误。请生成新的容器并使用它重试。这应该只影响视频上传。 |
| 2207057 | 缩略图偏移量必须大于或等于 0 且小于视频时长，即 {video-length} | 缩略图偏移量超出范围。请输入有效的偏移量（以毫秒为单位）。 |
| 2207051 | 我们会限制某些活动以保护我们的社区。如果您认为我们判断有误，请告诉我们。 | 发布操作被怀疑为垃圾信息。如有误判，请提交反馈，并减少重复操作。 |
| 2207042 | 您已达到 Content Publishing API 允许发布的帖子数量上限。 | 已达到每日发布上限。请明天再试。 |
| 2207006 | 找不到 ID 为 {media-id} 的媒体 | 可能缺少权限或令牌已过期。请生成新的容器并重试。 |
| 2207008 | 创建 ID 为 {creation-id} 的媒体构建器不存在或已过期。 | 临时错误。请重试 30–120 秒。如果仍然失败，请创建新的容器。 |
| 2207050 | 该 Instagram 账户受到限制。 | Instagram 专业账户处于未激活或受限状态。请登录 Instagram 并完成所需的操作。 |
| 2207023 | 媒体类型 {media-type} 未知。 | 媒体类型无效。请使用受支持的媒体类型。 |
| 2207028 | 您的帖子无法作为轮播发布。轮播至少需要 2 张照片/视频，且不超过 10 张照片/视频。 | 请将内容调整为 2–10 张照片/视频。 |
| 2207035 | 视频媒体不应指定商品标签位置。 | 视频不支持 X/Y 坐标。请移除坐标。 |
| 2207036 | 照片媒体需要指定商品标签位置。 | 图片标签需要 X/Y 坐标。请添加坐标。 |
| 2207037 | 我们无法添加您的所有商品标签。商品 ID 可能不正确、已被删除或缺少权限。 | 请刷新商品目录，并仅使用符合条件的商品 ID。 |
| 2207040 | 每个创建的媒体不能使用超过 {max-tag-count} 个标签。 | 最多允许 20 个标签。请减少标签数量。 |
| 2207026 | 不支持该视频格式。请查看规格了解支持的 {video} 格式。 | 不支持的格式。请使用 MP4 或 MOV。 |
| 2207052 | 无法从此 URI 获取媒体：{uri} | URI 无效或无法访问。请确保它是公开且可访问的。 |
| 2207027 | 媒体尚未准备好发布，请稍候 | 仅在容器状态为 FINISHED 时才可发布。 |
| 2207004 | 图片过大，无法下载。图片应小于 {size}。 | 最大允许 8MiB。请上传更小的图片。 |
| 2207005 | 不支持图片格式 {current-image-format}。支持的格式有：{format}。 | 图片格式不受支持或令牌已过期。请重新创建容器。 |
| 2207009 | 无法发布所提交的宽高比为 {submitted-ratio} 的图片。请提交宽高比有效的图片。 | 必须介于 4:5 和 1.91:1 之间。请使用有效的比例上传。 |
| 2207010 | 所提交图片的说明文字长度为 {submitted-caption-length} 个字符。最大长度为 {maximum-caption-length}。 | 上限：2200 个字符、30 个话题标签、20 个 @ 标签。请使用更短的说明文字。 |
Facebook Messenger 错误代码
这些代码专用于 Instagram Messaging API。请参阅此列表，了解与账户关联、用户权限、消息类型和 Instagram 平台特定规则相关的问题。
| 错误代码 | 描述 | 详情 / 可能的原因 |
|---|---|---|
| 1 – 99 | 发生未知错误 | 缺少权限，应用可能需要高级访问权限、企业验证或额外的权限 |
| 1 – 1357046 | 回复的 JSON 无效 | 系统延迟或消息批量响应格式错误 |
| 2 | 意外错误，请稍后重试 | Meta 平台故障，或客户已屏蔽您的企业 |
| 2 – 2018344 | 服务暂时不可用 | 主页管理员必须接受收件箱标签 API 的隐私服务条款 |
| 4 | 已达到速率限制 | 请求过多；请暂停发送 |
| 4 – 2018354 | 营销消息频率过高 | 未遵守两次通知之间的最短间隔 |
| 9 – 2018352 | 用户执行的操作过多 | 超出营销消息订阅选择加入的上限 |
| 10 | 无权执行此操作 | 用户资料 API 不适用于 Instant Games |
| 10 – 1404170 | 应用缺少权限 | 主页的营销消息订阅选择加入功能暂时受限 |
| 10 – 1893015 | 用户已停止通知消息 | 用户点击了“停止接收这些消息” |
| 10 – 2018336 | 对用户会话线程的影响 | 会话线程受到影响；请查看用户级菜单 API |
| 10 – 2534022 | 消息超出允许的时间窗口 | 必须在 24 小时窗口内发送消息 |
| 10 – 2534077 | IG–FB 连接问题 | IG 与主页未关联，或缺少双重验证 |
| 10 – 2018278 | 消息超出允许的时间窗口 | 请参阅更新后的 Meta 政策 |
| 10 – 2018065 | 超出允许的时间窗口；需要新闻消息权限 | 需要新闻消息审批 |
| 10 – 2018108 | 对方无法接收消息 | 用户不接受来自企业的消息 |
| 100 | 参数无效 | FBID 无效、通知令牌无效/已过期 |
| 100 – 33 | 不受支持的 GET 请求 | 缺少权限，对象不存在 |
| 100 – 2018001 | 未找到匹配的用户 | 用户标识符无效或缺失 |
| 100 – 2018008 | 获取文件失败 | URL 无效、SSL 问题、大小问题或超时 |
| 100 – 2018014 | 不能同时发送消息和状态 | 请移除其中一个冲突的字段 |
| 100 – 2018047 | 上传附件失败 | 媒体类型不匹配 |
| 100 – 2018074 | 附件无效/未授权 | 附件不属于您或无效 |
| 100 – 2018109 | 附件过大 | 请减小文件大小 |
| 100 – 2018164 | 应用 ID 不正确 | 应用 ID 无效 |
| 100 – 2018294 | 视频上传超时或已损坏 | 无法在 75 秒内获取 |
| 100 – 2018320 | 商品 ID 无效 | 商品不存在或无权限 |
| 100 – 2018328 | 不支持商品模板 | 必须使用 API 版本 8 及以上 |
| 100 – 2534013 | 主页未关联到 IG | 请将 FB 主页关联到 IG 专业账户 |
| 100 – 2534014 | 没有匹配的 IG 用户 | Instagram 范围 ID 无效 |
| 100 – 2534015 | 消息数据无效 | 此消息类型不允许该内容 |
| 100 – 2534025 | 用于私信回复的评论无效 | 该数据不允许用于私信回复 |
| 100 – 2534029 | 企业被禁止使用 IG Messaging API | 必须先解决政策违规问题 |
| 100 – 2534037 | 不是会话线程所有者 | 缺少对该对话的权限 |
| 190 | OAuth 访问令牌无效 | 令牌已过期或无效 |
| 200 | 权限错误 | 需要 pages_messaging 权限 |
| 200 – 1545041 | 对方当前不可用 | 用户暂时不可用 |
| 200 – 2018021 | 需要支付手机号匹配费用 | 需要手机号匹配访问费 |
| 200 – 2018027 | 消息发送受限 | 缺少 pages_messaging_phone_number 权限 |
| 200 – 2018028 | 消息发送受限 | 缺少 pages_messaging 权限 |
| 200 – 2534041 | IG 私信已停用 | 所有者已停用 API 访问 |
| 551 | 用户已屏蔽您的企业 | 用户不会收到消息 |
| 551 – 1545041 | 用户不可用 | 同上 |
| 613 – 1893016 | 重复的订阅选择加入请求 | 针对同一主题发出了多个订阅选择加入请求 |
| 613 – 2018338 | 警告：滥用行为 | 请降低消息发送速率 |
| 613 – 2534040 | 超出速率限制 | 请暂停 API 调用 |
| 2022 | 商务消息已停用 | 因违反政策 |
| 10303 | 账户关联令牌无效 | 令牌不正确或已过期 |
| 24001 | 用户取消了支付流程 | 支付已取消 |
| 24002 | 缺少隐私政策 URL | 请为支付提供隐私政策 URL |
| 24005 | 获取用户 ID 失败 | 用户识别问题 |
| 36103 | IG 账户不符合 API 使用条件 | 属于分阶段推出的一部分 |
| 2018144 | Instant Game 限制 | 10 天内仅可发送 5 条通知 |
| 2018154 | Messenger Extensions 错误 | 意外的 SDK 错误 |
| 2018163 | 分享参数验证错误 | 分享参数无效 |
| 2018166 | SDK 权限无效 | 缺少权限 |
| 2018171 | 仅限主要/次要接收者 | 访问受限 |
| 2018218 | 没有可用的个人资料 | 用户是通过电话号码创建的 |
| 2018234 | 可见性被拒绝 | 次要接收者隔离 |
| 2018247 | 个人资料权限不足 | 缺少用户资料权限 |
| 2018300 | 另一个应用控制着会话线程 | 移交事件处于活动状态 |
| 2018321 | 自动问答流程正在进行 | 请等待流程结束 |
| 2071010 | 不支持的 SDK 方法 | 请更新 Messenger 客户端 |
| 2071011 | Messenger Extensions 已停用 | 域名未加入允许列表，或客户端版本过旧 |
| 2071014–1025 | 消息内容字段无效 | 标题、URL、附件或模板无效 |
| 9000001 | 消息已删除 | 无法获取已删除的内容 |
| OAuthException | 身份验证问题 | 通用 OAuth 错误 |
| 2018389 | 主页未加入允许列表 | 主页必须加入允许列表 |
| 2018390 | 通话 ID 无效 | 通话 ID 不匹配 |
| 2018391 | 连接参数无效 | 不能为空 |
| 2018392 | SDP 参数无效 | 必须遵循 JSON 字典规范 |
| 2018393 | 通话参与者无效 | 主页不属于该通话 |
| 2018394 | 权限不足，无法加入通话 | 主页缺少权限 |
| 2018395 | 无法加入失败的通话 | 请等待回调 |
| 2018396 | 无法加入已结束的通话 | 通话已结束 |
| TBD | 超出通话速率限制 | 请降低通话频率 |