> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 收件箱中不支持的消息

> 了解收件箱可能显示为不支持的 WhatsApp 消息类型。

当收件箱显示 **Unsupported message** 时，表示 WhatsApp 未通过其 API 支持该消息类型，或者 WhatsApp 无法提供该消息内容。因此，收件箱只能显示占位符，而无法显示原始内容。

这可能会影响任何 WhatsApp 消息类型，但通常很少发生。在 Coexistence 设置中，当 WhatsApp 无法提供其内容时，从连接的 WhatsApp Business 应用发送的第一条消息有时可能会显示为不支持。占位符无法确认根本原因。

询问客户发送了什么内容，或要求他们以文本、图片、视频、音频消息或文档的形式重新发送。

## 识别消息类型

如果收件箱在 **Message type** 之后显示了值，请使用下表识别客户发送的内容。

<img src="https://mintcdn.com/lchnan/Xn5KoIiHFj8bz3fc/product-assets/inbox-unsupported-message-edit.jpg?fit=max&auto=format&n=Xn5KoIiHFj8bz3fc&q=85&s=af1db0757927a796c0098c9aa72c2245" alt="消息类型为 edit 的不支持的收件箱消息" width="604" height="182" data-path="product-assets/inbox-unsupported-message-edit.jpg" />

| 消息类型 | 客户发送的内容 |
| - | - |
| `poll_creation`, `poll_update` | 投票或投票更新 |
| `edit` | 已编辑的消息 |
| `pin` | 置顶消息 |
| `group_invite` | 群组邀请 |
| `gif` | GIF 动图 |
| `keep_in_chat` | “保留在聊天中”操作 |
| `link_preview` | 链接预览 |
| `product`, `order` | 商品或订单消息 |
| `reaction` | Emoji 表情回应 |
| `button`, `list`, `interactive` | 按钮、列表或其他互动消息 |
| `image`, `location`, `media_placeholder` | WhatsApp 无法提供的图片、位置或媒体消息 |
| `hsm` | 旧版消息模板 |
| `errors` | WhatsApp 无法处理的消息 |

## 如果类型未知

<img src="https://mintcdn.com/lchnan/Xn5KoIiHFj8bz3fc/product-assets/inbox-unsupported-message-unknown.png?fit=max&auto=format&n=Xn5KoIiHFj8bz3fc&q=85&s=d1ff9e3b36f00ce4d90f5e7ae2622d0c" alt="消息类型未知的收件箱不支持消息" width="988" height="229" data-path="product-assets/inbox-unsupported-message-unknown.png" />

如果收件箱显示 **Message type: unknown**，说明 WhatsApp 没有提供可识别的消息类型。收件箱无法仅从占位符确定原始内容。

## 后续影响

| 区域 | 影响 |
| - | - |
| 收件箱 | 收件箱会显示占位符，并在可用时显示消息类型。它无法显示原始内容。 |
| Webhook/API | 入站 Webhook 使用 `type: unsupported`。`errors` 字段会说明消息不支持或不可用的原因，当 WhatsApp 提供时，`unsupported.type` 会标识消息类别。 |
| AI 代理和自动化 | 事件仍然可以送达您配置的 AI 代理或自动化。在没有原始内容的情况下，它可能没有足够的信息来按预期回复。 |

有关有效载荷示例和错误详情，请参阅 [WhatsApp Inbound Message Webhook Examples](/zh/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples#inbound-unsupported-message)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.