错误 131060:Coexistence 号码收到不受支持的消息
错误 131060 以 Webhook 中的一条 messages 消息出现,其 type 为 unsupported,标题为“This message is currently unavailable.”。Meta 称其在 Coexistence 号码上属于预期情况:多发生在用户首次向企业发消息时,常在点击 Click-to-WhatsApp 广告后出现,通常几秒内即会恢复。该消息本身可以在 WhatsApp Business 应用中阅读。
easyCoexistence 会将不受支持的消息排除在自动化之外,因此你的 AI 永远不会回复无法读取的消息;设置了 Forward URL 时,仍会将 Meta 的负载转发到你的系统。
Meta 对入站消息当前不可用的代码,标题为“This message is currently unavailable.”。
Meta 称该错误通常在几秒内解决,之后 WhatsApp 会正常投递消息。
Meta 指明的主要场景:WhatsApp 用户首次向企业发消息,常见于点击 Click-to-WhatsApp 广告之后。
同一 Webhook 中的另一代码:Cloud API 完全不支持该消息类型。
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 和时间戳照常提供。
{
"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 参考文档对每个代码的说明。
| 131060 | 131051 | |
|---|---|---|
| Title | This message is currently unavailable. | Message type unknown |
| Meaning | The message cannot be passed on right now | The Cloud API does not support that type |
| Typical cause | First contact on a Coexistence number, often after an ad tap | Content the API never delivers |
| How long | Usually clears within seconds | Permanent for that content |
| What to do | Read it in the WhatsApp Business app | Ask the customer for text, or read it in the app |
常见错误
- 对单条 131060 事件发出警报。Meta 称这在 Coexistence 号码上属于预期情况,应改为监控频率。
- 让 AI 回复空消息。负载中没有文本,回复内容将是虚构的。
- 以错误状态码响应 Webhook。Meta 会重新投递失败的 Webhook,因此一条不受支持的消息会变成多次投递。
- 误以为消息已丢失。消息仍在 WhatsApp Business 应用中,只是 API 中的副本不可用。
号码仍保留在手机的应用中,原始消息可在那里阅读。每个号码每月 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,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间