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

# 轮播模板

> 在营销模板中展示多张媒体卡片，并测试支持的卡片结构。

使用媒体轮播在一条可水平滚动的营销消息中展示多个选项，例如三种旅游套餐、当季精选或服务方案。

<Frame caption="A media carousel combines a shared message with horizontally scrollable cards. Meta labels the components.">
  <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-carousel-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=891be720f10529d145b92a62eed27ac5" alt="Meta 轮播示例，展示了三张卡片共享的正文、媒体标头、卡片文本和按钮。" style={{ width: "100%", height: "auto", margin: 0 }} width="6394" height="3558" data-path="product-assets/whatsapp-platform-2026-09-22/meta-carousel-components.png" />
  </div>
</Frame>

来源：[Meta 官方示例](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/media-card-carousel-templates/)。

带有网站按钮的卡片可将客户引导至该网站；那里的购买行为必须通过您的网站或电商集成进行衡量。

## 规划完整的卡片组合

| 部分 | 准备内容 |
| - | - |
| 共享消息正文 | 说明客户为何会收到这些选项以及接下来的操作。 |
| 卡片 | 规划 2–10 张卡片，并在发送时保持已获批的数量。 |
| 媒体标头 | 每张卡片包含一张图片或一个视频，且标头格式保持一致。 |
| 卡片文本 | 简短说明；YCloud 文档规定每张卡片正文最多 160 个字符。 |
| 按钮 | 每张卡片最多支持两个按钮，且组件结构保持一致。 |

Meta 要求同一模板中的卡片必须共享相同的组件结构。如果您使用了卡片正文文本，则整套卡片都应包含。切勿将仅含图像的第一张卡片与结构不同的后续卡片组合使用。

为确保 YCloud 实现的稳定性，建议在每张卡片上都包含媒体标头、简洁正文以及至少一个操作。YCloud 规范的高层说明将某些组件称为可选，但其组件级说明要求提供正文和按钮；请使用编辑器接受的结构，并在实际使用无正文的 API 设计前进行确认。

## 示例：三种周末套餐

为 **城市**、 **海岸**和 **山地**各使用一张卡片：

* 保持相同的图片比例和视觉处理风格。
* 为每张卡片提供明确的描述和跳转目标。
* 使用相同的操作模式，例如 **查看套餐**。
* 将最具吸引力的选项放在第一位，但确保每张卡片独立易懂。
* 确保目标落地页展示该卡片所对应的套餐。

切勿仅在最后一张卡片上放置重要条款。客户可能不会完整滚动浏览整条消息。

## 在 YCloud 中创建模板

1. 打开 **模板**，选择正确的 WABA，然后创建一个 **营销** 模板。
2. 选择支持的媒体卡片轮播格式。
3. 添加共享正文以及所需的任何示例值。
4. 配置每张卡片的媒体、文本和按钮。
5. 预览每张卡片并提交模板以供审核。

<Frame caption="Choose Media card carousel when creating a marketing template.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/template-special-formats.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=49c869accb0c2c3483c533497bf25ec1" alt="带有媒体卡片轮播的营销模板选择器" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/template-special-formats.png" />
</Frame>

如需使用 API 流程，请参阅[管理模板](/zh/api-reference/guides/whatsapp-platform/manage-whatsapp-templates)。创建过程定义了结构和审核示例；后续发送时将提供实际的媒体和变量值。

## 发送时映射每张卡片

保持已获批的模板名称、语言、卡片数量、媒体类型和按钮布局不变。在 YCloud 的发送协议中，`card_index` 从 `0` 开始；第一张卡片不是 `1`。每张卡片的参数均归属于该卡片的组件。

常见的错误是将第二个产品的 URL 放在第一张卡片下。请使用明显不同的示例图片和目标地址进行测试，以便及时发现映射错误。

获批后，可使用支持的 [群发活动](/zh/documentation/campaign/create-a-whatsapp-marketing-campaign)、[收件箱](/zh/documentation/inbox/initiate-new-chat) 或 [API](/zh/api-reference/guides/whatsapp-platform/send-whatsapp-message) 流程。

## 发布前测试

在手机上验证所有卡片、变量替换、媒体加载、每个按钮以及目标页面的可用性。使用目标语言的接收者进行测试。预览并不能确定消息的送达资格。

检查[营销许可与控制](/zh/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates)，然后将消息送达情况与网站购买情况分开监控。

来源：[Meta 媒体卡片轮播模板](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/media-card-carousel-templates/)。


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