> ## 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.

# 多商品模板

> 在营销模板中展示精选的目录商品集。

使用多商品模板在营销消息中展示精选的目录商品集。客户可以打开 **View items** 来浏览您提供的商品和分区。

<Frame caption="View items opens the selected product sections, rather than the full catalog.">
  <div style={{ position: "relative", width: "100%", maxWidth: "720px", margin: "0 auto" }}>
    <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-multi-product-template.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=5184284c60085f78c1cb24c1522d5cf0" alt="Meta 多商品模板及生成的商品列表，包含分区和按钮标签。" style={{ width: "100%", height: "auto", margin: 0 }} width="1334" height="698" data-path="product-assets/whatsapp-platform-2026-09-22/meta-multi-product-template.png" />
  </div>
</Frame>

来源：[Meta 官方示例](https://developers.facebook.com/documentation/business-messaging/whatsapp/catalogs/mpm-template-messages/)。

## 准备目录

将正确的目录连接到目标 WhatsApp 资产。验证商品供货情况、电商政策合规性以及每个商品的零售商 ID。

在电商管理工具中，零售商标识符标记为 **Content ID**。请使用该值——而非商品名称、图片 URL 或不相关的内部商品 ID。

现有的 YCloud 工作流程使用 API 进行创建和发送。不要假设此模板会出现在每个控制台编辑器中。

<a id="requirements" />

## 组织选品结构

当前的 YCloud 发送契约规定：

| 元素 | 限制或要求 |
| - | - |
| 分区 | 最多 10 个。 |
| 分区标题 | 最多 24 个字符；不支持 Markdown。 |
| 每个分区的商品数 | 至少 1 个。 |
| 所有分区的总商品数 | 总计不超过 30 个。 |
| 商品标识符 | 每个商品需提供 `product_retailer_id`。 |

30 个商品的限制适用于整条消息，而不是针对每个分区单独计算。

例如，旅游用品商店可以设置包含 4 件商品的 **Day trips** 以及包含 6 件商品的 **Weekend kits** 。分布在两个清晰分区中的 10 件商品，比起仅仅因为上限允许而填满商品，更容易让客户浏览。

## 一次创建，发送时提供商品

1. 创建营销模板，包含受支持的 `MPM` 按钮和必填的正文示例。
2. 等待审核通过并确认发送语言。
3. 为该营销活动构建实时的商品分区。
4. 提供按钮子类型 `mpm` 以及包含这些分区的 action。
5. 在发送给受众之前先进行受控测试。

缩略图可以通过 `thumbnail_product_retailer_id` 进行选择。选品本身使用的是 action 的 `sections` 及其 `product_items`。

使用虚构目录标识符的 **仅 action 对象** 示例：

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "thumbnail_product_retailer_id": "SKU-DAYPACK",
  "sections": [
    {
      "title": "Day trips",
      "product_items": [
        { "product_retailer_id": "SKU-DAYPACK" },
        { "product_retailer_id": "SKU-BOTTLE" }
      ]
    }
  ]
}
```

此代码片段不是完整的发送请求。请将其放置在相应的模板按钮参数中，并包含模板的其他必需值。有关完整工作流程，请参阅 [管理模板](/zh/api-reference/guides/whatsapp-platform/manage-whatsapp-templates) 和 [发送 WhatsApp 消息](/zh/api-reference/guides/whatsapp-platform/send-whatsapp-message)。

## 测试所选商品

检查每个分区是否正常显示、所有标识符是否在已连接的目录中解析成功、价格是否为最新以及目标缩略图是否正常加载。另一个目录中的可用商品不会自动提供给此发送方访问。

如果营销活动需要不同的商品组合，请在发送时验证新的选品。不要假设模板审核通过就代表未来的目录内容已通过验证。

## 处理客户回复

提交的选品是订单请求，而不是付款凭证。请重新核对库存、数量、价格、配送信息以及最终应付总额。在将订单视为已付款之前，请通过您的支付系统确认付款。

对于活跃的客户咨询，互动式商品列表服务消息使用单独的格式，并且需要相应的 [服务窗口](/zh/documentation/whatsapp-business-platform/messaging/service-messages)。有关端到端交易边界的信息，请参阅 [目录与电商](/zh/documentation/whatsapp-business-platform/more-whatsapp-features/catalogs-and-commerce)。


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