登录开始免费试用
Meta Tech Provider

错误 131060:Coexistence 号码收到不受支持的消息

错误 131060 以 Webhook 中的一条 messages 消息出现,其 type 为 unsupported,标题为“This message is currently unavailable.”。Meta 称其在 Coexistence 号码上属于预期情况:多发生在用户首次向企业发消息时,常在点击 Click-to-WhatsApp 广告后出现,通常几秒内即会恢复。该消息本身可以在 WhatsApp Business 应用中阅读。

easyCoexistence 会将不受支持的消息排除在自动化之外,因此你的 AI 永远不会回复无法读取的消息;设置了 Forward URL 时,仍会将 Meta 的负载转发到你的系统。

131060

Meta 对入站消息当前不可用的代码,标题为“This message is currently unavailable.”。

Seconds

Meta 称该错误通常在几秒内解决,之后 WhatsApp 会正常投递消息。

First contact

Meta 指明的主要场景:WhatsApp 用户首次向企业发消息,常见于点击 Click-to-WhatsApp 广告之后。

131051

同一 Webhook 中的另一代码:Cloud API 完全不支持该消息类型。

Skipped

easyCoexistence 的自动化不会对不受支持的消息运行;该聊天中下一条可读消息才会触发它们。

131060 的 Webhook 包含什么?

这是一个普通的 messages Webhook,其消息的 "type": "unsupported",并包含 errors 数组。错误对象的 code 为 131060,title 为“This message is currently unavailable.”,其 message 与之相同。unsupported 对象说明 Meta 无法转发的内容类型,Meta 列出的值包括 image、interactive、reaction 和 poll_creation。该负载中没有文本正文,也没有媒体 id,因此无法从负载中得知客户写了什么。发送者号码、消息 id 和时间戳照常提供。

messages webhook with error 131060 (shape from Meta's reference, values illustrative)
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "<WABA_ID>",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "<BUSINESS_NUMBER>",
          "phone_number_id": "<PHONE_NUMBER_ID>"
        },
        "contacts": [{ "profile": { "name": "Ana" }, "wa_id": "5511999998888" }],
        "messages": [{
          "from": "5511999998888",
          "id": "wamid.HBgN...",
          "timestamp": "1762876800",
          "type": "unsupported",
          "errors": [{
            "code": 131060,
            "title": "This message is currently unavailable.",
            "message": "This message is currently unavailable."
          }],
          "unsupported": { "type": "<UNSUPPORTED_TYPE>" }
        }]
      }
    }]
  }]
}

为什么会在 Coexistence 号码上出现?

Meta 的 Coexistence 指南称,合作伙伴“may receive an unsupported messages webhook with error code 131060”,并称这属于预期情况。指南列出两种场景。

第一种是 WhatsApp 用户首次向企业发消息,Meta 表示,当用户点击 Click-to-WhatsApp 广告并立即发送消息时尤其常见。第二种是使用不受支持的附属设备的 WhatsApp 用户向企业发送消息,或接收企业发来的消息。

Meta 没有解释其机制,但它所说的更为重要:该错误通常会在几秒内解决,之后 WhatsApp 会正常投递消息。

收到这种消息后,企业应该怎么做?

在应用中阅读。Meta 给平台的指示是告知企业在 WhatsApp Business 应用中查看该消息,因为即使 API 中的副本不可用,手机上的应用仍保有该消息。

实际操作:在手机上打开该聊天,阅读客户写的内容并直接回复;或者等待客户的下一条消息,该消息通常会照常通过 API 送达,不再出现该错误。在手机上回复,也会让自动化知道该聊天已有人处理。对于广告活动,新会话开始时出现少量此类消息属于正常现象,而非故障。

你的软件和 AI 应如何处理?

应将其视为已知事件,而非故障。与处理任何投递一样,以 200 响应 Webhook,以免 Meta 重新投递。记录消息 id 和发送者,以便将其与随后的会话关联。切勿把空消息交给 AI 当作文本处理:没有内容,任何回复都是猜测。并且应针对 131060 事件的频率设置警报,而非单条事件。

  • 快速返回 200,并依消息 id 去重,与处理任何 Webhook 相同。
  • 对 type 为 unsupported 的消息,跳过 AI 回复和关键词匹配。
  • 让团队知道有消息正在手机上的应用中等待处理。
  • 在控制台中将 131060 与真正的故障分开统计。

自动化会对不受支持的消息运行吗?

在 easyCoexistence 中不会。自动化读取文本、按钮和列表回复、媒体说明文字,以及“[voice message]”等占位符;type 为 unsupported 的消息没有这些内容,因此没有自动化会回复它,也不会出现运行记录。如果设置了 Forward URL,你的系统仍会收到 Meta 的原始负载,包括错误信息。在直连模式下,Meta 会直接将其发送到你的服务器。

该用户之后发来的下一条可读消息会像往常一样触发自动化。由于该聊天此前尚无任何存储记录,“First message”自动化(例如欢迎回复)会回复这条下一条消息。

131060 与 131051 有何不同?

两者都会以 type 为 unsupported 出现在同一个 messages Webhook 中,因此在日志里容易混淆。但两者对规划的意义截然相反:一个是会自行恢复的短暂中断,另一个则是 API 对该内容的永久限制。请在处理程序中读取 errors[0].code,而非 type,以区分两者。下表汇总了 Meta 参考文档对每个代码的说明。

131060131051
TitleThis message is currently unavailable.Message type unknown
MeaningThe message cannot be passed on right nowThe Cloud API does not support that type
Typical causeFirst contact on a Coexistence number, often after an ad tapContent the API never delivers
How longUsually clears within secondsPermanent for that content
What to doRead it in the WhatsApp Business appAsk the customer for text, or read it in the app

常见错误

  • 对单条 131060 事件发出警报。Meta 称这在 Coexistence 号码上属于预期情况,应改为监控频率。
  • 让 AI 回复空消息。负载中没有文本,回复内容将是虚构的。
  • 以错误状态码响应 Webhook。Meta 会重新投递失败的 Webhook,因此一条不受支持的消息会变成多次投递。
  • 误以为消息已丢失。消息仍在 WhatsApp Business 应用中,只是 API 中的副本不可用。
使用 EasyCoexistence 完成这些操作

号码仍保留在手机的应用中,原始消息可在那里阅读。每个号码每月 US$ 9 起,号码越多越便宜,最低降至 US$ 0.75,并提供前 3 天免费试用。

常见问题

我能通过 API 获取原始内容吗?

Meta 对 131060 的指引是查看 WhatsApp Business 应用。其 Webhook 参考文档没有说明之后可以通过何种方式取回内容。

131060 是否意味着号码出现故障?

不是。如果普通联系人发来的消息持续数小时都以 131060 形式到达,可以让你的 AI 运行 get_number_health 或检查连接;但首次联系时集中出现属于预期情况。

只使用 Cloud API 的号码也会出现吗?

Meta 在其指南中描述了首次联系的模式,该指南针对通过 WhatsApp Business 应用接入的号码,而 Coexistence 正属此类。该代码本身位于 Meta 通用的 Webhook 参考文档中,因此无论哪种号码,都应以相同方式处理。

这会产生费用吗?

这是一条入站消息。Meta 对企业所发送的消息按条收费,按类别和国家/地区计算,记在企业自己的 WhatsApp Business 账户上。

继续阅读

准备开始了吗?

几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间