Skip to main content
使用正文、可选的页眉和页脚以及按钮构建模板。针对不同接收者变化的内容添加变量。身份验证和专用格式具有额外的约束。

​
标准模板结构

这些限制并不保证每个专用模板都能接受所有组合。身份验证使用预设文本；轮播卡片、限时优惠、电商模板和通话组件有各自的结构。 实用的标准布局如下：
该示例仅用于说明结构；未经 Meta 预先批准。
带有标记的页眉、正文、页脚、URL、电话和快速回复按钮的 Meta 模板结构。

Meta labels the standard components. This promotional example illustrates structure, not a utility-category decision.

来源：Meta 官方示例。

​
选择正确的按钮操作

标签为 Stop promotions 的快速回复按钮并非自动退订实现。您的业务流程必须识别该回复并更新客户偏好设置。请参阅 客户选择退出。

​
按钮顺序会影响可用性和兼容性

将最重要的操作排在前面。当按钮超过三个时，WhatsApp 会显示前两个按钮，其余按钮通过 See all options 控件展示。
包含两个可见操作按钮和“查看所有选项”的 WhatsApp 模板，旁边展开的列表包含 URL、电话和快速回复操作。

Meta's example of a template with additional actions behind See all options. Client appearance may vary.

来源：Meta 模板组件。 将快速回复和其他按钮类型分开放置在不同的分组中：
  • 有效分组：URL → 电话 → 快速回复 → 快速回复。
  • 无效分组：快速回复 → URL → 快速回复。
Meta 目前在文档中说明了桌面端对包含 4 个或更多按钮、或者将快速回复与其他按钮类型混用的模板的限制：接收者会被提示在手机上查看这些消息。如果桌面端使用对您的受众很重要，请测试此项。

​
变量：设计、审核和发送是不同的阶段

对于此正文：
使用您的团队和集成可以维护的映射关系： 审核示例用于说明变量的含义。它们不会配置数据源，也不会自动填充未来的消息。 页眉、正文和每个动态按钮具有独立的参数位置。正文 {{1}} 与 URL 按钮 {{1}} 无需包含相同的值。按钮 index 标识该按钮在模板中的位置，从 0 开始；它不是正文变量编号。

​
示例：正文值与动态 URL

假设已审核的模板包含：
  • 正文：Your booking {{1}} is confirmed for {{2}}.
  • 索引为 0 的按钮：https://example.com/bookings/{{1}}
YCloud 消息的 template 对象可以按如下方式映射它们：
这是一个 template 对象片段，并非完整的发送请求。它假设指定的模板和确切的语言变体已在发送方的 WABA 中获得批准。按钮参数提供的是后缀，而非完整 URL。 在审核通过的模板中保持目标域名的稳定。对 URL 值进行正确编码，并避免在链接中放置私密信息或长期访问凭据。切勿使用变量来掩盖消息的真实类别。

​
媒体页眉：示例资源不是实际附件

对于图片、视频或文档页眉：
  1. 在创建模板时选择所需的页眉格式。
  2. 提供具有代表性的示例以供审核。
  3. 在发送时，使用受支持的 YCloud 媒体 ID 或链接字段提供实际媒体。
  4. 确认文件可正常检索，其格式与模板匹配，并且符合媒体限制要求。
  5. 测试已送达的消息，包括文件在手机上的可读性。
切勿向视频页眉模板发送图片参数。仅在登录后才可访问的私有 URL 对于消息发送服务而言不是可靠的媒体链接。 GIF 页眉出现在当前的接口协议中，但 Meta 将该功能限制在适用的 Marketing Messages API for WhatsApp 路径中。不要仅仅因为字段存在，就认为它在每个常规模板工作流中都可用。

​
选择专用格式

​
诊断组件错误

YCloud 模板 API 指南与 OpenAPI 规范定义了 YCloud 字段。Meta 的组件支持并不代表每个 YCloud 编辑器、收件箱、群发活动或 API 路由都会开放相同的功能。 继续阅读 创建模板 和 模板审核与生命周期。